(SM-2202) Java Connector Troubleshooting

This document provides instructions and information on how to troubleshoot the most common problems related to Java connector setup.

Check if the Java connector is running

  1. Open transaction /DVD/JCO_MNG

  2. On the left side of the screen, select the connector that is being used. Usually, the Java connector is connected using DATAVARD_JAVA_CONN RFC.

  3. The status of the connector for the specific app.server can be seen on the right side of the screen.

  4. Click the restart button

Check Java logs

  1. Open transaction /DVD/JCO_MNG

  2. On the left side of the screen, select the connector that is being used. Usually, the Java connector is connected using DATAVARD_JAVA_CONN RFC.

  3. On the right side of the screen, click logs to display Java logs.

In the selection screen, it is possible to set several parameters like the Date of the log, Number of lines, etc. It is also possible to select a specific filter for messages. Message filters are DEBUG, TRACE, INFO, WARN, ERROR. Click the display button to display logs.

The table of Java logs is displayed. It is possible to sort logs by each column and also refresh logs using the refresh button in the top left corner of the screen.

Possible issues

If the Java connector doesn't start, these are the possible issues. Even if Java doesn't start, some information can be sometimes seen in the logs. Click on the Logs button to check logs.

ACLs on SAP gateway doesn't allow registration of Java connector

Check ACLs in the SMGW transaction. Make sure that the program ID used in the setup is allowed to register on the gateway.

RFC and Java connector have incorrect program ID

Check Program ID in Config tab in /dvd/jco_mng. Make sure that the RFC that is connecting to this Java connector uses the same program ID.

RFC user has the wrong role assigned (enabling RFC communication)

Correct user role in transaction PFCG

RFC user has the wrong user type (not 'Communication Data' user)

Correct user type in transaction SU01

RFC user does not exist or is locked

Create/unlock the user in transaction SU01

Java runtime environment is lower than 1.7

Java connector supports only releases >=1.7. Update the JRE.

Wrong settings

Double-check the setup in /dvd/jco_mng Config and Dependencies tab

Install directory doesn't exist

The latest versions of Storage Management create an installation directory on its own. In case you have an older version (<1903), make sure the directory exists

libsapjco3.so is not in $LD_LIBRARY_PATH

Make sure that libsapjco3.so is in $LD_LIBRARY_PATH of <SID>adm user. Keep in mind that $LD_LIBRARY_PATH is only updated after app.server restart.

None of the above

Try to manually start the JVM with debug mode.

Examples:

Oracle Java

export WORKDIR=/usr/sap/<SID>/<instance_DIR>/work/dvd_conn/jco204
/usr/bin/java -Xmx2G
-Djava.security.debug=gssloginconfig,configfile,configparser,logincontext
-Dsun.security.jgss.debug=true
-Dsun.security.krb5.debug=true
-Dsun.security.spnego.debug=true
-Dlog4j.configurationFile=${WORKDIR}/log4j.xml
-jar ${WORKDIR}/dvd_auth_jco.jar
-conf ${WORKDIR}/auth_conn.jcoserver
-confDest ${WORKDIR}/auth_conn_as.jcoDestination 2>&1

IBM Java

/usr/bin/java -Xmx2G
-Djava.security.debug=gssloginconfig,configfile,configparser,logincontext
-Dcom.ibm.security.jgss.debug=all
-Dcom.ibm.security.krb5.Krb5Debug=all
-Djava.security.auth.login.config=/sapmnt/D06/global/security/dvd_conn/jaas.config
-Dlog4j.configurationFile=/usr/sap/D06/DVEBMGS00/work/dvd_conn/log4j.xml
-jar /usr/sap/D06/DVEBMGS00/work/dvd_conn/dvd_java_connector.jar
-conf /usr/sap/D06/DVEBMGS00/work/dvd_conn/config.jcoServer
-confDest /usr/sap/D06/DVEBMGS00/work/dvd_conn/config_as.jcoDestination
-log /sapmnt/D06/global/security/dvd_conn/custom_java.log