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.

Before you begin

Download the SAP Java Connector (JCo).
The adapter requires access to the SAP Java Connector (JCo) API at run time. This API must be downloaded from the SAP support portal. Access to this website requires authentication with a valid SAP support ID (S-ID). Contact your SAP marketing representative to obtain one of these IDs.
Unpackage the content of the file.

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
```