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.

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 that has xDI installed. 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 into C:\windows\system32\.

  • Add the sapjco3.dll directory to your PATH 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.

  1. In xDI Designer, open the Help menu, and select Install New Software menu to open the Install window.

  2. 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

  3. Select the components that you want to install, and click Next

  4. Review the list of components to install, and click Next

  5. Review and accept the license terms, then click Finish

  6. Restart Designer when prompted.

Locate these SAP JCo libraries, and set them aside for when you connect to your data:

  • sapjco3.dll, libsapjco3.so or sapjco3.so

  • sapjco3.jar

  • sapidoc3.jar

Next steps

Next, proceed to the SAP server setup guide.