Installing iPlanet Web Server, Enterprise Edition 4.1

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 could function incorrectly.

Installing iPlanet Web Server

Perform the following steps to install iPlanet Web Server:

  1. Ensure that you are logged into the machine with superuser (root) privileges.
  2. Download the appropriate tar.gz file from the iPlanet Downloads Web site at www.iplanet.com/downloads/download/.
  3. Uncompress the .tar.gz file you downloaded by using the gunzip utility, as follows:
    # gzip -d file_name.tar.gz

    In this command, file_name is the name of the compressed .tar.gz file you downloaded.

  4. Untar the compressed .tar file to extract the iPlanet Web Server filesets by using the tar command, as follows:
    # tar -xvf file_name.tar

    In this command, file_name is the name of the uncompressed .tar file.

  5. Ensure that you are in the directory containing the uncompressed and untarred iPlanet Web Server files.
  6. Start the iPlanet Web Server Installation/Uninstallation program by typing the following command: # ./setup

    The Welcome screen appears.

  7. Press Return to exit from the Welcome screen and continue installation.
  8. Type Yes to accept the software licensing agreement and press Return.
  9. A warning screen can appear that alerts you to any potential installation problems. If you want to resolve any problems, type No and press Return to exit from the installation program. If you want to proceed with the installation, type Yes and press Return to close the warning screen.
  10. Choose the type of installation you want to perform by typing the appropriate number and pressing Return. For this example, type 2 for Typical installation.
  11. Type the full pathname of the directory where the server files and directory structure are to be created, or accept the default location /usr/netscape/server4, and press Return.
  12. 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 Return.
  13. Choose the components you want to install by typing the number of each, separating each entry from the next with a comma. Press Return. To accept the default components selected for installation (all components except WAI Support), press Return.
    Note:See the iPlanet Web Server documentation for descriptions of each component. If you do not install a component and later decide that you want to install it, you can run the iPlanet Web Server Installation/Uninstallation program again and install just the missing component. However, you cannot uninstall individual components after they are installed.
  14. If the default host_name (the name of the machine on which you are installing iPlanet) shown in brackets ([]) is correct, press Return. If the host_name differs from the one shown in brackets, type the correct host_name, and press Return.
  15. Type the UNIX user name to use when running the default instance of iPlanet Web Server. For this example, accept the default user name nobody and press Return.
  16. Type the UNIX group name to use when running the default instance of iPlanet Web Server. For this example, accept the default group name nobody and press Return.
  17. Type the UNIX user name to use when running the Administration Server. In most cases, this is root. Press Return.
  18. Type the Administration Server user name to use for authentication. For this example, type the default name admin and press Return. This user is not a UNIX user, but a user name created in the Netscape environment.
  19. Type the Administration Server password to use for authentication. For this example, type the default name admin and press Return. This password is not a UNIX password, but a password created in the Netscape environment.
  20. Confirm the Administration Server password by typing admin again. Press Return to continue.
  21. 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 Return. 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.
  22. Type a number for the port on which to run the iPlanet Web Server and press Return. 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 different. 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/.
  23. 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 Return.
  24. 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 11. Press Return.
  25. Type Yes to indicate that you want to use your own Java2 Software Development Kit (SDK) and press Return.
  26. Type the full pathname of the directory in which the Java2 SDK is installed and press Return.
  27. A screen can appear that prompts you specify the full pathname of the SDK libraries if they are not found in the /jre/lib subdirectory of the SDK directory. For this example, press Return.
  28. A screen can appear that lets you specify a pathname to your SDK library classes if they are not found in the /lib subdirectory of the SDK directory. For this example, press Return.
  29. After the installation program extracts and installs the iPlanet Web Server components, a message opens, indicating that installation is complete. Press Return to exit from the iPlanet Web Server Installation/Uninstallation program.

Verifying installation of iPlanet Web Server

Perform the following steps to demonstrate that iPlanet Web Server is operating correctly:

  1. Ensure that you are the directory that stores the server files (the directory that you specified in Step 11 in the section Installing iPlanet Web Server, Enterprise Edition 4.1). In this example, the directory is /usr/netscape/server4.
  2. Start iPlanet Web Server by typing the following command: # ./startconsole
  3. In the Netscape: Password dialog, type the Administration Server user name and password that you specified in Step 18 and Step 19 in the section Installing iPlanet Web Server, Enterprise Edition 4.1 (in this example, admin). Click OK.
  4. On the iPlanet Web Server Administration Server Web page, select the server to administer by clicking the server name button beside the Select a Server field, then click Manage.
  5. On the iPlanet Web Server 4.1 Server Manager Web page, click Server On.
  6. The Netscape: Security Warning dialog 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.
  7. The Netscape:Question dialog confirms that the server has started successfully. Click OK to continue.
  8. Open a browser window and type the Web address http://host_name/, where host_name is the host name you specified in Step 14 in the section Installing iPlanet Web Server, Enterprise Edition 4.1.
  9. The iPlanet Web Server, Enterprise Edition 4.1 Web page opens. Type the Web address http://host_name:administration_port_number/, where administration_port_number is the port number that you defined in Step 21 in the section Installing iPlanet Web Server, Enterprise Edition 4.1 (8888, for this example).
  10. You can be prompted for the Administration Server user name and password. If so, type the Administration Server user name and password that you specified in Step 18 and Step 19 in the section Installing iPlanet Web Server, Enterprise Edition 4.1 (in this example, admin). Click OK.
  11. The iPlanet Web Server Administration Server Web page opens; iPlanet Web Server is installed and operating correctly.

Note: You must stop the iPlanet Web Server before installing WebSphere Application Server.

Stopping iPlanet Web Server

Perform the following steps to stop the iPlanet Web Server:

  1. On the iPlanet Web Server 4.1 Server Manager Web page, click Server Off.
  2. The Netscape: Security Warning dialog 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.
  3. The Netscape: Question dialog confirms that the server has stopped successfully. Click OK to continue.