IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


Adding external software dependencies for SAP

Before you can develop message flows that use WebSphere® Adapters nodes, you must add prerequisite files to the runtime environment.

Before you begin

  • Ensure that either a WebSphere MQ client or a WebSphere MQ server is installed on the same computer as the integration server. For more information about using WebSphere MQ with IBM® App Connect Enterprise, see Installing IBM MQ.
  • Ensure that you have the relevant prerequisite files for your SAP system. (For information about the versions of files that IBM App Connect Enterprise supports, see IBM App Connect Enterprise system requirements.)
    • sapidoc3.jar
    • sapjco3.jar
    • Windows platformOn Windows:
      • sapjco3.dll
    • z/OS platformLinux platformUNIX platform On z/OS®, Linux, and UNIX:
      • libsapjco3.so
    Note: You can download these files for your operating system from the external SAP Web site, SAP Service Marketplace, and save them to a directory, such as C:\SAP_LIB. (On Windows, the directory cannot be a mapped network drive on a remote Windows computer; the directory must be local or on a Storage Area Network (SAN) disk.) You must have an SAPNet account to be able to access this Web site.
    • Windows platformOn Windows, download the .dll files that come with the SAP JCo download.
    • z/OS platformLinux platformUNIX platformOn z/OS, Linux, and UNIX, download the .so and .o files that come with the SAP JCo download.

Locating the SAP support files in the runtime environment

About this task

The integration server configuration file (server.conf.yaml) contains a section for connector providers, which defines the location of the required JAR files and native libraries, as you can see in the following example:
ConnectorProviders:
  SAPConnectorProvider:
    jarsURL: default_Path     # Set to the absolute path containing the SAP JCo JARs
    nativeLibs: default_Path  # Set to the absolute path containing the SAP JCo libraries 
By default, the location is set to default_Path, which indicates that the JAR files and libraries can be found in the integration server's shared-classes directory.

To specify a location for the SAP prerequisite files, complete the following steps.

Procedure

Windows platformLinux platformUNIX platformOn Windows, Linux, and UNIX:
  1. Use a YAML editor to open the server.conf.yaml file, then find the ConnectorProviders section. For more information, see Configuring an integration server by using the server.conf.yaml file.
  2. Set the jarsURL property to the absolute path where the JAR files are stored.
  3. Set the nativeLibs property to the absolute path where the native libraries are stored.
  4. Save the server.conf.yaml file, then restart the integration server.

Locating the SAP support files through the IBM App Connect Enterprise Toolkit

About this task

To add the SAP prerequisite files through the IBM App Connect Enterprise Toolkit, take the following steps.

Procedure


tsap_extdepend.htm | Last updated 2018-11-02 14:46:52