3.2. Installing on Solaris and HP-UX using a Typical Installation

Most first time installations of Directory Server can be performed using the Typical Installation option of the setup program.

To perform a typical installation:

  1. Log in as root.

  2. Create a new directory:

    mkdir ds
    cd ds
  3. If you have not already done so, download the product binaries file to the installation directory.

  4. Unpack the product binaries file using the following command:

    gunzip -dc filename.tar.gz | tar -xvof -

    where filename corresponds to the product binaries that you want to unpack.

  5. Run the setup program. You can find it in the directory in which you untarred or unzipped the binary files. Issue the following command from the installation directory:

    ./setup
  6. The setup program asks if you would like to proceed with the setup. Press [Enter] to respond with the default (the default for this prompt is Yes) or press N if you would like to exit the setup program.

  7. Next, the setup program asks you if you agree to the license terms. Press y to agree with the license terms.

  8. When you are asked what you would like to install, press [Enter] to select the default, Red Hat Servers.

  9. When you are asked what type of installation you would like to perform, press [Enter] to select the default, Typical Installation.

  10. For server root, enter a full path to the location where you want to install your server.

    The location that you enter must be some directory other than the directory from which you are running setup. Also, the name of the directory where you install files must not contain any space characters. If the directory that you specify does not exist, setup creates it for you.

    By default, the setup program provides the following path:

    /opt/redhat/servers

    If you want to install the software into this directory tree, press [Enter]; otherwise, supply your own path.

  11. For the Server Products Core Components, Directory Suite, Administration Services, nsPerl, and PerLDAP, press [Enter] to select the default (all components).

  12. Press [Enter] to select all of the Server Products Core Components.

  13. Press [Enter] to select all the Directory Suite components.

  14. Press [Enter] to select all of the Administration Services components (Red Hat Administration Server and the Administration Server Console).

  15. For the hostname, enter a fully qualified hostname.

    CautionCaution
     

    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 will fail. Refer to Section 7.2 Common Installation Problems for more information about entering a fully qualified domain name.

  16. 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.

  17. 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.

  18. 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.

  19. 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.

  20. 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.

    CautionCaution
     

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

  21. For 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.

  22. 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.

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

    NoteNote
     

    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.

  24. 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.

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

  26. 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.