Chapter 3   Using Typical Installation


This chapter describes how to perform basic installation activities using the Typical Installation option. Please ignore the Express Installation option.

Using Typical Installation

---

Most initial installations of iDAR 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. 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 idar5

   # cd idar5

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 super user (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; otherwise, supply your own path.

11. For the Server Products Core Components, iDAR, and Administration Services, 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 of the Administration Services components (iPlanet Administration Server and the Administration Server Console).

14. Press Enter to select all the iDAR components.

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

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 Deciding the User and Group for Your iDAR (UNIX Only).

17. For the configuration directory, select which directory will host your o=NetscapeRoot tree in the form: ldap://host:port.

    The configuration directory must exist before you can continue this installation.

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

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

20. For the administration port number, enter a value that is not in use (for example, you might want to use the value 5000 to indicate a 5.0 iDAR). Be sure to record this value.

21. For the user you want to run Administration Server as, enter root. This is the default.

    For information on why you should run Administration Server as root, see Deciding the User and Group for Your iDAR (UNIX Only).

22. For iDAR port number, enter a value that is not in use. The default is 389.

The server is then unpackaged, minimally configured, and started. You are told what 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 iDAR, see the iPlanet Directory Server Administrator's Guide.

Using Typical Installation on Windows NT

To perform a typical installation on Windows NT:

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 iDAR instance is not the configuration directory, then the configuration directory must exist and be running before you can continue this installation.

8. 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 Deciding the User and Group for Your iDAR (UNIX Only).

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

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

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

The server is then unpackaged, minimally configured, and started.

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