{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This document provides instructions and information on how to troubleshoot the most common problems related to Java connector setup.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Check if the Java connector is running","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open transaction ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the left side of the screen, select the connector version that is being used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The status of the connector for the specific app.server can be seen on the right side of the screen.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":1235,"id":"0c14a056-d906-41e3-81f5-374ca91cfbd4","collection":"contentId-4638415324","type":"file","height":358}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Check Java logs","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open transaction ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the left side of the screen, select the connector that is being used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the right side of the screen, click logs to display Java logs.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":66.0},"content":[{"type":"media","attrs":{"width":1285,"id":"ef85b83f-2504-4e6d-9567-b21346dab81b","collection":"contentId-4638415324","type":"file","height":402}}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":58.0},"content":[{"type":"media","attrs":{"width":523,"id":"51d76267-9d92-4545-b6ff-a2b809301c82","collection":"contentId-4638415324","type":"file","height":168}}]},{"type":"paragraph","content":[{"text":"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. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":66.0},"content":[{"type":"media","attrs":{"width":575,"id":"d3072e7e-4ae0-44b1-a98e-46749d551792","collection":"contentId-4638415324","type":"file","height":202}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Possible issues","type":"text"}]},{"type":"paragraph","content":[{"text":"If the Java connector does not start, these are the possible issues. Even if Java does not start, some information can be sometimes seen in the logs. Click on the Logs button to check logs.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"a91203fe-d588-497d-9651-59a97548ef9b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"ACLs on SAP gateway do not allow registration of Java connector","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Check ACLs in the SMGW transaction. Make sure that the program ID used in the setup is allowed to register on the gateway.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"RFC and Java connector have incorrect program ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"RFC user has the wrong role assigned (enabling RFC communication)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Correct user role in transaction PFCG","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"RFC user has the wrong user type (not ","type":"text"},{"text":"System ","type":"text","marks":[{"type":"strong"}]},{"text":"user)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Correct user type in transaction SU01","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"RFC user does not exist or is locked","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Create/unlock the user in transaction SU01","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Java runtime environment is not suitable to run JCO","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Please refer to main page regarding supported Java Runtime","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Wrong settings","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Double-check the setup in /DVD/JCO_MNG Config and Dependencies tab","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Install directory doesn't exist","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"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","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Execution of external commands does not work","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Execution of external commands is facilitated by sapxpg utility (in SAP kernel). To test execution of sapxpg, run SM65 analysis tool.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"CPU architecture is not x64","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Make sure to download libsapjco3.so for relevant architecture and replace it in /lib. The same is true for Java Runtime.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"None of the above","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"To get maximum information in JCO log, set following additional parameters:","type":"text"}]},{"type":"paragraph","content":[{"text":"-Djco.trace_level=8","type":"text"},{"type":"hardBreak"},{"text":"-Djco.trace_path=","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Try to manually start the JVM:","type":"text"}]},{"type":"paragraph","content":[{"text":"Oracle Java","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"su - adm","type":"text"},{"type":"hardBreak"},{"text":"setenv INSTPATH ","type":"text"},{"type":"hardBreak"},{"text":" -Xmx2G ","type":"text"},{"type":"hardBreak"},{"text":"-Dlog4j.configurationFile=${INSTPATH}/log4j.xml ","type":"text"},{"type":"hardBreak"},{"text":"-javaagent:${INSTPATH}/dvd_java_connector.jar ","type":"text"},{"type":"hardBreak"},{"text":"-jar ${INSTPATH}/dvd_java_connector.jar ","type":"text"},{"type":"hardBreak"},{"text":"-conf ${INSTPATH}/config.jcoServer ","type":"text"},{"type":"hardBreak"},{"text":"-confDest ${INSTPATH}/config_as.jcoDestination 2>&1","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Example:","type":"text"},{"type":"hardBreak"},{"text":"setenv INSTPATH /usr/sap/EXC/D40/work/dvd_conn/jco232","type":"text"},{"type":"hardBreak"},{"text":"/usr/sap/EXC/D40/work/dvd_conn/jco232/jdk-11.0.15_10-jre/bin/java -Xmx2G ","type":"text"},{"type":"hardBreak"},{"text":"-Dlog4j.configurationFile=${INSTPATH}/log4j.xml ","type":"text"},{"type":"hardBreak"},{"text":"-javaagent:${INSTPATH}/dvd_java_connector.jar ","type":"text"},{"type":"hardBreak"},{"text":"-jar ${INSTPATH}/dvd_java_connector.jar ","type":"text"},{"type":"hardBreak"},{"text":"-conf ${INSTPATH}/config.jcoServer ","type":"text"},{"type":"hardBreak"},{"text":"-confDest ${INSTPATH}/config_as.jcoDestination 2>&1","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"IBM Java","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"/usr/bin/java -Xmx2G","type":"text"},{"type":"hardBreak"},{"text":"-Djava.security.debug=gssloginconfig,configfile,configparser,logincontext","type":"text"},{"type":"hardBreak"},{"text":"-Dcom.ibm.security.jgss.debug=all","type":"text"},{"type":"hardBreak"},{"text":"-Dcom.ibm.security.krb5.Krb5Debug=all","type":"text"},{"type":"hardBreak"},{"text":"-Dlog4j.configurationFile=/log4j.xml","type":"text"},{"type":"hardBreak"},{"text":"-jar /dvd_java_connector.jar","type":"text"},{"type":"hardBreak"},{"text":"-conf /config.jcoServer","type":"text"},{"type":"hardBreak"},{"text":"-confDest /config_as.jcoDestination","type":"text"},{"type":"hardBreak"},{"text":"-log /custom_java.log","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}