This section describes how to install IBM Tivoli Directory Integrator (TDI) to support the integration of Tivoli Service Request Manager with certain products.
IBM Tivoli Directory Integrator (TDI) manages the technicalities of connecting to and interacting with the various data sources that you want to integrate,
abstracting away the details of their APIs, transports, protocols and formats. Tivoli Directory Integrator is used to support the integration of the Service Desk
component of Tivoli Service Request Manager with the following products:
v IBM Tivoli Enterprise Console v HP-Peregrine
Tivoli Directory Integrator manages the data flow between one or more Service Request Manager servers and one or more application servers (for example, TEC servers or HP-Pereguine servers).
While a single TDI server can support the workload of synchronizing data between multiple sources, it is a best practice to install multiple TDI servers for failover purposes. With multiple TDI servers, a failure of one server does not interrupt the availability of data.
Use the procedure described in this section rather than the TDI product
documentation to install a TDI environment that supports the integration of Tivoli Service Request Manager with the products shown in the preceding list. For general information about IBM Tivoli Directory Integrator, refer to the product documentation at http://publib.boulder.ibm.com/tividd/td/
IBMDirectoryIntegrator6.1.1.html.
Before you install
This topic lists the tasks that you must perform prior to installing Tivoli Directory Integrator.
Before you install Tivoli Directory Integrator, complete the following tasks:
1. Install Tivoli Service Request Manager as described in the Installing IBM Tivoli Service Request Manager Installation Guide. (See the Installing section of this information center.)
2. Configure your Service Request Manager installation as described in the individual product integration sections for IBM Tivoli Enterprise Console and HP-Pereguine.
3. To support TEC integration with Service Desk, the TEC non-TME logfile adapter must be installed on each computer that hosts a TDI server. You can install the logfile adapter before or after you install Tivoli Directory Integrator.
See “Installing the TEC non-TME logfile adapter” on page 13 for more information.
Installing Tivoli Directory Integrator
Complete the following steps to install Tivoli Directory Integrator.
1. Copy the installation files from the IBM Tivoli Service Request Manager Integration Toolkit image to a temporary directory on the computer where you want to install Tivoli Directory Integrator.
The TDI installation files are located in the following directory on the toolkit image or DVD:
/TDI/interp
where interp represents three directories named aix, windows, and linux. Copy the files from the interp directory appropriate for your operating system.
2. At a command prompt, change to the directory where the installation files are located.
3. Run the installation command that is appropriate for your platform:
v Windows®:
installTDI.cmd -silent tdi_home tdi_working_dir″srm_host [srm_host2 srm_host3 ...]″ tec_log_file_adapter_bin Y | N
v Linux®or AIX®:
./installTDI.sh -silent tdi_home tdi_working_dir \″srm_host [srm_host2 srm_host3 ...]\″ tec_log_file_adapter_home Y | N
where:
-silent Specifies to install the product in silent mode, where the installation is performed with no user interaction.
tdi_home
Specifies the directory where you want to install the Tivoli Directory Integrator binary files. Specify any directory. The directory you specify is created for you if it does not exist.
tdi_working_dir
Specifies the directory where you want to install the Tivoli Directory Integrator files required by the products that are supported for
integration with Tivoli Service Request Manager. Specify any directory.
Typically, the working directory is a subdirectory of the tdi_home directory. The directory you specify is created for you if it does not exist.
srm_host [srm_host2 srm_host3 ...]
Specifies the hostname or IP address of one or more servers that host Tivoli Service Request Manager. Specify the fully qualified host name with the HTTP listener port of the supporting application server. (Port number 9080 is typically used for a WebSphere® application server.) Be sure to enclose these arguments in double quotes (″), including the escape character (\) for UNIX®, as shown in the command syntax.
tec_log_file_adapter_bin
Specifies the full directory path where you installed, or plan to install, the TEC non-TME logfile adapter on this computer. The specified file path must include the bin directory, for example, c:\tecwin\bin.
The TEC non-TME logfile adapter supports the integration of Tivoli Service Request Manager with IBM Tivoli Enterprise Console (TEC). If you do not plan to integrate with TEC, or you do not know the location of the TEC logfile adapter, enter any valid character or character string for this parameter. For example, enter a dot (.) or na.
After installation, you can edit a properties file (mxe.properties) on the TDI server to specify the location of the TEC logfile adapter.
Y | N Specifies whether you want to use a common queue in a multiple TDI server environment. The default is Y (yes).
Repeat the preceding steps on each computer where you want to install Tivoli Directory Integrator.
Example 1: The following Windows command specifies that you want the TDI server to connect to two Service Request Manager servers (srmhost1 and srmhost2). No TEC logfile adapter is specified (na).
Example 2: The following UNIX command specifies a single Service Request Manager Server (srmhost) and the location of the TEC logfile adapter on the TDI server.
Configuring rotating log files
TDI log files can increase rapidly in size and therefore become difficult to open or maintain. Use a rotating log strategy to prevent logs from growing to an
unmanageable size.
Complete the following steps to configure rotating log files:
1. Open the log4j.properties file. This file is located in the following directory:
tdi_work/etc
where tdi_work is your TDI working directory (solution directory).
2. Add a comment marker (#) to the beginning of the line beginning with the following string:
log4j.appender.Default=
3. Add the following lines:
log4j.appender.Default=org.apache.log4j.RollingFileAppender log4j.appender.Default.MaxFileSize=max_size
log4j.appender.Default.MaxBackupIndex=max_files where:
max_size is the maximum size of a log file. For example, specify 10KB. (This number must be an integer.)
max_files is the maximum number of backup log files. For example, specify 50.
installTDI.cmd -silent C:\TDI C:\TDI\work "srmhost1.loc.com:9080 srmhost2.loc.com:9080" na Y
./installTDI.sh -silent /opt/TDI /opt/TDI/work \"srmhost.loc.com:9080\" /opt/IBM/Tivoli/tec/nonTME/bin Y