Database configuration for a Directory Server instance

To use an instance as a Directory Server and store directory data, you must configure a DB2® database for the instance.

Use the idscfgdb virtual appliance command, to create and configure a DB2 database.

To use this command, you must log in to the virtual appliance command-line interface. See Virtual appliance commands for Directory Server.

Before you configure a DB2 database for a Directory Server instance, the following requirements must be met.

Do not set the DB2COMM environment variable when you configure a database.
Stop the Directory Server.
A system user ID must exist to own the DB2 database instance.

You can run the idscfgdb command to complete the following operations:

Create and configure a database to a Directory Server instance. Create local loopback settings, if they do not exist.
Add information about the database to the ibmslapd.conf file of the Directory Server instance.

You can specify whether to create the database as a local code page database or as a UTF-8 database, which is the default.

For example, assume that you want to configure a DB2 database to a Directory Server instance with the following values:

Instance name: ldapdb
Database name: ldapdb
DB2 database administrator ID: ldapdb
DB2 database administrator password: ldapdb123
Database location: /home/ldapdb

Run the following command:

idscfgdb -I ldapdb -a ldapdb -w ldapdb123 -t ldapdb
-l /home/ldapdb

When you configure a DB2 database for an instance, the configuration file of the instance is updated with the DB2 database information. The tool also creates database and local loopback settings.

You can specify whether to create the database as a local code page database or as a UTF-8 database. The default code page that is used for DB2 database creation is UTF-8.

After you configure a database, you must complete the following configurations for an instance:

Configure primary administrator DN and password.
Configure the required suffixes.