Installing the SAP Java Connector (JCo)

The connector might or might not be available with the base Security Directory Integrator or Security Directory Integrator product. The connector is required to establish communication between the adapter and the Dispatcher. After you download the JCo package, unpack the contents and then follow these instructions.

About this task

The SAP NetWeaver Adapter is tested and certified by using Java™ Connector, version 3.0.13. It is the same JCo version that SAP made available at the time when this adapter was released.
Note: SAP might release a newer version of JCo before the next release of the adapter and might remove JCo version 3.0.13 from download. The newer version of JCo might work as is with the adapter. If there are any issues that are related directly to the newer version of JCo, it will be addressed in the next release of the adapter.

Procedure

  • Windows:
    1. Copy the sapjco3.jar file into ITDI_HOME/jars/3rdparty/others.
    2. Copy the sapjco3.dll file into ITDI_HOME/libs.
      On Windows, JCo 3 requires additional Microsoft Visual C++ 2005 libraries to be installed. Installation details for the package that contains these libraries are specified in Microsoft Knowledge Base article 973544.
    3. Restart the adapter service.
  • UNIX or Linux:
    1. Create a symbolic link to the sapjco3.jar file in ITDI_HOME/jars/3rdparty/others: 
      ln -s <sapjco_install_dir>/sapjco3.jar  
   ITDI_HOME/jars/3rdparty/others/sapjco3.jar
    2. Add the SAP JCo installation directory to the dynamic library path: 
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<sapjco_install_dir>
export LIBPATH=$LIBPATH:<sapjco_install_dir>
    3. Restart the Dispatcher.
      For assistance, see Restarting the adapter service.
      Note: These steps ensure that the sapjco3 libraries are included in the executable path and in the loadable library path, when required. The environment variable for dynamic library path and the command for restarting the Dispatcher might vary on different UNIX operation systems.
  • Linux on System z 64-bit architecture (s390x)
    1. Create a symbolic link to the sapjco3.jar file in ITDI_HOME/jars/3rdparty/others: 
      ln -s <sapjco_install_dir>/sapjco3.jar  
   ITDI_HOME/jars/3rdparty/others/sapjco3.jar
    2. Add the SAP JCo installation directory to the dynamic library path: 
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<sapjco_install_dir>
export LIBPATH=$LIBPATH:<sapjco_install_dir>
    3. SAP JCo is supported on Linux on System z only for 64-bit architecture. The IBM Security Directory Integrator is packaged only with the 31-bit version of Java. Additionally, it must be configured to run with the 64-bit version of Java.
      The following steps change the JVM for the complete IBM Security Directory Integrator instance, not only for the Dispatcher.
      1. Stop the Dispatcher: 
        /etc/init.d/ITIMAd stop
      2. Install the IBM® Java 1.5 64-bit release (for example ibm-java2-s390x-5.0.9.rpm)
    4. Change the IBM Security Directory Integrator JRE to become 64 bit: 
      mv  ITDI_HOME/jvm/jre ITDI_HOME/jvm/jre32
ln -s JAVA_1.5_64BIT_HOME/jre ITDI_HOME/jvm/jre
    5. Start the Dispatcher: 
      /etc/init.d/ITIMAd start