This document contains the following:
- How to install iPlanet Web Server Enterprise Edition 4.0
- How to verify the installation
- How to start and stop the server
To install iPlanet Web Server, which you can obtain from the
iPlanet Web site, perform the following steps:
- If you have not already done so, see the
Software Prerequisites Web site to learn what level of iPlanet you need to download.
- 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.
- Ensure that you are logged into the host machine with superuser (root) privileges.
- Move to the directory containing the downloaded file.
- Unzip and extract the files.
- Launch the installation program by typing the following command:
# ./setup
A welcome screen appears.
- Press Enter to exit from the welcome screen and continue installation.
- Type
Yes
to accept the software licensing agreement and press Enter.
- 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.
- Choose the type of installation you require by typing the appropriate number and
pressing Enter. For this example, type
2
for Typical installation.
- 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.
- 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.
- 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. |
- 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.
- 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.
- 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.
- Type the UNIX user name to use when running the Administration Server.
In most cases, this is
root
. Press Enter.
- 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.)
- 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.)
- Retype the Administration Server password and press Enter.
- 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. |
- 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/ . |
- 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.
- 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.
- Type
Yes
to indicate that you want to use your own Java 2 Software
Development Kit (SDK) and press Enter.
- Type the absolute path to the directory on your system where the SDK is installed
and press Enter.
- 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.
- 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.
- After the installation program extracts and installs the iPlanet Web Server
components, a message is displayed, indicating that installation is complete. Press Enter.
To demonstrate that iPlanet Web Server is operating correctly, perform the following steps:
- 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
.
- Start iPlanet Web Server Enterprise Edition 4.0 by typing the following command:
# ./startconsole
- 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.
- On the iPlanet Web Server Administration Server screen, select
the server by clicking the server name button beside the field Select a
Server.
- Click Manage beside the server name button.
- On the iPlanet Web Server 4.0 Server Manager screen, click Server On.
- The Netscape:Question screen confirms that the server has started successfully.
Click OK.
- 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.
- 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:
- On the iPlanet Web Server 4.0 Server Manager screen, click Server Off.
- The Netscape:Question screen confirms that the server has stopped successfully.
Click OK.