Previous     Contents     Index     DocHome     Next     
iPlanet Directory Server 5.1 Installation Guide



Chapter 3   Using Express and Typical Installation


This chapter describes how to perform basic installation procedures. This chapter contains the following sections:



Using Express Installation

Use express installation if you are installing Directory Server to evaluate or test the product. Do not use express installation for production installations, because it does not offer you the choice of selecting your server port number or your directory suffix.

To perform an express installation, do the following:

  1. On UNIX machines, log in as root (root login is required for express installation). On Windows NT and Windows 2000 machines, log in with administrator privileges.

  2. Create a new directory:

    # mkdir ds5.1
    # cd ds5.1

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

  3. On UNIX, unpack the product binaries file using the following command:

    # gunzip -dc file_name.tar.gz | tar -xvof -

    where file_name corresponds to the product binaries you want to unpack.

    On Windows NT and Windows 2000, unzip the product binaries.

  4. Run the setup program. You can find it in the directory in which you untarred or unzipped the binary files. On a UNIX system, issue the following command:

    ./setup

    Select "yes" to continue with installation, then select "yes" to agree to the license.

  5. When you are asked what you would like to install, select the default, iPlanet Servers.

  6. When you are asked what type of installation you would like to perform, select Express Installation.

  7. For server root or destination directory, 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 the setup program. If the directory that you specify does not exist, the setup program creates it for you.

  8. UNIX only. For the user and group under which you run the servers, enter the identity under which you want to run this server. For more information on the user and groups that you should use when running iPlanet servers, see "Choosing the User and Group for Your iPlanet Servers (UNIX® only)".

  9. For Configuration Directory Administrator ID and password, enter the name and password that you will use when you want to authenticate to the console with full privileges (think of this as the root or superuser identity for the iPlanet Console).

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

Note the following about your new Directory Server installation:

  • The Directory Server is listening on port 389.

  • The server is configured to use the following suffixes:

    dc=your_machine's_DNS_domain_name. That is, if your machine is named test.siroe.com, then the suffix dc=siroe,dc=com is configured for this server.

    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 iPlanet Directory Server Administrator's Guide.



Using Typical Installation


Most first time installations of Directory Server 5.1 can be performed using the Typical Installation option of the setup program. Typical installation differs slightly, depending on whether you are installing on UNIX or Windows NT and Windows 2000. The following sections outline the different procedures.


Using Typical Installation on UNIX

To perform a typical installation on UNIX:

  1. Log in as root.

  2. Create a new directory:

    # mkdir ds5.1
    # cd ds5.1

  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 file_name.tar.gz | tar -xvof -

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

  5. Run the setup program. You can find it in the directory where you untarred 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.

    If you want to log in as root or superuser (su), you will need 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, iPlanet Servers (this is item 1).

  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. If the directory that you specify does not exist, setup creates it for you.

    By default, the setup program provides the following path:

    /usr/iplanet/servers

    If you want to install the software into this directory tree, press Enter. If not, 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 (iPlanet Administration Server and the Administration Server Console).

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


    Caution

    Note that 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 "Common Installation Problems," on page 83 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 iPlanet servers, see "Choosing the User and Group for Your iPlanet Servers (UNIX® only)".

  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 the server you are currently installing will be the one for your user data. For most cases, you can select the default. 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 (389) unless you already have another application using that port.

  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.


    Caution

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


  21. For Configuration Directory Administrator ID and password, enter the name and password that you will use when you want to authenticate to the console with full privileges.

  22. For a directory suffix, enter a distinguished name 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.

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

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


    Note

    Any Distinguished Names 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 with which you bind to the directory when you want access control to be ignored. This distinguished name 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.

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

  25. For Administration Domain, enter the domain that you want this server to belong to.

    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, see "Determining the Administration Domain".

  26. For the administration port number, enter a value that is not in use (for example, you might want to use the value 5100 to indicate a 5.1 Directory Server). Be sure to record this value.

  27. For the user under which you want to run Administration Server, enter root. This is the default.

    For information on why you should run Administration Server as root, see "Choosing the User and Group for Your iPlanet Servers (UNIX® only)".

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

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 iPlanet Directory Server Administrator's Guide.


Using Typical Installation on Windows NT and Windows 2000

To perform a typical installation on Windows NT and Windows 2000:

  1. Log in as a user with administrator privileges.

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

  3. Unzip the product binaries files and run the setup program.

  4. When you are asked what you would like to install, select the default, iPlanet Servers.

  5. When you are asked what type of installation you would like to perform, select the default, Typical.

  6. For server installation 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. If the directory that you specify does not exist, setup creates it for you.

  7. For configuration directory, select the default if this directory will host your o=NetscapeRoot tree. Otherwise, enter the appropriate contact information for the configuration directory.

    If this Directory Server instance is not the configuration directory, then the configuration directory must exist and be running before you can continue this installation.

  8. For the directory to store data in, you must decide if this Directory Server instance will store your enterprise's data. For most cases, you can select the default, "Store data in this Directory Server." However, if this Directory Server instance is intended to be a configuration directory only, then you should select "Store data in an existing Directory Server."

  9. For 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 hostname 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.

  10. For directory suffix, enter a distinguished name that is meaningful to your enterprise.

    This string is used to form the name of all your organization's directory entries. Therefore, pick some name that is representative of your organization. It is recommended that you pick a suffix that corresponds to your Internet DNS name. For example, if your organization uses the DNS name siroe.com, then enter dc=siroe,dc=com here.

  11. For the Directory Server port, select the default (389) unless you already have another application using that port.

  12. For Configuration Directory Administrator ID and password, enter the name and password that you will log in as when you want to authenticate to the console with full privileges.

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

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

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


    Note

    Any Distinguished Names 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 bind to the directory as when you want access control to be ignored. This distinguished name 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.

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

  16. For administration port number, enter a value that is not in use. Be sure to record this value.

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

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 iPlanet Directory Server Administrator's Guide.


Previous     Contents     Index     DocHome     Next     
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.

Last Updated October 29, 2001