Tivoli Directory Integrator, Version 7.1.1

Component Suite Installation

This section describes the software requirements and installation steps for the IBM® Tivoli® Directory Integrator Component Suite for SAP ABAP Application Server.

This chapter contains the following sub-sections:

Software Requirements

Installing IBM Tivoli Directory Integrator 7.1.1 also installs the Component Suite. However, to complete the install of the Component Suite, an additional component must be added on the target machine:

The IBM Tivoli Directory Integrator Component Suite for SAP ABAP Application Server is supported on the operating systems platforms that are common for IBM Tivoli Directory Integrator and SAP JCo. Please see the IBM Tivoli Directory Integrator Administrators Guide for supported operating system platforms supported by IBM Tivoli Directory Integrator and please see the SAP website for information about supported platforms for SAP JCo. SAP JCo has other prerequisites, including the following:

Windows
The SAP JCo libraries require the MS 8.0 C/C++ runtime. See SAP Note 684106 for instructions. As a workaround msvcr71.dll, msvcp71.dll, mfc71.dll, mfc71u.dll etc may be copied from other Windows computers (32 and 64-bit versions of the DLLs are available, the version you need to copy must match the version of the SAP DLLs you have.)
Linux
The latest versions of libstdc++, libgcc, and compat-libstdc++ may be required. Information related to C++ Runtime 6.0 (libstdc++.so.6) can be found in SAP Note 1021236.

Licensed SAP ABAP Application Server customers can download the JCo from the SAP Website. You will require a valid SAP support login account and password, which can be obtained by request from SAP support. A supported version of SAP ABAP Application Server must also be installed and running on a node within the network environment. TCP/IP network connectivity is required between the SAP ABAP Application Server instance and the machine hosting the IBM Tivoli Directory Integrator Component Suite for SAP ABAP Application Server.

Supported versions of SAP ABAP Application Server are:

Configuring the SAP Java Connector

Once downloaded and available on the machine designated to host IBM Tivoli Directory Integrator and the Component Suite for SAP ABAP Application Server, the JCo can be installed and configured for IBM Tivoli Directory Integrator 7.1.1 as follows:

  1. Unzip the JCo distribution package to a directory on the target machine. For example: 
    /SapJco216
  2. Open the installation.html file and follow the installation instructions for your Operating System. For example: 
    /SapJco216/docs/jco/installation.html
  3. Add the following entries to your network service file: - where NN is the SAP instance identifier of the SAP system to which the IBM Tivoli Directory Integrator Component Suite for SAP ABAP Application Server will connect.
  4. Copy sapjco.jar from the SAP JCo package directory to the Tivoli Directory Integrator_HOME/jars folder.
  5. If you intend to use the ALE Intermediate Document (IDOC) Connector for SAP ABAP Application Server and SAP ERP, you need to copy sapidoc.jar and sapidocjco.jar to the same location as well.
  6. On Windows machines only, copy librfc32.dll and sapjcorfc.dll to the Tivoli Directory Integrator_HOME/libs folder.
Notes:
  1. The network service file can be found at %system_root%\system32\drivers\etc\services on Windows 32, or /etc/services on UNIX.
  2. Before using the IBM Tivoli Directory Integrator Component Suite for SAP ABAP Application Server, ensure that the sapjco.jar is in the CLASSPATH, and that sapjcorfc.{dll/so} and librfc*.{dll/so} are in the loadable library path.

Verifying the Component Suite for SAP ABAP Application Server

To verify the IBM Tivoli Directory Integrator 7.1.1 Component Suite for SAP ABAP Application Server:

Table 49 below describes the files and locations installed by the system installer for IBM Tivoli Directory Integrator 7.1.1, with regards to the Components Suite.

Table 49. Installed locations for the IBM Tivoli Directory Integrator Component Suite
Filename Description
SapR3BorConnector.jar Tivoli Directory Integrator_HOME/jars/connectors
SapR3UserConnector.jar Tivoli Directory Integrator_HOME/jars/connectors
SapR3RfcFC.jar Tivoli Directory Integrator_HOME/jars/functions
index.html (Javadoc for all SAP Components) Tivoli Directory Integrator_HOME/docs/api/
bapi_user_actgroups_assign.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_actgroups_delete.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_change.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_create.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_delete.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_getdetail_postcall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_getdetail_precall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_getlist_postcall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_getlist_precall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_profiles_assign.xsl Tivoli Directory Integrator_HOME/xsl
bapi_user_profiles_delete.xsl Tivoli Directory Integrator_HOME/xsl
bapi_employee_dequeue.xsl Tivoli Directory Integrator_HOME/xsl
bapi_employee_enqueue.xsl Tivoli Directory Integrator_HOME/xsl
bapi_employee_getdata_postcall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_employee_getdata_precall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_persdata_change.xsl Tivoli Directory Integrator_HOME/xsl
bapi_persdata_create.xsl Tivoli Directory Integrator_HOME/xsl
bapi_persdata_delete.xsl Tivoli Directory Integrator_HOME/xsl
bapi_persdata_getdetail_postcall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_persdata_getdetail_precall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_persdata_getdetailedlist_postcall.xsl Tivoli Directory Integrator_HOME/xsl
bapi_persdata_getdetailedlist_precall.xsl Tivoli Directory Integrator_HOME/xsl
Note:
The Connectors rely on the XSL stylesheets to perform their operations and by default the Connectors will locate the stylesheets by using a relative path, for example, xsl/bapi_user_getlist_precall.xsl . It is important to be aware of this default reliance on using a relative path if you are using a Tivoli Directory Integrator Solution directory. As a result, you will need to do one of the following:
  1. Copy the TDI_install_dir/xsl folder into your Tivoli Directory Integrator Solution directory.
  2. Set your Solution directory to be the Tivoli Directory Integrator install directory.
  3. Elect not to configure a Solution directory.
If the XSL folder is not available in the Tivoli Directory Integrator Solution directory then an error similar to the following will result when attempting to use the SAP Connectors: 
com.ibm.di.connector.sapr3.user.UserRegistryConnectorException: CTGDIK019E The Connector detected an
 exception during initialization. The message is: 'CTGDIK008E The configured XSL file named
 'xsl/bapi_user_getdetail_precall.xsl' does not exist.'.

Checking the Version Numbers

To check the component software version numbers for this integration package:

  1. Start IBM Tivoli Directory Integrator and click on Help
  2. Select About IBM Tivoli Directory Integrator Components.
  3. Version numbers are displayed for the following components:

Uninstallation

To remove the IBM Tivoli Directory Integrator the Component Suite for SAP ABAP Application Server from the target system:

  1. Stop IBM Tivoli Directory Integrator assembly lines that are currently running and using one of the IBM Tivoli Directory Integrator Components for SAP ABAP Application Server.
  2. Run the uninstall executable located at Tivoli Directory Integrator_HOME/_uninstsap and follow the prompts.
  3. Remove the following entries from your network service file (%system_root%\system32\drivers\etc\services on Windows 32, /etc/services on UNIX): - where NN is the SAP instance identifier of the SAP system to which the IBM Tivoli Directory Integrator Component Suite for SAP ABAP Application Server connects.
  4. Remove the SAP JCo (SAP_JCO_HOME) directory that was created during the installation.
  5. Remove the environment variable entries and additions that were created during installation as a result of following the instructions within SAP_JCO_HOME/docs/jco/installation.html.
  6. Remove sapjco.jar from the TDI_install_dir/jars folder.
  7. On Windows machines only, remove the librfc32.dll and sapjcorfc.dll files from the Tivoli Directory Integrator_HOME/libs folder.
[ Top of Page | Previous Page | Next Page | Contents | Terms of use | Feedback ]
(C) Copyright IBM Corporation, 2003, 2012. All Rights Reserved.
IBM Tivoli Directory Integrator 7.1.1