1.4. Overview of Setup

After the Directory Server packages are installed, there is a script, setup-ds-admin.pl, which you run to configure the new Directory Server and Administration Server instance. This script launches an interactive setup program. The setup program supplies default configuration values which you can accept them or substitute with alternatives. There are three kinds of setup modes, depending on what you select when you first launch the setup program:
  • Express — The fastest setup mode. This requires minimal interaction and uses default values for almost all settings. Because express installation does not offer the choice of selecting the Directory Server server port number or the directory suffix, among other settings, Red Hat recommends that you not use it for production deployments. Also, express setups can fail if default configuration values are not available because there is no way to offer an alternative.
  • Typical — The default and most common setup mode. This prompts you to supply more detailed information about the directory service, like suffix and configuration directory information, while still proceeding quickly through the setup process.
  • Custom — The most detailed setup mode. This provides more control over Administration Server settings and also allows data to be imported into the Directory Server at setup, so that entries are already populated in the databases when the setup is complete.
The information requested with the setup process is described in Table 1.1, “Comparison of Setup Types”.
There is a fourth setup option, silent setup, which uses a configuration file and command-line options to supply the Directory Server settings automatically, so there is no user interaction required. It is also possible to pass setup arguments with the script, as described in Section 1.3, “About the setup-ds-admin.pl Script”. The possible .inf setup file parameters are listed and described in Appendix A, Parameters in .inf Files.

Note

It is possible to use y and n with the yes and no inputs described in Appendix A, Parameters in .inf Files.

Table 1.1. Comparison of Setup Types

Setup ScreenParameter InputExpressTypicalCustomSilent Setup File Parameter
Continue with setupYes or no N/A
Accept license agreementYes or no N/A
Accept dsktune output and continue with setupYes or no N/A
Choose setup type
  • 1 (express)
  • 2 (typical)
  • 3 (custom)
N/A
Set the computer name ldap.example.com
[General]
FullMachineName=ldap.example.com
Set the user as which the Directory Server will run dirsrv
[General]
SuiteSpotUserID=dirsrv
Set the group as which the Directory Server will run dirsrv
[General]
SuiteSpotGroup=dirsrv
Register the new Directory Server with an existing Configuration Directory Server Yes or no N/A
Set the Configuration Directory Server URL [a] ldap://ldap.example.com:389/o=NetscapeRoot
[General]
ConfigDirectoryLdapURL=ldap://ldap.example.com:389/o=NetscapeRoot
Give the Configuration Directory Server user ID [a] admin
[General]
ConfigDirectoryAdminID=admin
Give the Configuration Directory Server user password [a] password
[General]
ConfigDirectoryAdminPwd=password
Give the Configuration Directory Server administration domain [a] example.com
[General]
AdminDomain=example.com
Give the path to the CA certificate (if using LDAPS) [a] /tmp/cacert.asc
[General]
CACertificate=/tmp/cacert.asc
Set the Configuration Directory Server Administrator user name admin [b]
[General]
ConfigDirectoryAdminID=admin
Set the Configuration Directory Server Administrator password password [b]
[General]
ConfigDirectoryAdminPwd=password
Set the Directory Server port 389
[slapd]
ServerPort=389
Set the Directory Server identifier ldap
[slapd]
ServerIdentifier=ldap
Set the Directory Server suffix dc=domain, dc=component
[slapd]
Suffix=dc=example,dc=com
Set the Directory Manager ID cn=Directory Manager
[slapd]
RootDN=cn=Directory Manager
Set the Directory Manager password password
[slapd]
RootDNPwd=password
Install sample entries Yes or no
[slapd]
AddSampleEntries=Yes
Populate the Directory Server with entries
  • Supply the full path and filename to an LDIF file
  • Type suggest, which imports common container entries, such as ou=People
  • Type none, which does not import any data
  • Equivalent to suggest
[slapd]
AddOrgEntries=Yes
InstallLdifFile=suggest
  • Equivalent to setting the path
[slapd]
AddOrgEntries=Yes
InstallLdifFile=/export/data.ldif
Set the Administration Server port 9830
[admin]
Port=9830
Set the Administration Server IP address blank (all interfaces)
[admin]
ServerIpAddress=111.11.11.11
Set user as which the Administration Server runs dirsrv
[admin]
SysUser=dirsrv
Are you ready to configure your servers? Yes or no N/A
[a] This option is only available if you choose to register the Directory Server instance with a Configuration Directory Server.
[b] This option is only available if you choose not to register the Directory Server instance with a Configuration Directory Server. In that case, the Directory Server being set up is created and configured as a Configuration Directory Server.