(DI-2111) Install and start JMX connector on SAP system

Owned by SNP
Nov 05, 2021
3 min read

JMX connector is implemented in JAVA as a JCo service. The service has to be configured and running before first use. All configuration setup of the JCo service for the JMX connector has to be done on the central instance of Datavard Insights.

Setup

  1. Create user DVD_JMX_USER using transaction SU01 and assign him role /DVD/JMX_JCO_RFC. This user will communicate with the JMX connector installed on the application server.

  2. Execute the report /DVD/JMX_JCO_SETUP, check Setup JCO service and all fields should be now editable.

    • JCO server

      • Gateway service - port which SAP gateway of SAP AS is listening on. It is automatically detected for the main SAP AS.

      • Program ID - name under which JCo service will be registered on SAP AS Gateway. The default value is DVD_JMX_PROGID

      • Connection count - value of greater than 1 allows parallel outbound processing of server instances. The maximum is 100, the default value is 10.

      • Worker thread count - defines the maximum number of JCo Server worker threads in the thread pool. To enable parallel outbound processing, use a value greater than 1. It is recommended you use a value of 4 to process a high number of small messages. The maximum value is 100. The default value is 20.

      • Worker thread min. count - defines the minimum number of JCo Server worker threads for receiving calls from SAP. The default value is 5. If JCo Server is idle, the specified number of minimum threads is kept running in the thread pool.

      • Gateway host - IP address of gateway host. It is automatically detected for the main SAP AS

    • JCO client

      • Client - the name of the SAP logon client for the central system

      • User - user created in step 1 for logon to the central system

      • Password - the password of the user created in step 1 for SAP authentication

      • System number - the SAP system number

      • Peak limit - the maximum number of connections available in the connection pool

      • Application server host - the fully-qualified name or IP address of the application server that hosts SAP. It is recommended to choose the same application server as for deploying of JCo service.

    • Installation properties

      • Installation directory on AS - full directory path where java application for JMX connector and all corresponding files will be copied.

      • Java path on AS - full path to the installation directory of Java on the Application server. Not enabled on Windows systems as long as java is added to PATH.

      • AS name to deploy JCo - the name of the application server on which the JMX connector will be installed.

    • You can hit Get default configuration values and fields will be populated by default values with exception of password and system number

  3. After entering correct values, do not forget to execute (F8) so configuration values are saved.

  4. Check Install and start JCO service and execute.

  5. After the report finishes executing, you can get back and execute Check deployment to make sure the JMX connector was installed and started successfully on the application server.