Tivoli Directory Integrator, Version 7.1.1


This book is a simple introduction to a simple system. Make no mistake; the word simple is used here in its most positive and powerful context, because the best way to wrap your mind around a complex problem is to simplify it; Break it down into more manageable pieces and then master those constituent parts. Divide and conquer. This is a technique you instinctively use to solve everyday problems, and which is equally relevant for engineering information exchange across an office, an enterprise or the globe.

If you are impatient to quickly start extracting information from files, directories, databases or Lotus Notes and transferring this data someplace else then you may want to skip directly to the appendix, EasyETL Guide. This feature lets you harness the power of IBM® Tivoli® Directory Integrator without having to first learn core concepts. Instead you choose your source and target, and then press Run and watch your data flow. If on the other hand you want more control over how data is read, filtered, enriched, transformed and moved then continue reading here; EasyETL Guide will still be there for your future reading pleasure.

IBM Tivoli Directory Integrator1 is designed and built on the premise that even the most complex integration problems can be decomposed down into three basic parts:

With IBM Tivoli Directory Integrator you translate this atomic understanding of the integration problem directly into a solution, building it incrementally, one flow at a time, with continuous feedback and verification. This approach makes integration projects easier to estimate and plan, sometimes reducing this effort to the counting and costing the individual data flows to be implemented. Completing a task in runnable steps also allows you to regularly demonstrate progress to stakeholders.

IBM Tivoli Directory Integrator further accelerates development by abstracting away the technical differences between your data sources, allowing you to spend more time concentrating on the business requirements.

Leveraging the power of Eclipse, the IBM Tivoli Directory Integrator development environment is both comprehensive and extensible. Integration projects result in libraries of components and business logic that can be quickly reused to address new challenges. As a result, teams across your organization can share IBM Tivoli Directory Integrator assets, resulting in independent projects – even point solutions – that immediately fit into a coherently integrated and managed infrastructure.

This document gives you an introduction to the simplify and solve methodology described above. You will also take your first steps toward tapping into the elegant simplicity of the Tivoli Directory Integrator toolset, specifically these two programs:

You will assemble your Tivoli Directory Integrator solutions with the CE, while one or more Servers are used to power them. These programs work in concert, making the user experience seamless, and even allowing you to work across platforms; for example, developing on your laptop while testing and debugging solutions running remotely on a mainframe.

Scripting in JavaScript

As mentioned above, IBM Tivoli Directory Integrator lets you rapidly assemble integration solutions. However, in order to extend built-in automated functionality with your own custom processing and flow behavior, you will need to write snippets of script.
Scripting is done in JavaScript, and Tivoli Directory Integrator includes the IBM JSEngine to provide a fast, reliable scripting environment. As a result, you will need to use and understand the core JavaScript language. There are several good online and hardcopy resources for learning JavaScript. Check the Tivoli Directory Integrator newsgroups and websites for recommendations and links.
For more information about scripting in IBM Tivoli Directory Integrator, see the IBM Tivoli Directory Integrator V7.1.1 Users Guide.

Installing IBM Tivoli Directory Integrator

Tivoli Directory Integrator installs in a few minutes and you can begin building, testing and deploying solutions immediately. It runs on a wide variety of platforms, including Microsoft Windows, IBM AIX®, IBM System z®, and a number of UNIX and Linux environments.
There are three paths of interest when installing Tivoli Directory Integrator, and the installer will ask you to specify the first two:
  1. The Installation Directory, where the program files are kept, along with the batch-files or scripts used to launch the various tools.
  2. The Solution Directory, often abbreviated 'SolDir', which is the current folder whenever you run Tivoli Directory Integrator. You will notice that the startup batch-files and scripts for the Config Editor development environment (ibmditk) and the Server (ibmdisrv) both start with a command to change directory to the Solution Directory. As a result, all relative paths used in your solution will be expanded from your Solution Directory.
  3. The workspace folder. This is where your project and resource2 files are kept. This will default to a folder named "workspace" in your Solution Directory.

For more information about installing the Tivoli Directory Integrator, see "Tivoli Directory Integrator installation instructions" in the IBM Tivoli Directory Integrator V7.1.1 Installation and Administrator Guide.

Installing the tutorial files

The tutorial exercises in this book require supporting data files that are located in the examples/Tutorial sub-folder of the Tivoli Directory Integrator installation directory. For example, a standard Windows installation would place these files in the following directory:
C:\Program Files\IBM\TDI\V7.1.1\examples\Tutorial
The 'Tutorial' directory should contain the following files:
Note: As mentioned in the previous section, the installer will ask you to specify the location of your Solution Directory. This is where your project and resource files will be stored, and it will typically be a sub-directory called My Documents\TDI under your home area.

Copy the Tutorial folder to your Solution Directory in order to make it more readily accessible from the Configuration Editor tooling.

1 Don't let the name fool you; Tivoli Directory Integrator is not limited to directory work, and supports all major data stores, transports, protocols and APIs – including of course LDAP directories.
2 These terms are explained in Introducing IBM Tivoli Directory Integrator

[ Terms of use | Feedback ]
(C) Copyright IBM Corporation, 2003, 2012. All Rights Reserved.
IBM Tivoli Directory Integrator 7.1.1