Installing iPlanet Web Server Enterprise Edition 4.1

This article describes how to perform the following procedures on an HP-UX machine from files downloaded from the iPlanet Web site at www.iplanet.com/downloads/download/:
  • Install iPlanet Web Server Enterprise Edition
  • Test the installation
  • Start and stop the Web server and Servlet Engine

It is recommended that you install iPlanet Web Server before installing WebSphere Application Server. The WebSphere Application Server installation process changes a Web server's configuration so that the Web server directs certain requests (such as servlet requests) to WebSphere Application Server. If the Web server is not installed before WebSphere Application Server, WebSphere Application Server might function incorrectly.

These instructions assume the following:

  • You do not have a previous version of iPlanet Web Server already installed on your machine. If you do have a previous version of iPlanet Web Server installed, you might need to perform migration tasks based on the version installed. In this case, do not follow these instructions. Instead, refer to iPlanet product documentation on the iPlanet Web Server Documentation Web site at docs.iplanet.com/docs/manuals/.
  • Your machine has enough memory and disk space for your installation. See the iPlanet product documentation on the iPlanet Documentation Web site at docs.iplanet.com/docs/manuals/ for the necessary requirements.
  • You have checked the WebSphere Application Server Supported Hardware, Software, and APIs Web site at www.ibm.com/software/webservers/appserv/doc/latest/prereq.html to learn what level of iPlanet Web Server you need to download.
  • You have downloaded the appropriate version of iPlanet Web Server and any required patches from the iPlanet Web site at www.iplanet.com/downloads/download/ by following the steps given on that Web site.

Installing iPlanet Web Server Enterprise Edition

To install iPlanet Web Server, perform the following steps:

  1. Ensure that you are logged into the host machine with superuser (root) privileges.
  2. Move to the directory containing the downloaded file.
  3. Unzip and extract the files.
  4. Start the installation program by typing the following command:
    # ./setup

    A welcome window opens.

  5. Press Enter to close the welcome window and continue installation.
  6. Type Yes to accept the software licensing agreement and press Enter.
  7. A warning window might appear that alerts you to any potential installation problems and asks if you want to continue with the installation. If you want to resolve any problems, type No and press Enter to exit from the installation program. If you want to proceed with the installation, type Yes and press Enter to close the warning window.
  8. Choose the type of installation you require by typing the appropriate number and pressing Enter. For this example, type 2 for Typical installation.
  9. Type the directory path for the location where the server files and directory structure are to be installed or accept the default location /usr/netscape/server4, and press Enter.
  10. Choose the iPlanet Web Server, Enterprise Edition option and indicate that you want to select from all of its components by typing All and pressing Enter.
  11. Choose the components you want to install by typing the number of each, separating each entry from the next with a comma. Press Enter. (To accept the default installation of all components except WAI Support, press Enter.)
    Note:See the iPlanet Web Server documentation for descriptions of each component. If you do not install a component and later decide that you need it, you can run the installer again and install just the missing component; however, you cannot uninstall individual components after they are installed.
  12. If the default host_name (the name of your host machine) shown in brackets ([]) is correct, press Enter. If your host_name differs from the one shown in brackets, type the correct host_name and press Enter.
  13. Type the UNIX user name to use when running the default instance of iPlanet Web Server. For this example, accept the default user name of nobody and press Enter.
    Note: If the user nobody has a user ID of less than 0 (zero), the setup program issues the following warning:
    ERROR: The system will not allow you to run the
    iPlanet servers as "nobody". Choose another user.
    See the iPlanet Enterprise Server documentation for information on setting up a dedicated user account to use with iPlanet Web Server.
  14. Type the UNIX group name to use when running the default instance of iPlanet Web Server. For this example, accept the default group name of nobody and press Enter.
  15. Type the UNIX user name to use when running the Administration Server. In most cases, this is root. Press Enter.
  16. Type the Administration Server user name to use for authentication. For this example, type the default name admin and press Enter. (This user is not a UNIX user, but a user name set up in the iPlanet environment.)
  17. Type the Administration Server password to use for authentication. For this example, type the default name admin and press Enter. (This password is not a UNIX password, but a password set up in the iPlanet environment.)
  18. Retype the Administration Server password and press Enter.
  19. Type a number between 1024 and 65535 for the port on which to run the Administration Server, or accept the default of 8888 and press Enter. Note this number for later reference.
    Note:If you want to use a port number lower than 1024, you must be logged in as root to start the server.
  20. Type a number for the port on which to run the iPlanet Web Server and press Enter. For this example, accept the default of 80. Note this number for later reference.
    Note:If you want to use a port number lower than 1024, you must be logged in as root to start the server. If you choose a port number other than 80, the Uniform Resource Locator (URL) used to gain access to your home page changes. For instance, if your host is called www.host_name.com and you choose port 9753, your server's URL becomes http://www.host_name.com:9753/.
  21. Specify whether or not you are using a Lightweight Directory Access Protocol (LDAP)-based directory server. For this example, accept the default No and press Enter.
  22. Type the path for the root directory where your server's content files are to reside or accept the default of server_root/docs, where server_root refers to the directory path to the location of the server files that you specified in Step 9. Press Enter.
  23. Type Yes to indicate that you want to use your own Java 2 Software Development Kit (SDK) and press Enter.
  24. Type the absolute path to the directory on your system where the SDK is installed and press Enter.
  25. A window can appear that lets you specify a path name to your SDK libraries if they are not found in the /jre/lib subdirectory of the SDK directory. For this example, press Enter.
  26. A window can appear that lets you specify a path name to your SDK library classes if they are not found in the /lib subdirectory of the SDK directory. For this example, press Enter.
  27. After the installation program extracts and installs the iPlanet Web Server components, a message is displayed, indicating that installation is complete. Press Enter.

Testing installation of iPlanet Web Server Enterprise Edition and starting the server

To demonstrate that iPlanet Web Server is operating correctly, perform the following steps:

  1. Go to the directory that stores the server files (the directory that you specified in Step 9 in the previous section. In this example, the directory is /usr/netscape/server4.
  2. Start iPlanet Web Server Enterprise Edition by entering the following command:
    # ./startconsole
    The startconsole command starts the iPlanet Web Server processes and starts a Netscape Navigator session to the Enterprise Administration Server administration page. Note: The startconsole command requires that Netscape Navigator is installed on the host machine and that the netscape executable file is accessible via the PATH environment variable. For Netscape Navigator to run, the TERM and DISPLAY environment variables must be set to the correct values for your terminal type and display name, respectively.
  3. In the Netscape:Password window, type the Administration Server user name and password that you specified in Step 16 and Step 17 in the previous section (in this example, admin). Click OK.
  4. In the iPlanet Web Server Administration Server window, select the server by clicking the server name button beside the field Select a Server.
  5. Click Manage beside the server name button.
  6. In the iPlanet Web Server Server Manager window, click Server On.
  7. The Netscape:Security Warning window informs you that the information you are about to submit is insecure and could be observed by a third party while in transit. For this example, click Continue Submission.
  8. The Netscape:Question window confirms that the server has started successfully. Click OK.
  9. Open a browser window and type the Web address http://host_name/, where host_name is the host name you specified in Step 12 in the previous section. A default page provided by the iPlanet installation is displayed.
  10. Type the Web address http://host_name:administration_port_number/, where administration_port_number is the port number that you defined in Step 19 in the previous section. You might be prompted for the Administration Server user name and password.

When these steps are complete, iPlanet Web Server is installed and operating correctly. If you are going to install Websphere Application Server, you must stop iPlanet Web Server and the iPlanet Servlet Engine.

Stopping iPlanet Web Server Enterprise Edition and the iPlanet Servlet Engine

Before installing WebSphere Application Server, stop the Web Server and Servlet Engine by performing the following steps. (At several points in this process, the Netscape:Security window might open to inform you that the information you are about to submit is insecure and might be observed by a third party while in transit. For this example, click Continue Submission in each case.)

  1. In the iPlanet Web Server Server Manager window, click Server Off.
  2. The Netscape:Question window confirms that the server has stopped successfully. Click OK.
  3. In the iPlanet Web Server Server Manager window, click the Servlets tab. The Enable Servlets window opens.
  4. Under the Activate the Servlet Engine? field, click the radio button beside the No option and then click OK.
  5. The Save and Apply Changes window appears. Click Save and Apply.
  6. The Netscape:Question window confirms that your changes are saved and applied. Click OK.