specify values specific to the Directory Server being set up. For example, parameters such as ConfigDirectoryLdapURL, which can be used for multiple instances, could be specified in the setup file. Parameters such as FullMachineName, which is specific to the host, could be specified in the command line. For example, with the following command, the setup script uses the common parameter values specified in the common.inf file, but overrides the host-specific parameter values for FullMachineName and ServerIdentifier with those specified in the command line. This command runs the script in silent mode.

#/opt/dirsrv/sbin/setup-ds-admin.pl -s -f common.inf \ General.FullMachineName=ldap37.example.com slapd.ServerIdentifier=ldap37

NOTE:

The section names and parameter names used in setup files and on the command line are case sensitive. For information on correct capitalization, see Table 3-1.

The setup file can include a parameter that imports the contents of any LDIF file into the Directory Server. This parameter, ConfigFile, is set in the [slapd] section of the setup file. This is extremely useful for preconfiguring users, replication, and other directory management entries. For more information on using the ConfigFile parameter to configure the Directory Server, see “Importing LDIF files for configuring Directory Server users, replication, and other entities” (page 36).

Setup script command line options

Table 3-1 setup-ds-admin options

Option

Alternate

Description

-fname

--file=name

This sets the path and name of the file which contains configuration settings

 

 

for the new Directory Server instance. You can use this option with the -s

 

 

option. If you use the -foption without the -s, the specified file sets the

 

 

default values for the setup interactive prompts. For example:

 

 

/opt/dirsrv/sbin/setup-ds-admin.pl -f ./sample.inf

 

 

 

-s

--silent

This causes the setup script to run in silent mode, using the configuration

 

 

information predefined in a file rather than specified interactively; specify

 

 

the file name with the -foption. For example:

 

 

/opt/dirsrv/sbin/setup-ds-admin.pl -f ./setup.inf -s

 

 

. (Configuration information can also be specified in the command line;

 

 

this information overrides the corresponding information defined in the

 

 

setup file.)

 

 

 

-d[dddd]

--debug

This turns on debugging information. With the -dflag, increasing the

 

 

number of ds increases the debug level.

 

 

 

3.6 Setting up the Directory Server and Administration Server

19