This section explains how to enable business transaction correlation for Java applications which communicate with SAP systems using SAP JCo library.

On this page:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
39 rates
SAP JCo enables the Java application to call RFC-enabled function modules in the SAP ABAP system.

  • Supported JCo versions: SAPJCo2, SAPJco3
  • Supported SAP Java Resource Adapter (JRA)
  • Minimum Java agent version: 4.3.8.x
  • Known compatibility issue with Java Agent versions 4.5.5 to 4.5.8, fixed in 4.5.9

JCo Instrumentation Architecture

In the current version the instrumentation of JCo RFC calls are done by a Java agent extension (SDK plug-in).

The following diagram describes the high-level architecture of the JCo instrumentation.

  • Java application uses SAP JCo library to call RFC-enabled function modules in the SAP NetWeaver system.
  • Java agent intercepts the RFC exit calls using the JCo extension.
  • JCo extension sends the correlation information to the ABAP agent, which can start and stop continuing business transactions.

Install Java Agent and JCo extension

Use the generic procedure for Java Agent installation and continue with the following steps to see the RFC calls from Java to the SAP systems: 

  1. Install Java Agent within SAP components by following the standard installation procedure described in Install the Java Agent
  2. Extract the ABAP Agent zip file, APPD-SAP-<version>.zip
  3. Copy the content of the APPD-SAP-<version>/AppServerAgent-JCo-plugin-<version>/ directory to [JavaAgentPath]/ver4.3.x.x/sdk-plugins/ directory.
  4. Enable the unsigned extensions in the Java startup script using the allow.unsigned.sdk.extension.jars=true parameter.

If you are using SAP Application servers, the following tools can also help you add the Java Agent into the run time:

  1. SAP NetWeaver Administrator 
  2. AS Java Config Tool

Configuring AppDynamics Java Agent using SAP NetWeaver Administrator 

  1. Open the SAP NetWeaver Application Server Java web portal.
  2. Click SAP NetWeaver Administrator >> Configuration >> Infrastructure >> Java System Properties >> Additional VM Parameters.
    1. Add a VM parameter for the unsigned SDK extensions, -Dallow.unsigned.sdk.extension.jars=true.
    2. Add a VM parameter, -Dappdynamics.bciengine.should.implement.new.interfaces=false
    3. Add a VM parameter for the Java Agent, javaagent:<agent_home>/javaagent.jar.
    4. Click Save
  3. Restart SAP server.

Configuring AppDynamics Java Agent using AS Java Config Tool 

  1. Open the SAP NetWeaver Application Server Java web portal.
  2. Select the instance in AS Java Config Tool and click VM Parameters >> Additional
    1. Add a VM parameter for the unsigned SDK extensions, Dallow.unsigned.sdk.extension.jars=true.
    2. Add a VM parameter, -Dappdynamics.bciengine.should.implement.new.interfaces=false
    3. Add a VM parameter for the Java Agent, javaagent:<agent_home>/javaagent.jar.
    4. Click File, Apply Changes
  3. Restart SAP server.

Logging in Debug Mode

  1. Connect to controller and navigate to Tiers & Nodes. 
  2. Select the desired java node that needs to be enable debug mode. 
  3. Select Agents and click Request Agent Log File. 
  4. Select Output from Specific logger, at a set level, for a fixed duration:
    1. Logger Name: com.singularity
    2. Logger Level: Debug
    3. Duration (minutes): at least 10

  5. Click Request Agent Log Files. 
  6. When the status turns successful, click Download.

Recommended

Start debug mode and attach logs to support tickets.

Authorizations

All the following SAP users should be assigned to authorization role /DVD/APPD_USER:

  • SAP users that call RFC from Java 
  • SAP users used by RFC destinations 

See AppDynamics Authorizations for more details.

 

  • No labels