This article describes how to perform the following procedures on a Solaris SPARC 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.
To install iPlanet Web Server, perform the following steps:
- 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.
- Start the installation program by typing the following command:
# ./setup
A welcome window opens.
- Press Enter to close the welcome window and continue installation.
- Type
Yes
to accept the software licensing agreement and press Enter.
- 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.
- 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 (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.
- 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
iPlanet 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 iPlanet
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 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 for the location of the
server files that you specified in Step 9. 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 window might appear that prompts you to 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 window might appear that prompts you to 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 9 in the previous section. In this example, the directory is
/usr/netscape/server4
.
- 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.
- 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.
- In the iPlanet Web Server Administration Server window, select
the server by clicking the server name button beside the field Select a
Server.
- Click Manage beside the server name button.
- In the iPlanet Web Server Server Manager window, click Server On.
- 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.
- The Netscape:Question window 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 that you specified in Step 12 in the previous section.
A default page provided by the iPlanet 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 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.)
- In the iPlanet Web Server Server Manager window, click Server Off.
- The Netscape:Question window confirms that the server has stopped successfully.
Click OK.
- In the iPlanet Web Server Server Manager window, click the Servlets tab. The Enable Servlets window
opens.
- Under the Activate the Servlet Engine? field, click the radio button beside the No option
and then click OK.
- The Save and Apply Changes window appears. Click Save and Apply.
- The Netscape:Question window confirms that your changes are saved and applied. Click OK.