Configure the SAP Agent

Supported for: Windows and Linux

This task describes how to configure the SAP agent. The SAP agent handles SAP RFC or SAP IDOC communication between a SAP®  or SAP NetWeaver® Process Integration (PI) system, and a real or virtual SAP service.

Prerequisites for Windows

Make sure that the following are configured on each Service Virtualization Designer or Service Virtualization standalone server machine on which you are using the SAP Agent:

  1. SAP Java Connector version 3.0.11 or later.

    1. Download the 64-bit SAP Java Connector library from the SAP support site.

    2. Extract and copy the following files from the Java libraries to the Service Virtualization installation directory's \bin folder:

      • sapjco3.jar
      • sapjco3.dll
      • sapjco3.pdb
    3. Restart the Service Virtualization Server.

  2. SAP GUI.

    Alternatively, if you do not have SAP GUI installed, you can update the Windows services file, located in %WinDir%\System32\drivers\etc.

    Add the following line, replacing xx with your SAP system number:

    sapgwxx 33xx/tcp

Back to top

Prerequisites for Linux

Make sure that the following are configured on each Service Virtualization standalone server machine on which you are using the SAP Agent:

  1. Download the 64-bit SAP Java Connector library from the SAP support site.

  2. Extract and copy the following files from the Java libraries to the /usr/lib/sv-server/bin folder:

    • libsapjco3.so
    • sapjco3.jar
    • sapjco3.dll
    • sapjco3.pdb
  3. Add the following line to /etc/services, replacing xx with your SAP system number:

    sapgwxx 33xx/tcp

  4. Restart the Service Virtualization Server.

Back to top

Configure the agent settings

From the main menu, select Tools > Options. On the Agents Page, select SAP. For user interface details, see the Agents Page.

Back to top

Reconfigure the client to point to the virtual service

For a SAP Server: If your source SAP system is a SAP Server, you must reconfigure the SAP RFC destination to point to the virtual service.

  1. On the SAP server, navigate to transaction sm59. Locate and delete the original destination.
  2. Under TCP/IP Connections, create a new destination and configure the following:

    RFC destination Assign the same name as the original destination.
    Registered Server Program Select this option, and enter the Program ID. The value you assign to Program ID must be identical to the Program ID entered in the virtual service's properties in Service Virtualization.
    Gateway Options Enter the SAP Gateway Host and Gateway Service Name These values must be identical to the values entered in the Service Virtualization Agents page.
  3. Click Connection Test to test your configuration. Your virtual service must be deployed to carry out this test.

For SAP PI : If your source SAP system is SAP PI, you must reconfigure the communication channel.

In SAP PI Integration Builder, navigate to the appropriate RFC receiver communication channel, and configure the following:

RFC Server Type Select External RFC Server.
Application Server (Gateway) Enter the SAP Gateway Host (the PI System). The value must be identical to the value entered in the Service Virtualization Agents page.
Application Server Service (Gateway) Enter the SAP Gateway Service Name. The value must be identical to the values entered in the Service Virtualization Agents page.
Program ID The value you assign must be identical to the Program ID entered in the virtual service's properties in Service Virtualization.

Back to top

See also: