Installing or Updating using the Eclipse Update Manager

The Tivoli® Directory Integrator Rich Client Platform contains a complete runtime environment to run the Tivoli Directory Integrator CE. However, it is possible to install the Tivoli Directory Integrator Eclipse plug-in into an existing Eclipse installation. This is done using the Eclipse Update Manager. In Eclipse, open the Eclipse Update Manager through the Help menu.

Before you have the Tivoli Directory Integrator plug-in installed you will want to add a new update site. Choose the Add Site... button and specify the location of the update site.

Depending on the location of the update site choose the appropriate action. In this example we choose a directory on the local file system. Using the Local button you are prompted to choose a directory which is then filled into the location input field. When you press OK the new update site and updates should be available:

Check the plug-ins you want to install and press Install. As the software update manager updates your installation you may be prompted to confirm the installation and you are also usually encouraged to restart the workbench after installation. After installation is complete you should see Tivoli Directory Integrator in the Installed Software tab.

Post-installation steps

When the CE is installed as a plug-in in another Eclipse installation like in the procedure described above, a number of specific properties must be set to include the TDI loader. The Tivoli Directory Integrator loader is an org.eclipse.osgi fragment that provides class loading for the CE.

# TDI class loader
osgi.framework.extensions=com.ibm.tdi.loader
osgi.hook.configurators.include=com.ibm.tdi.loader.TDIClassLoaderHook
TDI_HOME_DIR=c\:/Program Files/IBM/TDI/V7.1.1

Note that the property TDI_HOME_DIR needs to point to an existing Tivoli Directory Integrator Server installation, since the CE must be able to query many Tivoli Directory Integrator component Java classes in order to work correctly. This installation is also used to create the local development server that the CE uses. The fragment above shows the installation default for Windows; update this to reflect your environment.

There are several ways to set these properties. One is to update the configuration/config.ini file of the Eclipse installation.