3.4. Installing on Red Hat Enterprise Linux Using a Typical Installation

To install Directory Server on Red Hat Enterprise Linux, do the following:

1. Log in as root.

2. If you have not already done so, download the product binaries file to the installation directory.

3. Use the rpm tool to install the server components, as follows:

   rpm -ivh package.rpm

   The server components are then installed in the default location: /opt/redhat-ds/.

4. Next, you need to create an instance of the Directory Server by running the setup program:

   cd /opt/redhat-ds/ ./setup/setup

5. Type y to accept the licensing agreement, then y again to continue with setup.

6. Select the installation mode; the default is typical installation.

7. For the hostname, either enter a fully qualified hostname or select the default (which is the local host).

   	Caution
   	The default hostname may be incorrect if the installer cannot locate a DNS name in your system. For example, you might not have a DNS name if your system uses NIS.

   The hostname must be a fully qualified host and domain name. If the default hostname is not a fully qualified host and domain name, installation fails. Refer to Section 7.2 Common Installation Problems for more information about entering a fully qualified domain name.

8. The setup program then asks you for the System User and the System Group names. Enter the identity under which you want the servers to run.

   For more information on the user and group names that you should use when running your servers, refer to Section 1.2.3 Deciding the User and Group for Your Servers.

9. For the configuration directory, select the default if this directory will host your o=NetscapeRoot tree. Otherwise, enter yes. You will then be asked for the contact information for the configuration directory.

   If the server you are currently installing is not the configuration directory, then the configuration directory must exist before you can continue this installation.

10. The setup program then asks if you want to use a different installation for your user directory. The default is no (this installation will be the user directory). However, if you intend this server instance to be used as a configuration directory only, then you should enter yes.

11. For the Directory Server port, select the default; this will be 389 or a randomly-generated port number if you already have another application using that port or you are not installing as root.

12. For the Directory Server Identifier, enter a unique value (normally the default is sufficient).

    This value is used as part of the name of the directory in which the Directory Server instance is installed. For example, if your machine's host name is phonebook, then this name is the default, and selecting it will cause the Directory Server instance to be installed into a directory labeled slapd-phonebook.

    	Caution
    	The Directory Server identifier must not contain a period. For example, example.server.com is not a valid server identifier name.

13. For the configuration directory administrator ID and password, enter the name and password as whom you will log in when you want to authenticate to the Console with full privileges.

14. For a directory suffix, enter a distinguished name (DN) meaningful to your enterprise.

    This string is used to form the name of all your organization's directory entries. Therefore, pick a name that is representative of your organization. It is recommended that you pick a suffix that corresponds to your Internet DNS name. Avoid space characters in the suffix.

    For example, if your organization uses the DNS name example.com, then enter dc=example,dc=com here.

15. For the Directory Manager DN, enter the DN that you will use when managing the contents of your directory with unlimited privileges.

    	Note
    	Any DN must be entered in the UTF-8 character set encoding. Older encodings such as ISO-8859-1 are not supported.

    In former releases of Directory Server, the Directory Manager was known as the root DN. This is the entry that you use to bind to the directory when you want access control to be ignored. This DN can be short and does not have to conform to any suffix configured for your directory. However, it should not correspond to an actual entry stored in your directory.

    For the Directory Manager password, enter a value that is at least 8 characters long.

16. For Administration Domain, enter the domain to which you want this server to belong.

    The name you enter should be a unique string that is descriptive of the organization responsible for administering the domain. For information on administration domains, refer to Section 1.2.8 Determining the Administration Domain.

17. For the administration port number, enter a value that is not in use (an available port number will be randomly generated as the default). Be sure to record this value.

18. For the user as whom you want to run Administration Server, enter root. This is the default. You have to run this as root if your port number is below 1024; otherwise, you can run this as a regular user.

    The server is then unpackaged, minimally configured, and started. You are told on what host and port number Administration Server is listening.

    The server is configured to use the following suffixes:

    • The suffix that you configured.

    • o=NetscapeRoot

    Do not modify the contents of the directory under the o=NetscapeRoot suffix. Either create data under the first suffix or create a new suffix to be used for this purpose. For details on how to create new suffixes for your Directory Server, see the Red Hat Directory Server Administration Guide.