|
How Do I Deploy a Web Application Using iPlanet[tm] Web Server v6.x?
By Matthew Hosanee
(May 2002)
We want to hear from you! Please send us your
FEEDBACK.
Overview
The iPlanet[tm] Web Server, Enterprise Edition Administrator's Guide: Chapter
15, describes how to deploy a Web application using a Command Line Interface
(CLI) called wdeploy, but the guide does not detail the parameters
used to modify the behaviour of wdeploy for a novice user. There
is also a Web-based installer that can be used to deploy Web applications.
In the interest of completeness, some information in this article is duplicated from
the documentation.
Command Line
CAUTION: When deleting
the application using the hard parameter,
it will delete the directory where the application is located. So if
the directory is the document
root and the uri_path is "/"
you will loose the entire directory.
The wdeploy CLI lives in server_root/bin/https/httpsadmin/bin,
and the IWS_SERVER_HOME environment variable should be set to your
server_root directory.
The wdeploy CLI requires the following parameters:
wdeploy deploy -u uri_path -i instance -v vs_id
[-d directory] war_file
uri_path
This path is the offset from the document root or directory as specified
in the -d option below. Please read the caution above before setting
this to root - that is, "/". The WebARchive(WAR) file will be extracted immediately
below this directory.
instance
This is the server name and can be located by logging into the administration
server. Under the "Servers" tab, the server name is reported
in the "Select a server" pulldown, and in the "Hostname" field under the settings
area. One example of this is mymachine.iplanet.com.
vs_id
The virtual server ID can be found in the administration server by selecting
to manage the server - that is, mymachine.iplanet.com, then selecting the
"Virtual Server Class" tab. The virtual servers are listed in the tree
view. The example in this case is https-mymachine.iplanet.com.
See the "Using Virtual Servers" resource in the Resources section at the
end of this document for further information.
directory (optional)
This is where the application shall be deployed. If unspecified the default
is the document root. Please read the caution above.
hard|soft
hard - specifies that the directory as well as the entry
in web-apps.xml is removed.
soft - only the web-apps.xml entry is removed.
war_file
This is the location of the WebARchive.
Web Interface
You can also deploy a Web application using the iPlanet Web Server administration
server, which can be found in the server_root/https-admserv
directory.
Log in to the iPlanet Administration console, then select your server followed
by the "manage" button; this will present you with the server manager screen.
Now select the "Virtual Server Class" tab and select your virtual server
in the tree view. Then select the "Web Applications" tab; from here you
can deploy your Web application. You should see the following screen:
The fields are similar to the wdeploy parameters, although you do
not need to specify any server names. The WAR file path is the location
of the WAR. The application URI is the same as the uri_path
parameter previously mentioned, and the installation directory is the same
as the directory parameter.
From "Edit Web Applications", you can list the deployed applications
and also disable, delete or edit the URIs/contexts. You can also change
the Web applications' settings file from the "Java Web Applications Settings"
menu.
Resources
iPlanet Web Server, Enterprise Edition Administrator's Guide - Using Virtual
Servers
iPlanet
Web Server, Enterprise Edition Administrator's Guide - Install and use JSPs
and servlets
DOC ID #1399
|
