Installing the SAP Java Connector (JCo) libraries

You must install the SAP Java™ Connector (JCo) 2.x libraries for the specific operating systems of the Agile Service Manager servers and/or anchors in the Agile Service Manager environment.

To install the JCo library files, complete the following steps, where operating_system represents AIX, Linux, Linuxs390x, or Windows:
  1. Choose the appropriate SAP JCo libraries that are shipped with Agile Service Manager. The only version shipped with Agile Service Manager is 2.1 32bit.
    The following table lists the typical name format of the SAP JCo library packages, listed by operating system.
    Table 1. Package names of the SAP JCo 2.x library files
    Operating system Package name
    AIX® (32-bit) sapjco21P_10-10002239.zip
    AIX (64-bit) sapjco21P_10-10002882.zip
    Windows Server on x86_32 (32-bit) sapjco21P_10-10002243.zip
    Windows on x86_64(64-bit) sapjco21P_10-20001730.zip
    Linux® on x86_32 (32-bit) sapjco21P_10-20007301.zip
    Linux on x86_64 (64-bit) sapjco21P_10-20007300.zip
    Linux on zSeries (64-bit) sapjco21P_10-10002245.zip
    Linux on Power® (64-bit) sapjco21P_10-20007302.zip
  2. Back up the following directory: $COLLATION_HOME/lib/JCo/operating_system.
  3. Copy the following files from the package to the following directories:
    For UNIX or Linux operating systems:
    • librfccm.* to $COLLATION_HOME/lib/JCo/operating_system
    • libsapjcorfc.so to $COLLATION_HOME/lib/JCo/operating_system
    • sapjco.jar to $COLLATION_HOME/lib/JCo/operating_system/lib
    For Windows operating systems:
    • librf32.dll to $COLLATION_HOME/lib/JCo/operating_system
    • sapjcorfc.dll to $COLLATION_HOME/lib/JCo/operating_system
    • sapjco.jar to $COLLATION_HOME/lib/JCo/operating_system/lib
  4. Restart the Agile Service Manager server.

Run the ldd command against the libraries to see the dependencies, and ensure that the dependencies are supported. The base operating system supports most of the dependencies.

On the Linux operating system, the libstdc++-libc6.2-2.so.3 library might not be installed by default. In that case, you must install the Red Hat package compat-libstdc++-296 to get the libstdc++-libc6.2-2.so.3 library files.

If the library dependencies are not supported, the following message is shown:
Sensor failed in remote server: JCO.classInitialize ():  Could not load middleware layer 
'com.sap.mw.jco.rfc.MiddlewareRFC' JCO.nativeInit (): Could not initialize dynamic link library sapjcorfc
 [Can't find library sapjcorfc  (libsapjcorfc.so) in sun.boot.library.path or java.library.path sun.boot.
library.path={full-path-list}