Setting up CentOS Directory Server on CentOS 5.4 Linux

UPDATE: The current version of this post is now available in the wiki.  Future updates will only be made to the wiki version.

1. CentOS 5.4 is installed and running properly.  This could be a physical
server or a virtual machine.
2. You have root or sudo access to the server that the directory server is
to be installed on.
3. The server requires a fully qualified domain name.  This is because the
directory server will use the FQDN during it’s setup.
4. Make sure the server has an entry in /etc/hosts.   For example: hostname.domain.tld hostname

Installing the packages
Unlike previous versions, CentOS Directory Server is now in the main
repositories so you no longer need to include the CentOS Extras repository.

1. Install the CentOS Directory Server package and it’s dependencies.
yum install centos-ds

Finalizing the install
Go through the Installation guide, available from RedHat at  Don’t skip reading the Installation Guide or you will end up missing some key information in setting up the directory server.

A few notes:
1) OpenJDK is already installed and configured to be the default Java.
2) Make sure to read section 2.3 of the Installation Guide, Red Hat Enterprise Linux 4 and 5 Requirements.
3) I find that only by skipping step 4 of section of the Installation Guide, do the new open file limits take effect.

All Directory Server manuals are available online at

Setting up Directory Server
1) As root, run the directory server’s setup command

2) The Typical Install, is the most common install option.  It will let you
verify the settings being used, and change them if need be.

Things to take note of during the install.
1) Make sure the Computer Name is correct or later setting will be affected.
2) If the installer is not getting your server’s name correct, check your DNS
settings and /etc/hosts file values.
2) Take note of the admin password, you will need it later.
3) Take note of the Directory Manager password, you will need it later.

Once all the questions have been answered, you’re asked to setup the server.
Say yes. You willnow see the directory server being configured.

Creating directory server . . .
Your new DS instance 'directory' was successfully created.
Creating the configuration directory server . . .
Beginning Admin Server creation . . .
Creating Admin Server files and directories . . .
Updating adm.conf . . .
Updating admpw . . .
Registering admin server with the configuration directory server . . .
Updating adm.conf with information from configuration directory server . . .
Updating the configuration for the httpd engine . . .
Starting admin server . . .
The admin server was successfully started.
Admin server was successfully created, configured, and started.
Exiting . . .
Log file is '/tmp/setupBkwXhD.log'

Accessing the Directory Server

The Management Console is an X-window application for managing the directory server.  It is available at /usr/bin/redhat-idm-console.  Use the “admin” account and the password you gave it.  The value for “Administration URL” is found by running the command:
grep \^Listen /etc/dirsrv/admin-serv/console.conf

Leave a Reply

Your email address will not be published. Required fields are marked *