In IBM TDI 7.1 there is a mechanism that allows multiple TDI server instances to be registered as Windows services. Each instance requires a separate solution directory. After creating a solution directory, a utility program should be copied in it. The name of the program is ibmdiservice.exe. The configuration of the utility program and the Windows service is made with a properties file named ibmdiservice.props. Each solution directory should contain a configuration properties file.
Each Windows service must have a different name. A property called "servicename" in the property file specifies a name that is used in creation of the Windows service name and the Windows service display name. The Windows service name is formed by prefixing the value of the "servicename" property with the "ibmdisrv-" prefix. The Windows service display name is formed by inserting the value of the "servicename" property between the brackets of "IBM Tivoli Directory Integrator ()". For example if the "servicename" property is set to "test" the Windows service name is "ibmdisrv-test" and the Windows service display name is "IBM TDI (test)". If the "servicename" property is not present or has no value default names are used. The default names for the Windows service name and the Windows service display name are "ibmdisrv" and "IBM TDI".
A property exists so it can be configured whether the Windows service is started automatically on Windows startup or has to be started manually. The name of the property is "autostart" and the valid values for it are "true" and "false".
This property is used during installation and uninstallation as well as while the service is running. That is why the property value must not be changed after the Windows service has been installed.
For more information about the TDI Windows service configuration properties file see the "Configuring the service" section.
Do the following to install the IBM TDI service:
ibmdiservice.exe -i
In order to use the TDI 7.1 version of the "ibmdiservice.exe" utility program any registered pre-TDI 7.1 Windows service must be uninstalled and then the TDI 7.1 windows service must be installed. This is necessary because the TDI 7.1 windows service uses a different default name for the Windows service name - "ibmdisrv" as opposed to the pre-TDI 7.1 default name of "IBM TDI".
Do the following to uninstall the IBM TDI service:
ibmdiservice.exe -u
Notes:
The IBM TDI service automatically starts the IBM TDI at system boot. The IBM TDI is not, however, automatically started when the service is installed. After installing the service we have three options to start the service:
We can manually start and stop the IBM TDI service from the Windows Services window.
In the Services window select the service IBM TDI and, depending on the Windows version, either click the Start/Stop button, or right-click on the service name and select Start/Stop.
We can also use the command line; see Command line support.
By default, the IBM TDI service is configured to start automatically on system boot.
We can manually change the service startup mode from the Windows Services window to Manual or Disabled.
The IBM TDI service logs all messages (error, info and debug) in the Application Windows system log. We can view these messages with the Windows Event Viewer.
The IBM TDI service is configured through the ibmdiservice.props file placed in the solution folder chosen during installation of the log service.
Before running the service, make sure this file is properly configured as described in this section. The service could fail if the file contains incorrect values.
The following properties are specified in the ibmdiservice.props file:
One such option could be the -c option; here you could specify multiple config files (separated by commas), something which is not allowed by the configfile parameter.This is an optional property.
For example, if the property value is "test" the Windows service name will be "ibmdisrv-test" and the Windows service display name will be "IBM TDI (test)". If the servicename property is not present or has no value, default names are used. The default Windows service name is "ibmdisrv" and the default Windows service display name is "IBM TDI".
This property is used during installation and uninstallation as well as while the service is running. That is why the property value must not be changed after the Windows service has been installed.
This property is used during Windows service installation and changing it after the Windows service has been installed has no effect.
When specifying properties in the configuration file, specify each property on a single line and use the following format:
<property_name>=<property_value>There must be no spaces around the equals ( = ) sign.
An example of a completed ibmdiservice.props file looks like the following:
path=C:\Program Files\IBM\TDI\V7.1\jvm\jre\bin; C:\Program Files\IBM\TDI\V7.1\libs; ibmdiroot=C:\Program Files\IBM\TDI\V7.1 configfile=rs.xml assemblylines=AssemblyLine1,AssemblyLine2 cmdoptions=-d debug=false controlledshutdown=false
If you change any of the properties in ibmdiservice.props, restart the service for the changes to take effect.