Setting up Tivoli Directory Server - Quick and Easy

Whenever you are setting up a FileNet System you would require a Directory Server as one of the pre-requisite. Normally every large enterprise would already have Directory Server and you just need to have FileNet hooked up to this Server.

But when you are setting up a demo or implementing a solution at a small/medium size customer who are beginning the process of setting up the system, you would end up requiring to install the Directory Server.

IBM Tivoli Directory Server comes bundled with FileNet for using it as a Directory Server. Normally IT staff find it intimidating to setup the Tivoli Directory Server (TDS) just because they have never tried it before and tend to use Active Directory Server in most cases.

Setting up of TDS is quite simple and you should be up and running within 30-40 minutes (atleast for a simple setup). The below procedure shows how to setup TDS and also import users and groups into TDS using a ldif file.

The below procedure is for TDS v6.3 on Linux, but the steps are the same for Windows or AIX and for earlier 6.x version of TDS.

NOTE: There are restriction to the usage of the bundled TDS software, refer to the license document for more details.

Install IBM TDS

Using root, untar the installer file into a temp location

Change directory to tds folder, run the install_tds.bin (In case of Windows, just double click the install_tds.exe file)

 Select the language and click on OK

 

Click Next to start the installation

Read the license and click on I accept if you agree. Click on the Next button to continue with the installation

 If an existing DB2 exists, it should get automatically detected, else a new one would be installed by the installer, click Next

Choose Typical installation and click Next

Click on Install to start the installation

 When prompted for password, enter a suitable password, for the Encryption seed enter a 12 character string, click Next

 Click Finish to complete the installation

TDS Instance Administration Tool should get automatically started up

Create a suffix for the ldap users and groups

Click on the Manage button on the TDS Instance Administration Tool

Select the Manage suffixes and add an entry into Suffix DN, Eg. dc=com and click Add

Click OK and close the window.

Import ldif file to create user an groups

Create a .ldif file as shown below

Sample is shown for a user (aeadmin) and group (aeadmins) creation. The password for the user is 'password' as shown below, change it to a suitable value for your environment.

dn: o=ibm,dc=com

objectclass: organization

objectclass: top

o: ibm

dn: o=ecm,o=ibm,dc=com

objectclass: organization

objectclass: top

o: ecm

dn: cn=aeadmin,o=ecm,o=ibm,dc=com

userpassword: password

objectclass: inetOrgPerson

objectclass: organizationalPerson

objectclass: person

objectclass: top

sn: aeadmin

cn: aeadmin

dn: cn=aeadmins,o=ecm,o=ibm,dc=com

objectclass: groupOfNames

objectclass: top

cn: aeadmins

member: cn=aeadmin,o=ecm,o=ibm,dc=com

Click on the Manage button on the TDS Instance Administration Tool

Select the LDIF tasks and Import LDIF data, choose the ldif file using the Browse button and then click Import.

The import should start and the message would be displayed regarding the import operation.

Start the TDS Server

On the TDS Instance Administration Tool click on the Start/Stop button and click on the Start Server button.

Once started a prompt is shown, click OK

Click Close button on the TDS Instance Administration Tool

Now the TDS service is up and running for use with FileNet or any other system.