Set up Semarchy xDI and its environment for SAP
This document explains how to set up Semarchy xDI, as well as the computing environment, to get them ready to use with SAP.
This process consists of the following steps:
-
Download official SAP JCo (Java Connector) resources.
-
Install SAP resources to the operating system.
-
Install the SAP component in xDI Designer.
-
Install SAP resources to Semarchy xDI software.
Download SAP resources
Due to licensing restrictions, we cannot distribute the SAP JCo libraries. You must download them from the SAP website yourself.
Log in to your SAP account on the SAP website. Find the SAP Java Connector libraries, and download them to the computer with xDI software. You need the following packages:
-
SAP Java Connector 3.1 SDK for your operating system
-
SAP Java IDoc Library
Extract these resources to a directory of your choice.
Install SAP resources to the operating system
Windows
Find the sapjco3.dll
file from the connector SDK, and take note of its location on your computer.
Perform one of these tasks:
-
Copy the
sapjco3.dll
file intoC:\windows\system32\
. -
Add the
sapjco3.dll
directory to yourPATH
environment variable.
On Windows, JCo 3 requires Microsoft Visual C++ libraries to be installed. See the SAP documentation for more information.
Linux and macOS
Find the libsapjco3.so
or sapjco3.so
file from the connector SDK, and take note of its location on your computer.
Perform one of these tasks:
-
Copy the file into the
lib
folder under the Java JDK installation path. -
Add the directory to your system library path. This task depends on your exact operating system.
Install the SAP component
Install the SAP component in Designer by following the component installation process.
-
In xDI Designer, open the Help menu, and select Install New Software menu to open the Install window.
-
In the Work with dropdown menu, select an update site. Use the update site with a version number corresponding to your quarterly software version.
The update site URI uses the following syntax:
https://download-xdi.semarchy.com/components/<version_year>.<version_quarter>
Example for version 2023.4 MS:
https://download-xdi.semarchy.com/components/2023.4
-
Select the components that you want to install, and click Next
-
Review the list of components to install, and click Next
-
Review and accept the license terms, then click Finish
-
Restart Designer when prompted.
Locate these SAP JCo libraries, and set them aside for when you connect to your data:
-
sapjco3.dll
,libsapjco3.so
orsapjco3.so
-
sapjco3.jar
-
sapidoc3.jar
Next steps
Next, proceed to the SAP server setup guide.