Tivoli Directory Integrator (TDI) 6.1.1 is a powerful interface engine for the manipulating and transferring of data. It is not only for moving data between directory servers such as IBM's Tivoli Directory Server (TDS), Sun Mocrosystem's iPlanet Directory Server, and Microsoft's Active Directory. It can also be used in conjuntcion with databases and files such as XML and LDIF. There are also many other sources and destinations not mentioned here. In this article we will walk you through the installation process for TDI 6.1.1 and IBM's Fix Pack 2. Once again, installing an IBM product via Java is a bit frustrating, but we have managed to make it happen. In future articles we will demonstrate how to use TDI effectively with specific examples like populating TDS from Active Directory.


Article Index

• Background
• Assumptions / Requirements
• Procedure
• Intstall TDI 6.1.1
• Install Fix Pack 2
• Verify The Installation
• Conclusion
• Printing

Although we have posted no articles (yet) on the topic of data interfacing, we have quite a bit of experience with it, especially with HL7. This time around however, we have a current need to (1) populate a Tivoli Directory Server (TDS) instance with data from Active Directory, and (2) using a change log connector on the AD side, replicate changes from AD to the same TDS instance. While we will not demonstrate how to build these interfaces in this exercise, we will do so in future offerings. TDI can be installed on many platforms including Linux and AIX, and we have done so, but for mobility we also need it installed on Windows XP. Stick around and we'll show you how.

The process of installing TDI 6.1.1 and the fixk pack is not exactly rocket science, so we will not expect any particular amount of specific expertise. However, basic Microsoft Windows XP experience is a definite plus.

As for specific requirements, they are as follows:

• A PC runing Microsoft Windows XP SP2, and patched to current levels.
• The TDI 6.1.1 For Windows media downloaded and expanded. The media we doanloaded had C9666ML associated with it.
• The IBM TDI 6.1.1 Fix Pack 2 downloaded and expanded.

Now that we have laid the groundwork, let's get going with the actual steps.

Navigate to where you have expanded the TDI media, and run launchpad.exe as shown here.

You may or may not see the following security warning. If you do, click Run to continue.

Check out your options here at the main installer menu. To proceed with the installation click, on the left panel, Install IBM Tivoli Directory Integrator

When the following screen appears, begin the installation by clicking, on the right panel, IBM Tivoli Directory Integrator 6.1.1 Installer.

As this slow process continues, you should see the following:

And the following:

And the following:

Here, click Next to continue as shown below.

Accept the license agreement and click Next to confinue.

As the installer checks things out on your PC, you should see the following:

Decision time; and I don't know about you but we ALWAYS choose custom installs on all Microsoft systems. It is always good to see what the installer plans to install, just in case there is something you do not wish to install. Click Next to continue.

Accept the default path as we have done, or change it to whatever you like. Then click Next to continue.

In this case we do want to install everything, so simply click Next to continue.

If you are installing TDI on a multi-user system we might want something other than the default here. However, for the most part, Windows XP is a single user system and we might as well keep our creations in our home directory. Click Next to continue.

Another informational screen here:

Last chance to make installation changes here. If ready, pull the trigger by clicking Install.

More informational stuff here:

When we see the following screen, installation of TDI 6.1.1 was successful.

Once we are brought back to the initial install screen, click Exit, on the left panel, to continue.

Click OK to confirm that we really want to exit.

To install a fix pack, find gmi.cmd, as shown below, and execute it.

What a shocker; another Java installer. Click Next to proceed.

The default action is to install a maintenance pack. Take it and click Next to continue.

The installer identifies what prducts are installed. In our case it is easy. In any case, select TDI and click Next to continue.

This would not be an IBM installation without a little confusion, so let's start it here. As we see, the installer cannot find any fix packs to install, so it needs help. We click Edit to tell the installer the location of the fix pack.

Bravo IBM! Excellent error message here. I could ramble on about how IBM thinks that they do everything better than anyone else, but I will not. Simply click Continue to proceed.

Somehow this brings us beyond the error message. We need to select the location of the fix pack.

So drill down to the fix pack location and be sure to click the "Include subdirectories" check box at the bottom of the screen. By the way, this seemed to be incredibly slow and required much patience.

The installer found the fix pack. Click Next to continue.

Another informational display:

Select the package to install, and click Next to proceed.

Take the default action as shown here and click Next to continue.

Last chance to stop this upgrade. If ready, click Install to continue.

If you see the folowing screen, the fix pack installed sucessfully. Click Next to continue.

Start TDI. You will see the following splash screen.

The following should only appear once per system install. Click Yes to continue.

Not sure what this indicates, but it seems harmless enough. Dont you just love Java error messages?

If you have come this far successfully, you have verified everything. The following screen is the TDI IDE. We will go into the IDE in detail in later articles.

We have now completed the installation of TDI and FiX Pack 2. As always, IBM just has to make it interesting with Java instalation errors. These errors surely seem to be the results of rookie programming and poor quality assurance. Leave it to IBM; at least the product seems to work normally after the installation.

If you have trouble printing this article, be sure to set your browser Page Properties correctly. Go to File -> Page Setup and set your left and right margins to .125 inches.