SAP Connector Installation¶

Introduction¶

In order to use Jitterbit's SAP connectors (either the Cloud Studio SAP Connector or the Design Studio SAP Connector) with Private Agents, certain libraries provided by SAP must be present and installed as described on this page. The appropriate libraries are already installed on Cloud Agents.

Note

Beginning with Private Agent version 10.54, Jitterbit's SAP connectors will no longer work until you install these libraries as described here. You can install the libraries prior to upgrading to 10.54 or later to prepare for the upgrade, or you can install them after upgrading to 10.54 or later.

These files persist on post-10.54 Private Agent upgrades, so this process needs to be followed only a single time on each Private Agent machine.

Downloading Required Components¶

Use these SAP Support Portal download links to obtain the specific files required by Jitterbit's SAP connectors, listed in the table below. To access the SAP Support Portal downloads, SAP requires that the SAP S-User ID associated with the logged-in user has the Software Download authorization. To request the appropriate permissions, contact your SAP user administrator.

This table summarizes the files required when using the SAP connectors on Private Agents. The following subsections provide details on where the required files can be found within the downloaded archives.

SAP Java Connector Download Section Link	Specific Version to Download	Required Files Needed by Jitterbit's SAP Connectors	Instructions to Locate the Required Files
SAP Java Connector 3.1 SDK Note SAP Java Connector 3.0 SDK files have also been tested and may be used; however, SAP has ended the maintenance and support period for this version.	Microsoft Windows and Windows Server 64-bit x86	`sapjco3.dll` `sapjco3.jar`	SAP Java Connector Files for Windows
	Linux for Intel-compatible processors 64-bit x86	`libsapjco3.so` `sapjco3.jar`	SAP Java Connector Files for Linux
SAP Java IDoc Library	SAP Java IDoc Library 3.0.14 SDK	`sapidoc3.jar`	SAP Java IDoc Library

The next section, Installing Required Components, describes where those files should be placed in order to use Jitterbit's SAP connectors on Private Agents.

SAP Java Connector Files for Windows¶

Go to the section Download SAP Java Connector 3.1 SDK on the SAP Java Connector page.
In the table of downloads, use the link for the 64-bit x86* version for Microsoft Windows and Windows Server to download a ZIP file. The ZIP file is named similarly to sapjco31P_4-20009381-Windows.zip. Unpack the archive.
Within the unpacked archive, locate another ZIP file, named similarly to sapjco3-ntamd64-3.1.4.zip. Unpack the archive.
Within the newly unpacked archive, locate sapjco3.dll and sapjco3.jar:

SAP Java Connector Files for Linux¶

Go to the section Download SAP Java Connector 3.1 SDK on the SAP Java Connector page.
In the table of downloads, use the link for the 64-bit x86* version for Linux for Intel compatible processors to download a ZIP file. The ZIP file is named similarly to sapjco31P_4-70004517-Linux.zip. Unpack the archive.
Within the unpacked archive, locate the TGZ file, named similarly to sapjco3-linuxx86_64-3.1.4.tgz. Unpack the archive.
Within the newly unpacked archive, locate the TAR file, named similarly to sapjco3-linuxx86_64-3.1.4.tar. Unpack the archive.
Within that newly unpacked archive, locate libsapjco3.so and sapjco3.jar:

SAP Java IDoc Library¶

Go to the section SAP Java IDoc Library on the SAP Java Connector page.
Use the link Download SAP Java IDoc Library 3.0.14 SDK to download a ZIP file. The ZIP file is named similarly to sapjidoc30P_14-10009485.zip. Unpack the archive.
Within the unpacked archive, locate sapidoc3.jar:

Installing Required Components¶

A user with access to each Private Agent machine can install the required components on Windows or Linux machines using the instructions below.

Windows¶

Follow these steps to install the required components for Jitterbit's SAP connectors on each Windows Private Agent machine.

Copy the DLL file to the Private Agent bin directory:
```
C:\Program Files\Jitterbit Agent\bin\sapjco3.dll
```

Copy the JAR files to the Private Agent directories listed below:

C:\Program Files\Jitterbit Agent\tomcat\lib\sapjco3.jar

C:\Program Files\Jitterbit Agent\tomcat\lib\sapidoc3.jar

Restart the Windows Private Agent.

Linux¶

Follow these steps to install the required components for Jitterbit's SAP connectors on each Linux Private Agent machine.

Copy the SO file from the download location to the Private Agent bin directory (adjust source name as required):
```
/opt/jitterbit/lib/libsapjco3.so
```
Copy the JAR files from the download location to the Private Agent directories listed below (adjust source name as required):
```
/opt/jitterbit/tomcat/lib/sapidoc3.jar

/opt/jitterbit/tomcat/lib/sapjco3.jar
```
Restart the Linux Private Agent.