Red Hat Directory Server B.08.00.02 for HP-UX Release Notes and Supplemental Instructions

4 Setting Up Red Hat Directory Server 8.0
This chapter describes how to set up and configure Red Hat Directory Server 8.0.
4.1 Overview
If this is a new installation, use one of the following setup scripts to configure Red Hat Directory
Server 8.0:
• /opt/dirsrv/sbin/setup-ds-admin.pl
The setup-ds-admin.pl script creates a Directory Server instance that is managed by
the centralized administrative framework. The dialog includes prompts for information
about the Administration Server and information used to register the new Directory Server
with a Configuration Directory Server. It also enables you to create a Configuration Directory
Server.
This script is similar to the setup script provided in previous Directory Server products.
• /opt/dirsrv/sbin/setup-ds.pl
The setup-ds.pl script creates a standalone Directory Server instance. This script is similar
to the setup-ds-admin.pl script, except it does not prompt for information about the
Administration Server or Configuration Directory Server.
IMPORTANT: If you are migrating an existing Directory Server installation to Red Hat Directory
Server 8.0, use the migrate-ds-admin.pl or migrate-ds.pl script as described in Chapter 6
(page 35). Do not use the setup-ds-admin.pl or setup-ds.pl script.
4.1.1 IP Address and DNS Requirements
Before you run a Directory Server setup script, the system must meet the following requirements
for IP address and DNS configuration:
• The system must have a static IP address.
• The target system must be configured to use DNS to resolve host names and IP addresses.
The target system must have a hostname and domain name configured. The setup scripts
fail if they cannot determine the local host name or domain name, or if they cannot resolve
the host name to an IP address. The domain name must be configured in the /etc/
resolv.conf file.
4.1.2 Keeping a Response File (-k Option)
The setup-ds-admin and setup-ds.pl scripts support the -k option to keep a copy of your
responses in a file named setupXXXXX.inf (where each X is a random character). You can use
this file to set up additional Directory Server instances with the same configuration parameters.
WARNING! Keeping the setupXXXXX.inf file is a security risk because it contains passwords
stored in clear text. If you keep this file, HP recommends that you set appropriate file permissions
or access rights for the file.
4.2 Running the setup-ds-admin.pl or setup-ds.pl Script
Use the following procedure to run the setup-ds-admin.pl or setup-ds.pl script:
1. Change directories to the directory where the setup programs are located:
cd /opt/dirsrv/sbin
4.1 Overview 25