IBM Telelogic Directory Server User manual

Telelogic Directory Server
Installation Guide
Release 4.3.0.1

Before using this information, be sure to read the general information under Appendix, “Notices”on page 17.
This edition applies to VERSION 4.3.0.1, Telelogic Directory Server and to all subsequent releases and
modifications until otherwise indicated in new editions.
© Copyright IBM Corporation 2006, 2008
US Government Users Restricted Rights—Use, duplication or disclosure restricted by GSA ADP Schedule
Contract with IBM Corp.

Telelogic Directory Server Patch Installation Guide iii
Table of contents
About this manual 1
Contacting IBM Rational Software Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Conventions used in this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Installing TDS patch 5
Operating system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
What errors are fixed for Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Patch installation on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
What errors are fixed for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Patch installation on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Appendix A: Notices 17
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Index 21

iv Telelogic Directory Server Patch Installation Guide

Telelogic Directory Server Patch Installation Guide 1
1About this manual
This manual contains details about the Telelogic®Directory Server™(TDS) patch
installation.
It contains the following sections:
•TDS documentation
•Contacting IBM Rational Software Support
•Conventions used in this guide
TDS documentation
This section provides the information on the related documents available for
TDS. The following TDS documents are available on the Product Support Web
site, https://support.telelogic.com
Document name Description
Telelogic Directory Server
Installation Guide
Provides information about installing TDS.
Telelogic Directory Server Product
Manual
Provides detailed information about TDS
features supported in this release.
Telelogic Directory Server
Administration Manual
Provides information about TDS
administration.

Chapter 1: About this manual
2 Telelogic Directory Server Patch Installation Guide
Contacting IBM Rational Software Support
Support and information for Telelogic products is currently being transitioned
from the Telelogic Support site to the IBM Rational Software Support site.
During this transition phase, your product support location depends on your
customer history.
Product support
• If you are a heritage customer, meaning you were a Telelogic customer prior
to November 1, 2008, please visit the http://support.telelogic.com
Telelogic customers will be redirected automatically to the IBM Rational
Software Support site after the product information has been migrated.
• If you are a new Rational customer, meaning you did not have Telelogic-
licensed products prior to November 1, 2008, please visit the IBM Rational
Software Support site.
Before you contact Support, gather the background information that you will
need to describe your problem. When describing a problem to an IBM software
support specialist, be as specific as possible and include all relevant background
information so that the specialist can help you solve the problem efficiently. To
save time, know the answers to these questions:
• What software versions were you running when the problem occurred?
• Do you have logs, traces, or messages that are related to the problem?
• Can you reproduce the problem? If so, what steps do you take to reproduce
it?
• Is there a workaround for the problem? If so, be prepared to describe the
workaround.
Other information
For Rational software product news, events, and other information, visit the IBM
Rational Software Web site.

Telelogic Directory Server Patch Installation Guide 3
Conventions used in this guide
Conventions used in this guide
Typeface Description
Italic Used for book titles and terminology.
Bold Used for items that you can select and menu
paths, also used for emphasis.
Courier Used for commands, file names, and directory
paths. Represents command syntax to be
entered verbatim. Signifies computer output
that displays on-screen.

Chapter 1: About this manual
4 Telelogic Directory Server Patch Installation Guide

Telelogic Directory Server Patch Installation Guide 5
2Installing TDS patch
TDS is a single enterprise directory solution designed for user authentication and
administration for Telelogic® Lifecycle Solution™ (TLS) tools. The TDS allows
the TLS users to log on using the same credentials across TLS tools for which
they have authorized access.
This chapter provides the instructions on how to install the patch for Telelogic®
Directory Server™(TDS) on Linux and Windows. The patch installation contains
the fixes for the specific Linux and Windows errors.
It chapter contains the following sections:
•Operating system requirements
•What errors are fixed for Linux
•Patch installation on Linux
•What errors are fixed for Windows
•Patch installation on Windows
Operating system requirements
For information on operating system requirements, see the platform specific
Telelogic Directory Server Installation Guide. You can find the documents on Product
Support Web site, https://support.telelogic.com.
What errors are fixed for Linux
With existing TDS 4.3 installation, the server does not startup on Linux. The
current installer fails with the following error:
“GLPCOM012E Failed to load plugin from /opt/ibm/ldap/V6.1/
lib64/TDSPlugins/tdssasl-linux.so.”
The TDS 4.3.0.1 patch installation fixes this error and enables the system to
startup automatically after the successful installation.

Chapter 2: Installing TDS patch
6 Telelogic Directory Server Patch Installation Guide
Patch installation on Linux
The patch must be installed on top of the existing TDS 4.3 release. This patch is
intended for Red Hat Enterprise Linux 4, 64 bit operating system only.
Note This patch must be installed only when you get the error
similar to the one given in the What errors are fixed for Linux
section.
To install the TDS patch, do the following:
1. Make sure that you have the TDS 4.3 installed on your machine.
2. Go to the install directory and set the execute permission to TDS.bin
chmod +x TDS.bin
Skip this step for CD and DVD installation.
3. The root user should have write permission to the below directories:
$ /usr/local/bin
$ /opt
The directories should not be NFS enabled.
4. In the install directory, type ./TDS.bin and press Enter.
The Introduction dialog box appears.

Telelogic Directory Server Patch Installation Guide 7
Patch installation on Linux
5. Click Next.
6. The License Agreement dialog box appears. You can save the licence
details in a document.
To copy the license information:
• Right-click the license window and click Select All, and then click Copy.
• Open any file, paste the license information and save the file.
7. Review and click I accept the terms of the license agreement.
8. Click Next.
The Pre-Installation Summary dialog box appears. This dialog box shows
the installation summary.

Chapter 2: Installing TDS patch
8 Telelogic Directory Server Patch Installation Guide
9. Review the information, and then click Install.
The Install Complete dialog box appears if the installation is successful.

Telelogic Directory Server Patch Installation Guide 9
Patch installation on Linux
10. Click Done to exit the installer.

Chapter 2: Installing TDS patch
10 Telelogic Directory Server Patch Installation Guide
What errors are fixed for Windows
The current TDS patch release provides the solution for the following errors.
1. The existing TDS 4.3 installer does not display the user name as First Name
and Last Name for Japanese localization. The current patch installation fixes
this error by displaying the user name as First Name Last Name (E.g. John
Smith).
2. To ensure the data security, certain vital information is prevented from
writing into the ibmslapd.log file. This patch provides enhanced data
security by further strengthening the security vulnerability.
Patch installation on Windows
The patch must be installed on top of the existing TDS 4.3 release.
To install the TDS patch, do the following:
1. Open the <TDS Image>\Install folder and double-click the TDS.exe.
The Introduction dialog box appears.
2. Click Next. The License Agreement dialog box appears.

Telelogic Directory Server Patch Installation Guide 11
Patch installation on Windows
3. You can save the licence details in a document.
To copy the license information:
• Right click on the licence window and click Select All, and then click
Copy.
• Open any file, paste the license information and save the file.
4. Review and click I accept the terms of the license agreement.

Chapter 2: Installing TDS patch
12 Telelogic Directory Server Patch Installation Guide
5. Click Next.
The Telelogic Directory Server Configuration dialog box appears. This
defines the configuration settings for the TDS.
6. Type the directory server configuration properties.
The field description and the value to be entered in each field is explained in the
following table.
Field Name Description Values
Host Name The host name of the
computer.
By default, the installer uses
the valid computer name. Use
the default value provided by
the installer or enter a valid
computer name in this field.
Directory Server
Port
The port number of the
directory server.
By default, the installer uses
the LDAP server port
number “1389”. Use the
default value provided by the
installer or enter the valid port
number for the computer in
this field.

Telelogic Directory Server Patch Installation Guide 13
Patch installation on Windows
7. Click Next. Type the Directory Administrator User password.
The field description and the value to be entered in each field is explained in the
following table:.
Field Name Description Values
Telelogic
Directory Server
Administrator
The admin user for the
TDS.
The TDS administrator ID is
set by default. The
administrator ID cannot be
modified.
Administrator
Password
The password for TDS
admin user.
Type the administrator
password. Password must
contain the following:
• Password must be of
minimum 8 characters in
length.
• Password must contain 1
upper case character, and 3
special characters.

Chapter 2: Installing TDS patch
14 Telelogic Directory Server Patch Installation Guide
8. Click Next.
The Pre-Installation Summary dialog box appears. This dialog box shows
the installation summary.
9. Review the information, and then click Install.
The Install Complete dialog box appears if the installation is successful.
Confirm
Password
This describes the
password
authentication for the
TDS admin user.
Re-enter the password in this
field. Both passwords should
match for the installation to
continue.
Field Name Description Values

Telelogic Directory Server Patch Installation Guide 15
Patch installation on Windows
10. Click Done to exit the installer.

Chapter 2: Installing TDS patch
16 Telelogic Directory Server Patch Installation Guide