Show Table of Contents
1.3. About the setup-ds-admin.pl Script
The Directory Server and Administration Server instances are created and configured through a script called setup-ds-admin.pl. The Directory Server alone can be created using the
setup-ds.pl
script.
If simply the setup script is run, then the script launches an interactive installer which prompts for configuration settings for the Directory Server and Administration Server instances. For example:
# setup-ds-admin.pl
Important
Run the
setup-ds.pl
script as root.
The
setup-ds-admin.pl
script can also accept a setup file or have arguments passed with the command to supply configuration information automatically.
# setup-ds-admin.pl -s -f /export/files/install.inf setup-ds-admin.pl General.FullMachineName=ldap.example.com
Some options, such as
s
(silent) and f
(file) allow you to supply values for the setup program through a file. The .inf
file (described in more detail in Section 4.6, “Silent Setup”) has three sections for each of the major components of Directory Server: General
(host server), slapd
(LDAP server), and admin
(Administration Server).
The same parameters specified in the
.inf
can be passed directly in the command line. Command-line arguments with setup-ds-admin.pl
specify the .inf
setup file section (General
, slapd
, or admin
), parameter, and value in the following form:
section.parameter=value
For example, to set the machine name, suffix, and Directory Server port of the new instance, the command is as follows:
# 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. With the s
option, these values are accepted as the real settings.
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 to set up many Directory Servers. Many of the parameters can be the same, such as ConfigDirectoryLdapURL
, ones specific to the host, such as FullMachineName
have to be unique. For example:
# setup-ds-admin.pl -s -f common.inf General.FullMachineName=ldap37.example.com slapd.ServerIdentifier=ldap37
This command uses the common parameters specified in the
common.inf
file, but overrides FullMachineName
and ServerIdentifier
with the command line arguments.
Note
The section names and parameter names used in the
.inf
files and on the command line are case sensitive. Refer to Appendix A, Parameters in .inf
Files to check the correct capitalization.
The
.inf
file has an additional option, ConfigFile
which imports the contents of any LDIF file into the Directory Server. This is an extremely useful tool for preconfiguring users, replication, and other directory management entries. For more information on using the ConfigFile
parameter to configure the Directory Server, see Section 4.6.4, “Using the ConfigFile Parameter to Configure the Directory Server”.
Each prompt in the installer 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
.
Note
To go back to a previous dialog screen, type Control-B and press Enter. You can backtrack all the way to the first screen.
When the
setup-ds-admin.pl
finishes, it generates a log file in the /tmp
directory called setup
XXXXXX.log
where XXXXXX is a series of random characters. This log file contains all of the prompts and answers supplied to those prompts, except for passwords.
For the list of options supported by
setup-ds-admin
, see the utility's description in the Red Hat Directory Server Configuration, Command, and File Reference.