Installing iPlanet Web Server Enterprise Edition 4.0

This document contains the following:

Installing iPlanet Web Server Enterprise Edition 4.0

To install iPlanet Web Server, which you can obtain from the iPlanet Web site, perform the following steps:

  1. If you have not already done so, see the Software Prerequisites Web site to learn what level of iPlanet you need to download.
  2. Download the appropriate version of iPlanet Web Server and any required patches from the iPlanet Web site at www.iplanet.com/downloads/download/. Follow the steps given to download the file.
  3. Ensure that you are logged into the host machine with superuser (root) privileges.
  4. Move to the directory containing the downloaded file.
  5. Unzip and extract the files.
  6. Launch the installation program by typing the following command: # ./setup

    A welcome screen appears.

  7. Press Enter to exit from the welcome screen and continue installation.
  8. Type Yes to accept the software licensing agreement and press Enter.
  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 Enter to exit from the installation program. If you want to proceed with the installation, type Yes and press Enter to close the warning screen.
  10. Choose the type of installation you require by typing the appropriate number and pressing Enter. For this example, type 2 for Typical installation.
  11. 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.
  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 Enter.
  13. 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.
  14. If the default host_name shown in brackets ([]) is correct, press Enter. If your host_name (the name of your host machine) differs from the one shown in brackets, type the correct host_name and press Enter.
  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 of nobody and press Enter.
  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 of nobody and press Enter.
  17. Type the UNIX user name to use when running the Administration Server. In most cases, this is root. Press Enter.
  18. 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 Netscape environment.)
  19. 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 Netscape environment.)
  20. Retype the Administration Server password and press Enter.
  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 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.
  22. 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/.
  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 Enter.
  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 Enter.
  25. Type Yes to indicate that you want to use your own Java 2 Software Development Kit (SDK) and press Enter.
  26. Type the absolute path to the directory on your system where the SDK is installed and press Enter.
  27. A screen 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.
  28. A screen 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.
  29. After the installation program extracts and installs the iPlanet Web Server components, a message is displayed, indicating that installation is complete. Press Enter.

Verifying installation of iPlanet Web Server Enterprise Edition 4.0 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 11 in the section Installing iPlanet Web Server Enterprise Edition 4.0). In this example, the directory is /usr/netscape/server4.
  2. Start iPlanet Web Server Enterprise Edition 4.0 by typing the following command: # ./startconsole
  3. In the Netscape:Password screen, 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.0 (in this example, admin). Click OK.
  4. On the iPlanet Web Server Administration Server screen, select the server by clicking the server name button beside the field Select a Server.
  5. Click Manage beside the server name button.
  6. On the iPlanet Web Server 4.0 Server Manager screen, click Server On.
  7. The Netscape:Question screen confirms that the server has started successfully. Click OK.
  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.0. A default page provided by the Netscape installation is displayed.
  9. 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.0. You can 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 your iPlanet Web Server.

Stopping the iPlanet Web Server Enterprise Edition 4.0

Before installing WebSphere Application Server, stop the Web Server by performing the following steps:

  1. On the iPlanet Web Server 4.0 Server Manager screen, click Server Off.
  2. The Netscape:Question screen confirms that the server has stopped successfully. Click OK.