# Configure the Workato On-prem Agent (OPA)

Configuring a Workato On-prem Agent (OPA) on the Sap server consists of the following steps:

  1. Download Workato On-prem Agent (OPA)
  2. Download the SAP JCO libraries
  3. Create SAP profile in OPA
  4. Run OPA

# Download Workato On-prem Agent (OPA)

For Workato to talk to SAP, you must install a Workato On-prem Agent (OPA) on your SAP server, or on a separate virtual machine that can reach your SAP server.

The Virtual Machine server and your SAP server must be in the same domain, not outside of the firewall, and able to access each other. To test the virtual machine server and the SAP's server's ability to communicate with each other, try to ping the other server from each server.

Follow these instructions to download and setup a Workato OPA.


# Download the SAP JCO libraries

If you do not already have a license to use SAP JCo libraries, contact your SAP provider for a license.

Visit SAP JCO Libraries (opens new window) to download the following items:

  • SAP JCO connector libraries
    • Direct connections (version 3.1.7 and above)
    • Message server connections (version 3.1.7 and above)

OPERATING SYSTEM COMPATIBILITY

Select the correct version of the library for your operating system.

Additionally, refer to SAP Note 2786882 - SAP JCo 3.1 release and support strategy (opens new window) to make sure your operating system fulfills all prerequisites.

After you download the libraries, place them in the lib_ext/ directory of the OPA.

Windows users:
Ensure that you have imported all relevant files into the lib_ext folder. You should have imported a total of 3 files: sapjco3.dll, sapjco3.jar, and sapidoc3.jar into your lib_ext folder. A file named sap-connector-X.X.X.jar should already be inside.
Mac users:
Ensure that you have imported all relevant files into the lib_ext folder. You should have imported a total of 3 files: libsapjco3.dylib, sapjco3.jar, and sapidoc3.jar into your lib_ext folder. A file named sap-connector-X.X.X.jar should already be inside.
Linux users:
Ensure that you have imported all relevant files into the lib_ext folder. You should have imported a total of 3 files: libsapjco3.so, sapjco3.jar, and sapidoc3.jar into your lib_ext folder. A file named sap-connector-X.X.X.jar should already be inside.

# Create a SAP profile in OPA

Follow these instructions to create a SAP profile in OPA.


# Run OPA

Follow these instructions to run the OPA. After it successfully runs, you can move on to configure the SAP connector in Workato.


FURTHER READING

To complete your connection to SAP RFC, read the following guides:

  1. Configure the Workato SAP connector.
  2. Optional: Configure IDocs to/from Workato in SAP.


Last updated: 3/29/2023, 2:00:59 PM