How to Install an iPlanet Web Server

To perform this procedure, you need the following information about your configuration.

• The server root directory (the path to the application binaries). You can install the binaries on the local disks or on the cluster file system. For a discussion of the advantages and disadvantages of each location, see "Determining the Location of the Application Binaries".

• The logical hostname (for failover services) or shared address (for scalable services) that clients use to access the data service. You must configure these addresses, and they must be online.

If you run Sun Cluster HA for iPlanet Web Server and another HTTP server and they use the same network resources, configure them to listen on different ports. Otherwise, a port conflict might occur between the two servers.

1. Become superuser on a cluster member.

2. Run the setup command from the iPlanet install directory on the CD.

3. When prompted, enter the location where the iPlanet server binaries will be installed.

   You can specify a location on the cluster file system or on local disks for the location of the install. If you choose to install on local disks, run the setup command on all of the cluster nodes that are potential primaries of the network resource (logical hostname or shared address) that the next step specifies.

4. When prompted for a machine name, enter the logical hostname on which the iPlanet server depends and the appropriate DNS domain name.

   A full logical hostname is of the format network-resource.domainname, such as schost-1.sun.com.

   ---

   Note -

   For Sun Cluster HA for iPlanet Web Server to fail over correctly, you must use either the logical hostname or shared address resource name (rather than the physical hostname) here and everywhere else that you are asked.

   ---

5. Select Run Admin Server as Root when you are asked.

   Note the port number that the iPlanet install script selects for the administration server. You might want to use this default value later when you use the admin server to configure an instance of the iPlanet Web server. Otherwise, you can specify a different port number when you configure the iPlanet server instance.

6. Type a Server Administrator ID and a chosen password when you are asked.

   Follow the guidelines for your system.

   When a message displays that the admin server will be started, your installation is ready for configuration.

Where to Go From Here

To configure the Web server, see one of the following sections.

To configure a secure instance of the Web server, determine the iPlanet Web Server version you are using, then see one of the following two sections.

• "How to Set up a Secure Instance of an iPlanet Web Server (iPlanet Web Server 5.0)"

• "How to Set up a Secure Instance of an iPlanet Web Server (iPlanet Web Server 6.0)"

To configure a non-secure instance of the Web server, see the following section.

• "How to Configure an iPlanet Web Server"