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
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.plscript as root.
setup-ds-admin.plscript 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
f(file) allow you to supply values for the setup program through a file. The
.inffile (described in more detail in Section 4.6, “Silent Setup”) has three sections for each of the major components of Directory Server:
slapd(LDAP server), and
The same parameters specified in the
.infcan be passed directly in the command line. Command-line arguments with
.infsetup file section (
admin), parameter, and value in the following form:
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
Passing arguments in the command line or specifying an
.infsets the defaults used in the interactive prompt unless they are used with the
s(silent) option. With the
soption, 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
.inffile can be used in conjunction with command line parameters. Parameters set in the command line override those specified in an
.inffile, which is useful for creating an
.inffile 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
FullMachineNamehave 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.inffile, but overrides
ServerIdentifierwith the command line arguments.
The section names and parameter names used in the
.inffiles and on the command line are case sensitive. Refer to Appendix A, Parameters in
.infFiles to check the correct capitalization.
.inffile has an additional option,
ConfigFilewhich 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
ConfigFileparameter 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
To go back to a previous dialog screen, type Control-B and press Enter. You can backtrack all the way to the first screen.
setup-ds-admin.plfinishes, it generates a log file in the
.logwhere 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.