Tivoli Directory Integrator, Version 7.1.1

Introducing IBM Tivoli Directory Integrator

This section provides information useful in understanding Tivoli® Directory Integrator essentials, as well as a set of tutorial exercises to give you hands-on experience with the development environment.

Your first step in getting to know the product is to start the Tivoli Directory Integrator development tooling, known as the Configuration Editor, or CE for short.

Figure 1. Starting the Configuration Editor
Starting the Configuration Editor

The first time that you start up the CE, you will see get this dialog for specifying your workspace.

Figure 2. Selecting your workspace
Selecting your workspace

Your workspace is where the Configuration Editor will store your project files, including components and AssemblyLines, and it is typically located under your Solution Directory.

Once you are happy with the location of your workspace press the OK button. Now the Welcome Screen will appear.

Figure 3. Configuration Editor Welcome Screen
Config Editor Welcome Screen

The Welcome screen offers a number of quick-start links1.

Whenever you build, test or modify integration solutions with Tivoli Directory Integrator, you are working within a project. Projects are collections of AssemblyLines and their constituent components, and each project appears in its own sub-folder of your workspace. The AssemblyLines and components that make up a project are stored as individual files, which in turn are located in sub-directories of the project folder.

Select the second link from the top of this page2 (Create Tivoli Directory Integrator Project) to set up your first project. You must now give your new project a name. Call it 'Tutorial' and press Finish.

Figure 4. Naming your new project
Naming your new project

You will now see the main development work area. The panels here can all be resized, and you can decide how the screen is organized. What you see on screen here is the default 'TDI' Perspective3.

Figure 5. Config Editor main screen
Config Editor main screen showing the default TDI Perspective

This is the main screen where you will spend most of your time when working with Tivoli Directory Integrator. Without going into the details of all the navigational elements here4, let's look at the numbered areas highlighted in the above screenshot:

  1. In the middle of the main button row is a set of shortcuts for creating new Projects, and if a Project is selected in the Navigator, for creating new AssemblyLines in it. There is also a button for launching the Tivoli KeyManager tool to work with certificate key- and truststores; as well as a Browse Server Stores button for retrieving the various property settings from the Tivoli Directory Integrator Server associated with this Project.
  2. This is the Navigator panel and provides a tree-view of your development assets. Your new 'Tutorial' Project should appear here.
  3. The Servers panel displays the status of all configured Servers. You can see by the arrow icon next to 'Default.tdiserver' that this Server has been started for you. This panel also provides buttons for defining new Servers, Starting and Stopping your Servers, as well as for refreshing the list and view a Server's log5.

    Note that whenever you launch an AssemblyLine, both the Config Instance6 and the AL also show up in this panel.

  4. Here you will see a set of tabs with the currently selected tab showing console output coming from your Server. The messages displayed here now tell you that your Server is running and that its API is initialized and ready for use.
  5. The gray area in this screenshot is where editor panels appear as you create and open AssemblyLines and components. Each type of resource (Connector, Parser, AssemblyLine, and so forth) has its own specially designed editor.
1 You can return to this screen at any time by selecting Help > Welcome in the Main Menu.
2 The topmost link, Launch EasyETL, opens a simplified workbench and is covered in the appendix, EasyETL Guide.
3 A Perspective is simply an organization of the development environment panels. If you have made changes to layout and want to return to the default TDI Perspective, simply click on Window in the topmost menu and select the Reset Perspective option.
4 As with most Eclipse-based applications, there will be a number of ways to perform the same operation. The IBM® Tivoli Directory Integrator V7.1.1 Users Guide describes all the various options and panels available.
5 If for some reason your server has not been started correctly, open 'TDI Servers' and double-click on 'Default.tdiserver'. This opens up the associated Server Document. Make sure that the Installation and Solution Directory settings are correct and then press the Create Solution Directory option at the top of this panel. If this does not correct the problem, then contact support.
6 Whenever the Tivoli Directory Integrator Server loads a Config, it creates a Config Instance that encapsulates the AssemblyLines of that project and allows these to run in their own contained environment. This means that you can load the same Config multiple times on the same Server, resulting in separate Config Instances all containing the same set of ALs without these interfering with each other.

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