{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"Java connector is a component used for authentication and communication with remote services using JDBC drivers or Java SDKs. It runs as an independent OS process and can be configured and controlled through transaction ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, the Java connector is deployed directly on the SAP ABAP application server and can be managed from the SAP GUI.","type":"text"},{"type":"hardBreak"},{"text":"If the application server's operating system is Linux x64 or Windows x64, the setup is straightforward.","type":"text"},{"type":"hardBreak"},{"text":"If SAP runs on a different operating system or architecture, please follow additional steps in ","type":"text"},{"text":"Using custom Java Runtime","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"In this section:","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"7f440084-1af4-4ad3-ad62-599318173cfa"},"schemaVersion":{"value":"2"},"title":"Child pages (Children Display)"}},"localId":"7d8a06a7-610b-4015-bfe9-e76c188b3a12"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":959,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":959,"alt":"image-20240226-092415.png","id":"6a39a095-8dff-40a4-be09-e5aff4b131be","collection":"contentId-5110732767","type":"file","height":366}}]},{"type":"paragraph","content":[{"text":"Transaction /DVD/JCO_MNG","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"code"}]},{"text":" is the interface for the Java Connector (JCO) management.","type":"text"},{"type":"hardBreak"},{"text":"When the transaction is opened for the first time, a pop-up window asks whether the JCO is going to be deployed locally or if there is a standalone JCO installation that is only going to be monitored.","type":"text"},{"type":"hardBreak"},{"text":"The crucial configuration parameter is the SAP RFC destination which will be used as a communication channel between SAP and JCO.","type":"text"},{"type":"hardBreak"},{"text":"In the case of a standalone JCO, the interface only allows checking whether the JCO is up and connected, but the configuration and operation are done remotely (for more information, see the chapter ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://datavard.atlassian.net/wiki/spaces/DATAVARD/pages/5110733530"}},{"text":").","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Table of Contents:","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"6d5b3856-ea1a-4950-84eb-b2d6ff7dc87b"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"f08a0a72-6259-4544-8f61-257987c6bc02"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SAP RFC role and user","type":"text"}]},{"type":"paragraph","content":[{"text":"Java connector uses a dedicated user in the SAP system for registration on the SAP gateway and further communication between ABAP and Java.","type":"text"},{"type":"hardBreak"},{"text":"This user should be created with the type ","type":"text"},{"text":"System","type":"text","marks":[{"type":"code"}]},{"text":" and with authorizations limiting his privileges to basic RFC communication.","type":"text"}]},{"type":"paragraph","content":[{"text":"Predefined role ","type":"text"},{"text":"/DVD/JCORFC","type":"text","marks":[{"type":"code"}]},{"text":" is included in the software and can be used as is, or as a template for the custom role.","type":"text"}]},{"type":"paragraph","content":[{"text":"The required authorization object is ","type":"text"},{"text":"S_RFC","type":"text","marks":[{"type":"code"}]},{"text":" with these settings:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ACTVT = 16","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RFC_NAME = RFC1, RFC_METADATA, SDIFRUNTIME, SYST","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RFC_TYPE = FUGR","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Java-Connector-RFC"},"legacyAnchorId":{"value":"id-(SM-2502)JavaConnectorSetup-Java-Connector-RFC"}},"macroMetadata":{"macroId":{"value":"a44ff03436101cba9d30bc338d7675a3"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"659e09c8-2cca-4ae7-9b99-17bd2fe22633"}},{"text":"Java Connector RFC","type":"text"}]},{"type":"paragraph","content":[{"text":"Java Connector RFC is used to reference the Java service registered on the SAP gateway. Use the template below as a reference.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":693,"id":"c63f8c77-1644-42c9-a1bc-d5ae5d448d02","collection":"contentId-5110732767","type":"file","height":805}}]},{"type":"paragraph","content":[{"text":"Settings:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connection Type","type":"text","marks":[{"type":"code"}]},{"text":": T for TCP/IP Connection","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Activation Type","type":"text","marks":[{"type":"code"}]},{"text":": Select Registered Server Program","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Program ID","type":"text","marks":[{"type":"code"}]},{"text":": Name of the program how JCO will identify itself when logged on to SAP gateway (Example: SNP_CONNECTOR)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SAP Gateway Access (reginfo)","type":"text"}]},{"type":"paragraph","content":[{"text":"External communication with the SAP system goes through the SAP gateway. If the SAP system parameter ","type":"text"},{"text":"gw/acl_mode","type":"text","marks":[{"type":"code"}]},{"text":" is enabled, there are files ","type":"text"},{"text":"reginfo","type":"text","marks":[{"type":"code"}]},{"text":" that limit the access of external programs.","type":"text"},{"type":"hardBreak"},{"text":"In this case, a program needs to have granted access either by wildcard definition or by explicitly defining the program registration name (in our example it is ","type":"text"},{"text":"SNP_CONNECTOR","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]},{"type":"paragraph","content":[{"text":"More information on the SAP gateway ACL topic can be found on the SAP website ","type":"text"},{"text":"Gateway Security Files secinfo and reginfo","type":"text","marks":[{"type":"link","attrs":{"href":"https://help.sap.com/saphelp_nw73/helpdata/en/e2/16d0427a2440fc8bfc25e786b8e11c/content.htm?no_cache=true"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Initial setup ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter transaction ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"code"}]},{"text":",","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the latest JCO version by double-clicking the row on the left side of the screen,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Switch to ","type":"text"},{"text":"Edit mode","type":"text","marks":[{"type":"code"}]},{"text":",","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Fill default values","type":"text","marks":[{"type":"code"}]},{"text":",","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fill in ","type":"text"},{"text":"RFC Destination","type":"text","marks":[{"type":"code"}]},{"text":" in the ","type":"text"},{"text":"General","type":"text","marks":[{"type":"code"}]},{"text":" tab.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":376,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":376,"alt":"image-20240226-094326.png","id":"6d9ea51f-21b1-4e90-afb1-2154da2b6318","collection":"contentId-5110732767","type":"file","height":153}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fill in ","type":"text"},{"text":"Technical user Credentials","type":"text","marks":[{"type":"code"}]},{"text":" in the ","type":"text"},{"text":"Config","type":"text","marks":[{"type":"code"}]},{"text":" tab. ","type":"text"},{"type":"hardBreak"},{"text":"Optionally, customize the ","type":"text"},{"text":"Install directory","type":"text","marks":[{"type":"code"}]},{"text":". Logical path ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" translates to ","type":"text"},{"text":"/usr/sap///work/dvd_conn/.","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"If multiple application servers are used, the installation directory must contain to enable deployment to the appropriate path containing the INSTANCE directory on each app. server.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":598,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":598,"alt":"image-20240226-094511.png","id":"24a97021-8352-4e2e-9f75-55ced0abc52b","collection":"contentId-5110732767","type":"file","height":197}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go back to the ","type":"text"},{"text":"General","type":"text","marks":[{"type":"code"}]},{"text":" tab, ","type":"text"},{"text":"Save,","type":"text","marks":[{"type":"code"}]},{"text":" and click ","type":"text"},{"text":"Restart","type":"text","marks":[{"type":"code"}]},{"text":" to deploy the JCO.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":616,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":616,"alt":"image-20240226-094729.png","id":"53a74a3d-b339-449b-9763-46241492ac0f","collection":"contentId-5110732767","type":"file","height":262}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(Optional) Set Proxy settings in the ","type":"text"},{"text":"Config","type":"text","marks":[{"type":"code"}]},{"text":" tab. A JCO restart is required after configuring the proxy.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Proxy parameters description","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use Proxy: ","type":"text","marks":[{"type":"strong"}]},{"text":"Enable or disable the use of a proxy server. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable HTTPS: ","type":"text","marks":[{"type":"strong"}]},{"text":"Set the HTTPS protocol for the proxy connection. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Proxy Host: ","type":"text","marks":[{"type":"strong"}]},{"text":"The hostname or IP address of the proxy server. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Proxy Port: ","type":"text","marks":[{"type":"strong"}]},{"text":"The port number on the proxy server to connect.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Proxy User: ","type":"text","marks":[{"type":"strong"}]},{"text":"Username for authentication with the proxy server. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Proxy PW: ","type":"text","marks":[{"type":"strong"}]},{"text":"Password for authentication with the proxy server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Non-proxy Hosts: ","type":"text","marks":[{"type":"strong"}]},{"text":"A list of hosts to bypass the proxy server.","type":"text"}]}]}]}]},{"type":"orderedList","attrs":{"order":10},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(Optional) Logging configuration","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log4j log level: ","type":"text","marks":[{"type":"strong"}]},{"text":"Level of messages collected in logs, default is INFO.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log4j log retention: ","type":"text","marks":[{"type":"strong"}]},{"text":"JCO log retention period in days.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log files path: ","type":"text","marks":[{"type":"strong"}]},{"text":"Directory where the log files will be saved. (Read only)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log4j config path: ","type":"text","marks":[{"type":"strong"}]},{"text":"Path where the log4j config file will be created.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To edit the Log4j configuration, the ","type":"text"},{"text":"Edit Log4j Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" button must be clicked. This action will display the XML file, allowing adjustments to the settings as needed.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Important:","type":"text","marks":[{"type":"strong"}]},{"text":" This is an advanced feature—modifications should only be made by users who are certain of the changes they are making.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following line ","type":"text"},{"text":"must not be modified","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"This placeholder is automatically replaced by the ","type":"text"},{"text":"Log files path","type":"text","marks":[{"type":"strong"}]},{"text":" parameter from the screen.","type":"text"}]},{"type":"paragraph","content":[{"text":"If necessary, the ","type":"text"},{"text":"Undo","type":"text","marks":[{"type":"strong"}]},{"text":" button can be used to revert any changes and restore the default SNP Log4j configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"Any modifications will take effect after restarting JCO.","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelIconId":"atlassian-note","panelIcon":":note:","panelColor":"#F4F5F7","panelType":"custom"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Advanced parameters description","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OS Command for starting Java service: ","type":"text","marks":[{"type":"strong"}]},{"text":"Name of an OS command for starting Java service (SM69).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OS Command for setting access permissions: ","type":"text","marks":[{"type":"strong"}]},{"text":"Name of an OS command for setting execution rights (SM69).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OS Command for 7Zip: ","type":"text","marks":[{"type":"strong"}]},{"text":"Name of an OS command for unpacking libraries and embedded JRE (only if embedded JRE is chosen) (SM69).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Max RAM used: ","type":"text","marks":[{"type":"strong"}]},{"text":"Maximum amount of system memory used by Java service (heap size).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Additional Java starting arguments: ","type":"text","marks":[{"type":"strong"}]},{"text":"Additional arguments used to start the Java service.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repository destination: ","type":"text","marks":[{"type":"strong"}]},{"text":"Client destination from which repository should be obtained (always defaults to ABAP_AS_WITH_POOL).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Work thread MIN: ","type":"text","marks":[{"type":"strong"}]},{"text":"Number of threads Java Virtual Machine always runs with.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Work thread MAX: ","type":"text","marks":[{"type":"strong"}]},{"text":"Maximum number of threads that the Java Virtual Machine can spawn.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connection count: ","type":"text","marks":[{"type":"strong"}]},{"text":"Number of connections registered at SAP gateway. The default is 10 and the maximum number of connections per JCO instance is 100.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Peak limit: ","type":"text","marks":[{"type":"strong"}]},{"text":"Limit of JCO connections at peak.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JAR path: ","type":"text","marks":[{"type":"strong"}]},{"text":"Path where the JCO JAR file will be created.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Server config path: ","type":"text","marks":[{"type":"strong"}]},{"text":"Path where the JCO server config will be created.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Destination config path: ","type":"text","marks":[{"type":"strong"}]},{"text":"Path where the JCO destination config will be created.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Avoid JCO config file creation","type":"text","marks":[{"type":"strong"}]},{"text":": Special option that prevents automatic overwrite of existing configuration files during JCO start. Useful for cases when manual modification of configuration files is needed (troubleshooting).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use JCO dir for parquet conversion","type":"text","marks":[{"type":"strong"}]},{"text":": If required, JCO performs data conversion into PARQUET format. This is by default done in memory; when this option is active, conversion is done using temporary files in the /parquet subdirectory. This may be necessary if the memory allowance for JCO is limited.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Embedded JRE","type":"text","marks":[{"type":"strong"}]},{"text":": Path to embedded JRE (nested in Install directory in Config Tab ).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use custom JRE","type":"text","marks":[{"type":"strong"}]},{"text":": Checkbox whether or not to use custom JRE for JCo, if the checkbox is not checked, then embedded JRE is used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom JRE","type":"text","marks":[{"type":"strong"}]},{"text":": Path to custom JRE, executable by adm user. ","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The Java service is started with a system command. You can adjust the name of this command in the table Advanced tab. The default name of the command is ZDVD_START_JAVA. In the case the system command doesn't exist, it is created automatically. You can view the system commands through the transaction SM69. On Linux, another system command is required, which sets executable rights for the configuration files (chmod 755 ). Its name can be adjusted in the Advanced tab.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The following authorizations are required for the automatic start of the Java process:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"S_RFC_ADM (Administration for RFC Destination): ACTVT = 03, RFCTYPE = * , RFCDEST = , ICF_VALUE = * ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"S_DATASET (Authorization for file access): PROGRAM =/DVD/*, ACTVT = *, FILENAME = * ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"S_LOG_COM (Authorization to Execute Logical Operating System Commands): COMMAND = ZDVD*, OPSYSTEM = * , HOST = * ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Management of JCO config versions (upload/download) also requires S_GUI (Authorization for GUI activities) with ACTVT = 61,60","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Using custom Java Runtime","type":"text"}]},{"type":"paragraph","content":[{"text":"As of SNP Reuse Library version 22.08, the SNP Java connector comes with regularly updated embedded Java runtime (Adoptium 11) for ","type":"text"},{"text":"Linux 86_x64","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Windows x64","type":"text","marks":[{"type":"strong"}]},{"text":" and no manual setup is required in this regard.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the SAP system runs on different operating system (Solaris, AIX, HPUX, etc.), or it is not desired to use the embedded JRE, then custom JRE and libsapjco3 libraries need to be deployed to the application server(s) manually.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Java runtime environment (JRE)","type":"text"}]},{"type":"paragraph","content":[{"text":"Recommended JRE is ","type":"text","marks":[{"type":"strong"}]},{"text":"the latest version of ","type":"text"},{"text":"OpenJDK 11","type":"text","marks":[{"type":"strong"}]},{"text":". OpenJDK JRE can be downloaded from the ","type":"text"},{"text":"Adoptium download site","type":"text","marks":[{"type":"link","attrs":{"href":"https://adoptium.net/temurin/releases/?version=11"}}]},{"text":" for most architectures.","type":"text"}]},{"type":"paragraph","content":[{"text":"Not to interfere with possible Java installation already present on the SAP application server, the archive can be simply unpacked into any directory accessible to adm, e.g. ","type":"text"},{"text":"/sapmnt//global/JRE_11/","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The option to choose between embedded JRE and custom JRE can be found in the Advanced Tab of ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"code"}]},{"text":" transaction:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":699,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":699,"alt":"image-20240226-100245.png","id":"ddc23dc7-f804-4c31-bbd2-35dabd6cb5fc","collection":"contentId-5110732767","type":"file","height":83}}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Embedded JRE","type":"text","marks":[{"type":"strong"}]},{"text":": Path to embedded JRE Java binary. It is by default nested in the JCO Installation directory defined in the Config Tab.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use custom JRE","type":"text","marks":[{"type":"strong"}]},{"text":": Checkbox whether or not to use custom JRE. In the default configuration, the checkbox is unchecked, so embedded JRE will be extracted in the default path.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom JRE","type":"text","marks":[{"type":"strong"}]},{"text":": Path to custom JRE Java binary.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SAP Java Connector Library","type":"text"}]},{"type":"paragraph","content":[{"text":"Java Connector uses a shared library published by SAP named ","type":"text"},{"text":"libsapjco3.so","type":"text","marks":[{"type":"code"}]},{"text":" (or ","type":"text"},{"text":"sapjco3.dll","type":"text","marks":[{"type":"code"}]},{"text":" on Windows OS). ","type":"text"},{"type":"hardBreak"},{"text":"Starting with SNP JCo version 229, the library is included in SNP transports for ","type":"text"},{"text":"Linux 86_x64 and Windows x64","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"If the system hosting JCo is running on an OS ","type":"text"},{"text":"other","type":"text","marks":[{"type":"strong"}]},{"text":" than Linux 86_x64 and Windows x64, it is necessary to ","type":"text"},{"text":"manually download and replace the library","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"after the first attempt to start the JCo","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"The first start attempt will fail due to incompatibility, but it will deploy all other libraries and configuration files needed for the JCo run. The location of the libraries is ","type":"text"},{"text":"//lib/","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The SAP Java connector library can be downloaded at","type":"text"},{"type":"inlineCard","attrs":{"url":"https://support.sap.com/en/product/connectors/jco.html"}},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Once uploaded to the application server(s), after the first startup attempt (see below), simply replace the library and change the ownership to adm:sapsys, for example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"cp libsapjco3.so /usr/sap/NSD/DVEBMGS01/work/dvd_conn/jco2402/lib/\nchown nsdadm:sapsys /usr/sap/NSD/DVEBMGS01/work/dvd_conn/jco2402/lib/libsapjco3.so","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Central Java instance","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to deploy a single JCO instance, instead of running one on every application server. To set up such a scenario, follow these steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the Java connector is already running on several application servers, stop all instances.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":45.0},"content":[{"type":"media","attrs":{"width":674,"id":"30ad3500-be1f-45cb-9aa9-45c140e62378","collection":"contentId-5110732767","type":"file","height":83}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the Java RFC destination and fill in the Gateway options valid for the desired instance.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":672,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":672,"alt":"image-20240226-101149.png","id":"b543bbac-e93f-45a0-b707-2884454276eb","collection":"contentId-5110732767","type":"file","height":818}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When the transaction ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"code"}]},{"text":" is reloaded, only buttons next to the application server hosting the JCO are functional and all the other app. servers will be using this connection.","type":"text"},{"type":"hardBreak"},{"text":"When the JCO is started, all rows in the ","type":"text"},{"text":"Connection","type":"text","marks":[{"type":"code"}]},{"text":" column should be green, indicating that every application server can reach the JCO via the designated RFC destination.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":40.0},"content":[{"type":"media","attrs":{"width":659,"id":"eb368d9f-9019-4b8d-af58-e98662bcb236","collection":"contentId-5110732767","type":"file","height":250}}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Setting up the connection via proxy server","type":"text"}]},{"type":"paragraph","content":[{"text":"Sometimes communication with a service outside the corporate network needs to be routed through a proxy server to comply with company security standards.","type":"text"}]},{"type":"paragraph","content":[{"text":" To achieve this, the following parameters need to be added to the ","type":"text"},{"text":"Additional Java starting arguments","type":"text","marks":[{"type":"code"}]},{"text":" field in the ","type":"text"},{"text":"Advanced","type":"text","marks":[{"type":"code"}]},{"text":" tab of ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"-Dhttps.useProxy=true\n-Dhttps.proxyHost=\n-Dhttps.proxyPort=","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":711,"id":"67b183b8-deb4-4e3a-87a6-79107032193f","collection":"contentId-5110732767","type":"file","height":262}}]},{"type":"paragraph","content":[{"text":"There is a chance that the proxy server is configured to communicate in plain HTTP protocol. In that case, the parameters need to reflect that, using:","type":"text"}]},{"type":"codeBlock","content":[{"text":"-Dhttp.useProxy=true\n-Dhttp.proxyHost=\n-Dhttp.proxyPort=","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Custom destination for JCO lock file","type":"text"}]},{"type":"paragraph","content":[{"text":"The lock file is used to prevent the accidental start of multiple JCO instances. By default, the lock file is created in the Installation directory. ","type":"text"},{"type":"hardBreak"},{"text":"If needed, the directory can be changed, using the parameter ","type":"text"},{"text":"-DremoteLockFileDir=","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"SNC configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"If the SAP system is hardened by enabled Secured Network Communication (system parameter ","type":"text"},{"text":"snc/enable = 1","type":"text","marks":[{"type":"em"}]},{"text":"), there are additional configuration steps.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The first step is the creation of a Personal Security Environment (PSE) for the JCO. This is to be done under ","type":"text"},{"text":"adm","type":"text","marks":[{"type":"strong"}]},{"text":" user.","type":"text"},{"type":"hardBreak"},{"text":"PSE should be stored together with other SAP PSE files, by default on path ","type":"text"},{"text":"/usr/sap///sec","type":"text","marks":[{"type":"strong"}]},{"text":", referenced by the environment variable ","type":"text"},{"text":"$SECUDIR","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"Commands to create the PSE, with an example of system ID NSD with csh as nszadm’s shell:","type":"text"},{"type":"hardBreak"},{"text":"su - nsdadm","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"setenv SECUDIR /usr/sap/NSD/D00/sec","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"cd $SECUDIR","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"sapgenpse gen_pse -v -p SNPJCO.pse","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"A passphrase can optionally protect PSE. The mandatory input parameter is the Distinguished name of the PSE owner, in our example, it’s ","type":"text"},{"text":"CN=SNPJCO, OU=SNP, C=DE","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"nsd:nsdadm 98> sapgenpse gen_pse -v -p SNPJCO.pse\nGot absolute PSE path \"/usr/sap/NSD/D00/sec/SNPJCO.pse\".\nPlease enter PSE PIN/Passphrase:\nPlease reenter PSE PIN/Passphrase:\n!!! WARNING: For security reasons it is recommended to use a PIN/passphrase\n!!! WARNING: which is at least 8 characters long and contains characters in\n!!! WARNING: upper and lower case, numbers and non-alphanumeric symbols.\n\nget_pse: Distinguished name of PSE owner: CN=SNPJCO, OU=SNP, C=DE\n Supplied distinguished name: \"CN=SNPJCO, OU=SNP, C=DE\"\n Creating PSE with format v2 (default)\n succeeded.\n certificate creation... ok\n PSE update... ok\n PKRoot... ok\nGenerating certificate request... ok.\nCertificate Request:\n Signed Part:\n Subject: CN=SNPJCO, OU=SNP, C=DE\n Key: rsaEncryption (2048 bits)\n Attributes: None\n Signature:\n Signature algorithm: sha256WithRsaEncryption (1.2.840.113549.1.1.11)\n Signature: \n\nPKCS#10 certificate request for \"/usr/sap/NSD/D00/sec/SNPJCO.pse\":\n\n-----BEGIN CERTIFICATE REQUEST-----\nMIICcjCCAVoCAQAwLTELMAkGA1UEBhMCREUxDDAKBgNVBAsTA0RWRDEQMA4GA1UE\n################################################################\n################################################################\n################################################################\nPxmDNQSCYvLxURXcP+vQxDSOq5QYgQf4g4egjVXRcyQwOJNZRpHlP1olXc4Aa675\n-----END CERTIFICATE REQUEST-----\nnsd:nsdadm 99>","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The second step is to export the certificate with the public key from the newly created PSE, using the command:","type":"text"},{"type":"hardBreak"},{"text":"sapgenpse export_own_cert -v -p SNPJCO.pse -o SNPJCO.crt","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"This produces SNPJCO.crt file.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"nsd:nsdadm 99> sapgenpse export_own_cert -v -p SNPJCO.pse -o SNPJCO.crt\n\n Opening PSE \"/usr/sap/NSD/D00/sec/SNPJCO.pse\"...\n No SSO credentials found for this PSE.\n PSE (v2) open ok.\n Retrieving my certificate... ok.\n Writing to file (PEM-framed base64-encoded)... ok.\n\nnsd:nsdadm 100>","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now import the SNP JCO certificate file into the SAP system’s Trust manager. ","type":"text"},{"type":"hardBreak"},{"text":"Run transaction ","type":"text"},{"text":"STRUST","type":"text","marks":[{"type":"strong"}]},{"text":" > switch to ","type":"text"},{"text":"Edit","type":"text","marks":[{"type":"strong"}]},{"text":" mode > double-click ","type":"text"},{"text":"SNC PSE node","type":"text","marks":[{"type":"strong"}]},{"text":" > in the lower part of the screen click on the ","type":"text"},{"text":"Import certificate","type":"text","marks":[{"type":"strong"}]},{"text":" icon, locate the certificate file, confirm file selection > click ","type":"text"},{"text":"Add to Certificate List","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" (Ctrl+S)","type":"text"},{"type":"hardBreak"},{"text":"NOTE: You may need to download the certificate file to your front end to be able to select it.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":737,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":737,"alt":"image-20240226-133037.png","id":"90d60e6c-4a5e-4a2c-b781-f7077c3d3883","collection":"contentId-5110732767","type":"file","height":801}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We have imported the JCO certificate to SAP. To create two-way trust between SAP and JCO, we now need to import the SAP system’s certificate to JCO PSE.","type":"text"},{"type":"hardBreak"},{"text":"Export SAP’s certificate, similarly as in step 3. Run ","type":"text"},{"text":"STRUST","type":"text","marks":[{"type":"strong"}]},{"text":" and select the ","type":"text"},{"text":"SNC PSE node","type":"text","marks":[{"type":"strong"}]},{"text":", but double-click on ","type":"text"},{"text":"Own certificate,","type":"text","marks":[{"type":"strong"}]},{"text":" and at the bottom of the screen click the icon ","type":"text"},{"text":"Export certificate","type":"text","marks":[{"type":"strong"}]},{"text":". Choose ","type":"text"},{"text":"Base64","type":"text","marks":[{"type":"strong"}]},{"text":" format, path, and filename to save the .crt file. Upload the file to the application server, ideally to ","type":"text"},{"text":"$SECUDIR","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To import the SAP certificate to JCO PSE, run the command:","type":"text"},{"type":"hardBreak"},{"text":"sapgenpse maintain_pk -v -a SAP.crt -p SNPJCO.pse","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"nsd:nsdadm 104> sapgenpse maintain_pk -v -a NSD.crt -p SNPJCO.pse\n\n Opening PSE \"/usr/sap/NSD/D00/sec/SNPJCO.pse\"...\n No SSO credentials found for this PSE.\n PSE (v2) open ok.\n retrieving PKList\n Adding new certificate from file \"NSD.crt\"\n----------\nSubject : CN=NSD, OU=SNP, C=DE\nIssuer : CN=NSD, OU=SNP, C=DE\nSerialno : 0A:20:21:01:24:10:44:01\nKeyInfo : RSA, 2048-bit\nValidity - NotBefore: Sun Jan 24 11:44:01 2021 (210124104401Z)\n NotAfter: Fri Jan 1 01:00:01 2038 (380101000001Z)\nKeyUsage : none\nExtKeyUsage : none\nSubjectAltName : none\n----------------------------------------------------------------------------\n\n PKList updated (1 entries total, 1 newly added)\n\nnsd:nsdadm 105>","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To allow JCO to run under adm user using the certificate stored in the PSE, SSO credentials must be created in the ","type":"text"},{"text":"cred_v2","type":"text","marks":[{"type":"strong"}]},{"text":" file.","type":"text"},{"type":"hardBreak"},{"text":"The file typically already exists in ","type":"text"},{"text":"SECUDIR","type":"text","marks":[{"type":"strong"}]},{"text":" and access to the JCO PSE file certificate is granted with:","type":"text"},{"type":"hardBreak"},{"text":"sapgenpse seclogin -p SNPJCO.pse -O nsdadm","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"If the SAP system is distributed, the ","type":"text"},{"text":"PSE file","type":"text","marks":[{"type":"strong"}]},{"text":" and SSO credentials allowing access to it in ","type":"text"},{"text":"cred_v2","type":"text","marks":[{"type":"strong"}]},{"text":" need to be present on ","type":"text"},{"text":"each application server","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"IMPORTANT: cred_v2","type":"text","marks":[{"type":"strong"}]},{"text":" file should NOT be copied between application servers!","type":"text"},{"type":"hardBreak"},{"text":"It must be updated locally with the sapgenpse utility to reflect the correct PSE path. (The PSE file can be copied).","type":"text"}]},{"type":"codeBlock","content":[{"text":"nsd:nsdadm 106> sapgenpse seclogin -p SNPJCO.pse -O nsdadm\n\n running seclogin with USER=\"nsdadm\"\n creating credentials for yourself (USER=\"nsdadm\")...\n Added SSO-credentials for PSE \"/usr/sap/NSD/D00/sec/SNPJCO.pse\"\n\nnsd:nsdadm 107>","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"NOTE: If JCO is deployed in a ","type":"text"},{"text":"Windows","type":"text","marks":[{"type":"strong"}]},{"text":" environment, allow access to the PSE file for user ","type":"text"},{"text":"SAPService","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"example: ","type":"text"},{"text":"sapgenpse seclogin -p SNPJCO.pse -O SAPServiceNSD","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Available SSO credentials can always be checked using the command:","type":"text"},{"type":"hardBreak"},{"text":"sapgenpse seclogin -l","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now that the security environment is prepared, configure JCO SNC in transaction ","type":"text"},{"text":"/DVD/JCO_MNG","type":"text","marks":[{"type":"strong"}]},{"text":" in the Config Tab:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":591,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":591,"alt":"image-20240226-132043.png","id":"3c67f8f9-f3e7-4c88-82b1-c60271718870","collection":"contentId-5110732767","type":"file","height":132}}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SNC enabled","type":"text","marks":[{"type":"strong"}]},{"text":": Once activated, user and password fields will be greyed out and have no effect on JCO configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SNC QoP Level","type":"text","marks":[{"type":"strong"}]},{"text":": SNC Quality of Protection, needs to be the same level set in system parameter ","type":"text"},{"text":"snc/data_protection/use","type":"text","marks":[{"type":"em"}]},{"text":" (default = 3).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SNC name","type":"text","marks":[{"type":"strong"}]},{"text":": Distinguished name chosen during the creation of JCO PSE (step 1).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SNC-enabled GW port","type":"text","marks":[{"type":"strong"}]},{"text":": SAP gateway port used for secure communication. Do not change the default value ","type":"text"},{"text":"48$$","type":"text","marks":[{"type":"strong"}]},{"text":", $$ is automatically translated to the instance number of a particular application server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SNC partner name:","type":"text","marks":[{"type":"strong"}]},{"text":" Distinguished name of SAP system, pre-filled from SAP profile parameter ","type":"text"},{"text":"snc/identity/as.","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Save the configuration when completed, but ","type":"text"},{"text":"do not start","type":"text","marks":[{"type":"strong"}]},{"text":" the JCO yet.","type":"text"},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"There are two more configuration pieces to complete before JCO can properly start and register on the SAP gateway.","type":"text"},{"type":"hardBreak"},{"text":"In ","type":"text"},{"text":"SU01","type":"text","marks":[{"type":"strong"}]},{"text":", activate SNC for ","type":"text"},{"text":"RFC users","type":"text","marks":[{"type":"strong"}]},{"text":" dedicated to JCo communication, filling in the ","type":"text"},{"text":"SNC name","type":"text","marks":[{"type":"strong"}]},{"text":" dedicated to JCo.","type":"text"},{"type":"hardBreak"},{"text":"Despite the user no longer being configured in /DVD/JCO_MNG, it is used by matching the SNC name entered here and the Distinguished name configured in JCo PSE. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":621,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":621,"alt":"image-20240226-132409.png","id":"d6a4b568-d427-4c42-9683-3be60064869a","collection":"contentId-5110732767","type":"file","height":260}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Secondly, via ","type":"text"},{"text":"SM59","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"activate SNC ","type":"text","marks":[{"type":"strong"}]},{"text":"in the RFC destination dedicated to communication between SAP and JCO and fill in the JCo Distinguished name again in the ","type":"text"},{"text":"Logon & Security","type":"text","marks":[{"type":"strong"}]},{"text":" tab (SNC options button):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":968,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":968,"alt":"image-20240226-132645.png","id":"ee1d49ac-1856-4e7b-aa73-090cdf1b194f","collection":"contentId-5110732767","type":"file","height":614}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"With all SNC prerequisites met, Java Connector can be started.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sample JCo configuration files with SNC enabled","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If the JCo is deployed in a ","type":"text"},{"text":"Windows","type":"text","marks":[{"type":"strong"}]},{"text":" environment, the path to the cryptographic library may contain \\usr or a similar path segment with ","type":"text"},{"text":"\\u","type":"text","marks":[{"type":"strong"}]},{"text":" character.","type":"text"},{"type":"hardBreak"},{"text":"That may result in an error during JCo startup:","type":"text"},{"type":"hardBreak"},{"text":"Exception in thread \"main\" java.lang.IllegalArgumentException: Malformed \\uxxxx encoding.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"To circumvent this, every \\u character in the configuration files must be preceded by an additional backslash → ","type":"text"},{"text":"\\\\u","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"To prevent the automatic overwrite of manually modified configuration files during JCO start, the option ","type":"text"},{"text":"Avoid JCO config files creation","type":"text","marks":[{"type":"strong"}]},{"text":" of /DVD/JCO_MNG needs to be selected:","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Configuration files example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"nsd:/usr/sap/NSD/D00/work/dvd_conn/jco2402 # cat config.jcoServer\nversion=2402\njco.server.gwhost=127.0.0.1\njco.server.gwserv=4800\njco.server.connection_count=10\njco.server.progid=SNPJCO\njco.server.repository_destination=ABAP_AS_WITH_POOL\njco.server.worker_thread_min_count=5\njco.server.worker_thread_count=20\njco.server.snc_mode=1\njco.server.snc_qop=3\njco.server.snc_myname=p:CN=SNPJCO, OU=SNP, C=DE\njco.server.snc_lib=/sapmnt/NSD/exe/uc/linuxx86_64/libsapcrypto.so\n\nnsd:/usr/sap/NSD/D00/work/dvd_conn/jco2402 # cat config_as.jcoDestination\njco.client.client=001\njco.client.sysnr=00\njco.client.peak_limit=10\njco.client.ashost=127.0.0.1\njco.client.snc_mode=1\njco.client.snc_qop=3\njco.client.snc_myname=p:CN=SNPJCO, OU=SNP, C=DE\njco.client.snc_partnername=p:CN=NSD, OU=SNP, C=DE\njco.client.snc_lib=/sapmnt/NSD/exe/uc/linuxx86_64/libsapcrypto.so","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Upgrading Java connector","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a list of steps to do when you update your SNP software and you would like to switch to a new version of the Java connector. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"With SAP JCO version 3.1, additional authorization is required for JCO’s RFC user, which allows the execution of function modules in function group RFC_METADATA.","type":"text"},{"type":"hardBreak"},{"text":"Please make sure the RFC user has all authorizations listed in the ","type":"text"},{"text":"SAP RFC role and user","type":"text","marks":[{"type":"strong"}]},{"text":" section of this page.","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":"code"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":819,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":819,"alt":"upgrade_1.png","id":"9f2df92f-96d1-43d8-8032-d21e1a10aee7","collection":"contentId-5110732767","type":"file","height":239}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Double-click the current working connector and click ","type":"text"},{"text":"Upgrade JCO","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":819,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":819,"alt":"upgrade_2.png","id":"789adda1-fc97-4191-b20c-036b08ca8857","collection":"contentId-5110732767","type":"file","height":239}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pop-out window will appear, confirming the version to which JCO will be upgraded and selecting the new installation directory. Press ","type":"text"},{"text":"Proceed","type":"text","marks":[{"type":"code"}]},{"text":" to continue.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":493,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":493,"alt":"upgrade_3.png","id":"1737eedf-1af9-442a-9f71-d7a6d8b839a4","collection":"contentId-5110732767","type":"file","height":126}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Acknowledge the warning. Once confirmed JCO will upgrade automatically.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":490,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":352,"alt":"upgrade_4.png","id":"49b8d52f-3f34-4105-b42c-046864a32d9d","collection":"contentId-5110732767","type":"file","height":131}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After a successful upgrade, a new version of JCO will be automatically deployed and started.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":818,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":818,"alt":"upgrade_5.png","id":"74cb377b-d964-47aa-907d-d6cc4d1d4d89","collection":"contentId-5110732767","type":"file","height":239}}]}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Restarting the connector can cause running Glue/Outboard jobs to fail. Therefore it is recommended to perform the upgrade during a quiet period and have Glue/Outboard jobs suspended.","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Automatic Java connector startup after SAP system restart","type":"text"}]},{"type":"paragraph","content":[{"text":"For the automatic start of the Java connector after the SAP system restarts, schedule a periodic job with program ","type":"text"},{"text":"/DVD/JCO_WATCH_DOG","type":"text","marks":[{"type":"code"}]},{"text":" with start condition: “SAP_SYSTEM_START“.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":568,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":468,"id":"c0682502-0fcb-4702-a2d3-ed25cec13ac1","collection":"contentId-5110732767","type":"file","height":278}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Setting up the automatic start of Java Connector after SAP system restart is not mandatory. Java Connector is normally started when it is needed.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Copying Java connector","type":"text"}]},{"type":"paragraph","content":[{"text":"Sometimes it may be needed to COPY the JCO instance and create a version from it.","type":"text"},{"type":"hardBreak"},{"text":"When the JCO is copied, the separate JCO installation directory is used; the new JCO instance thus has its own space for configuration and logs.","type":"text"}]},{"type":"paragraph","content":[{"text":"Possible use cases for JCO COPY:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vertical scaling: When more JCO instances are needed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Versioning: When the JCO is needed for a different purpose.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JCO testing: To make different instances for testing purposes.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"With JCO COPY functionality the new JCO copy/instance is created with an increased subversion ID number.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example when copying from ID 240, then a JCO copy is created with ","type":"text"},{"text":"ID: 240.1","type":"text","marks":[{"type":"strong"}]},{"text":". The next copy will have ","type":"text"},{"text":"ID: 240.2","type":"text","marks":[{"type":"strong"}]},{"text":".","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":"code"}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1065,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1065,"alt":"image-20240226-134217.png","id":"692fd004-eb0a-47e0-b394-6e743dc349cb","collection":"contentId-5110732767","type":"file","height":375}}]},{"type":"paragraph","content":[{"text":"2. Click on ","type":"text"},{"text":"Copy JCO","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":560,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":560,"alt":"image-20240226-134316.png","id":"d9266c57-81e4-44f6-bdb9-0df75ffef1f9","collection":"contentId-5110732767","type":"file","height":217}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy config from Java RFC","type":"text","marks":[{"type":"strong"}]},{"text":": Copies JCO configuration from the JCO configured with selected RFC destination.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy config from version ID","type":"text","marks":[{"type":"strong"}]},{"text":": Copies JCO configuration from given JCO ID.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use default values","type":"text","marks":[{"type":"strong"}]},{"text":": Uses defaults for the new JCO.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Java version","type":"text","marks":[{"type":"strong"}]},{"text":": Read-only field as a newly created copy of JCO will be created from a particular Java version.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description: ","type":"text","marks":[{"type":"strong"}]},{"text":"Description of a newly created copy of JCO.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"3. Example of the JCO copy, reconfigured with appropriate parameters - most importantly ","type":"text"},{"text":"RFC destination","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Installation directory","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":963,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":963,"alt":"image-20240226-134920.png","id":"5d05ad6b-0bde-475b-aeaf-456ae597d233","collection":"contentId-5110732767","type":"file","height":328}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":956,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":956,"alt":"image-20240226-135013.png","id":"ccf5adce-2df7-412c-b438-f85009e1527b","collection":"contentId-5110732767","type":"file","height":284}}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported