Configuring the database with the command line

IBM Tivoli Directory Server, Version 6.3

Configuring the database with the command line

You can use the idscfgdb command to configure a database for a directory server instance.

This command cannot be used for a proxy server instance.

The idsicrt command must have already run successfully to create the database instance. In addition, the database instance owner must be set up correctly. Otherwise, the command fails.

The directory server instance owner specifies a database administrator user ID, a database administrator password, the location to store the database, and the name of the database. The database administrator ID specified must already exist on the system. See Appendix D. Setting up users and groups: directory server instance owner, database instance owner, and database owner for information about requirements for this ID.

By using the -w option, you can reset the password for the database administrator and the change log database owner in the configuration file for the directory server instance.

After successfully creating the database, the command adds information about the database to the ibmslapd.conf file of the directory server instance. The database and local loopback settings are created, if they do not exist. You can specify whether to create the database as a local codepage database or as a UTF-8 database, which is the default.

Attention:

Before configuring the database, be sure that the environment variable DB2COMM is not set.
The server must be stopped before you configure the database.

For example:

To configure a database called ldapdb for directory server instance ldapdb in the location /home/ldapdb with a DB2® database administrator ID of ldapdb whose password is secret, issue the command:

idscfgdb -I ldapdb –a ldapdb –w secret –t ldapdb –l /home/ldapdb

If the password is not specified, you are prompted for the password. The password is not displayed on the command line when you type it.

The previous command configures the database with DMS tablespaces with default sizes.

To configure a database with a DMS tablespace located in a file system and with a specific size for the tablespace, use the following command:

idscfgdb -I ldapinst -a dbadmin -t ldapdb -w password -n -l c:\dblocation 
   -u c:\dblocation\ldapinst\tablespaceloc\USPACE -U 10000 -z 16

In the previous command:

The instance name is ldapinst
The database administrator ID is dbadmin
The database name is ldapdb
The database administrator password is password
The database location is c:\dblocation
The location of the USERSPACE1 tablespace is c:\dblocation\ldapinst\tablespaceloc\USPACE
The container size of the USERSPACE1 tablespaces specified is 10000 pages and the extension size specified is 16 pages.

To configure the same database with SMS tablespaces, use the following command:

 idscfgdb -I ldapinst -a dbadmin -t ldapdb -w password -n -l c:\dblocation -m SMS

Note:

The default minimum disk space requirement for a DMS database is 1 GB. If you have limited disk space and do not plan to have a large directory, configure an SMS database. An SMS database requires a minimum of 150 MB of disk space. These requirements are for an empty database. When you store data in the database, more disk space is required.

See the IBM® Tivoli® Directory Server Version 6.3 Command Reference for detailed information about the idscfgdb command.

[ Top of Page | Previous Page | Next Page ]