Installation guide

has complete access to all installed Directory Servers, regardless of the domain.

Servers on two different domains can use different user directories for authentication and user

management.

1.3. About the setup-ds-admin.pl Script

The Directory Server and Administration Server instances are created and configured through a script

call setup-ds-admin.pl. Running this script launches an interactive setup program with a series of dialog

screens with a yes/no prompt or a simple text input prompt. Each prompt has a default answer in square

brackets, such as the following:

Would you like to continue with setup? [yes]:

Pressing Enter accepts the default answer and proceeds to the next dialog screen. Yes/No

prompts accept y for Yes and n for No.

To go back to a previous dialog screen, type Control-B and press Enter. You can backtrack all

the way to the first screen.

Two prompts ask for a password. After entering it the first time, confirm the password by typing it in

again. The password prompts do not echo the characters entered, so make sure to type them

correctly.

When the setup-ds-adm in.pl finishes, it generates a log file in the /tmp directory called

setupXXXXXX.log where XXXXXX is a series of random characters. T his log file contains all of the

prompts and answers supplied to those prompts, except for passwords.

Some options, such as s (silent) and f (file) allow you to supply values for the setup program

through a file. T he .inf file (described in more detail in Section 6.3, “Silent Setup”) has three

sections for each of the major components of Directory Server: General (host server), slapd

(LDAP server), and adm in (Administration Server). T he parameters used in the .inf can be

passed directly in the command line. Command-line arguments with setup-ds-adm in.pl specify

the .inf setup file section (General, slapd, or adm in), parameter, and value in the following

form:

section.param eter=value

For example, to set the machine name, suffix, and Directory Server port of the new instance, the

command is as follows:

/usr/sbin/setup-ds-admin.pl General.FullMachineName=ldap.example.com

“slapd.Suffix=dc=example, dc=com” slapd.ServerPort=389

NOTE

Passing arguments in the command line or specifying an .inf sets the defaults used in the

interactive prompt unless they are used with the s (silent) option.

Argument values containing spaces or other shell special characters must quoted to prevent the

shell from interpreting them. In the previous example, the suffix value has a space character, so the

entire parameter has to be quoted. If many of the parameters have to be quoted or escaped, use an

.inf file instead.

An .inf file can be used in conjunction with command line parameters. Parameters set in the

command line override those specified in an .inf file, which is useful for creating an .inf file to use

Chapter 1. Preparing for a D irectory Server Installation