IBM Tivoli Directory Server, Version 6.3

Appendix J. Updating the ldapdb.properties file

When you create a new full directory server instance, the version of DB2® used to create the instance is determined by the value specified in the ldapdb.properties file in the installpath\etc directory (installpath is the path where you installed Tivoli® Directory Server 6.3). If you install a newer supported DB2 level after installing Tivoli Directory Server and you want a newly created instance to use the new version of DB2, you must update this file.

When a full directory server instance is created, an ldapdb.properties file is also created for that instance. This ldapdb.properties file is stored with the files of the instance.

On Windows systems, the file is X:\idsslapd-instance_name\etc\ldapdb.properties, where X is the drive that you specify during instance creation.
On AIX®, Linux, and Solaris systems, the file is instance_home/idsslapd-instance_name/etc/ldapdb.properties, by default.

If you have installed a newer version of DB2 and migrated your database instance to the newer version, you must update the ldapdb.properties file associated with that instance.

Note:

If you are upgrading from an earlier version of Tivoli Directory Server that also performs an implicit DB2 upgrade, the upgrade makes all necessary updates to the ldapdb.properties file. This information is only for DB2 level changes outside of a Tivoli Directory Server release upgrade.

The ldapdb.properties file has two keywords: currentDB2InstallPath and currentDB2Version. Each keyword is on its own line.

If the example contents of the ldapdb.properties file is as follows (before installing of newer version of DB2):

currentDB2InstallPath=/opt/ibm/db2/V9.1
currentDB2Version=9.1.0

To update the ldapdb.properties file:

Make a backup copy of the current file.
After you have installed the newer version of DB2 (after ensuring that it is supported by Tivoli Directory Server 6.3), migrate the DB2 database associated with the instance using the DB2 instructions.

Go to the directory where the newer version of DB2 is installed and run the db2level command. For example:

# /opt/ibm/db2/V9.7/bin/db2level

Example output is as follows:

DB21085I  Instance "myinst1" uses "64" bits and DB2 code release "SQL09071"
with level identifier "08020107".
Informational tokens are "DB2 v9.7.0.1", "s091114", "IP23035", and Fix Pack
"1".
Product is installed at "/opt/ibm/db2/V9.7".

Update the ldapdb.properties file. Use the "Install Path" information to update the currentDB2InstallPath field, and the "Level" information to update the currentDB2Version field. Using the example, you would change the contents of your ldapdb.properties file to the following:

currentDB2InstallPath=/opt/ibm/db2/V9.7
currentDB2Version=9.7.0.1

[ Top of Page | Previous Page | Next Page ]