Before you can deploy a web application manually, you must make sure that the server_root/bin/https/httpsadmin/bin directory is in your path and that the IWS_SERVER_HOME environment variable is set to your server_root directory.
You can use the wdeploy utility at the command line to deploy a WAR file into a virtual server web application environment:
wdeploy deploy -u <uri_path> -i <instance> -v <vs_id> [ [-V <verboseLevel>]| [-q] ] [-n] [-d <directory>] <war_file>
wdeploy delete -u <uri_path> -i <instance> -v <vs_id> [ [-V <verboseLevel>] | [-q] ] [-n] hard|soft
wdeploy list -i <instance> -v <vs_id> [ [-V <verboseLevel>] | [ -q] ]
The command parameters have the following meanings:
The URI prefix for the web application. |
|
The server instance name. |
|
The virtual server ID. |
|
directory |
(optional) The directory to which the application is deployed, or from which the application is deleted. If not specified for deployment, the application is deployed to the document root directory. |
hard | soft |
Specifies whether the directory and the server.xml entry are deleted (hard) or just the server.xml entry is deleted (soft). |
war_file |
The WAR file name |
verboseLevel |
The verbose level to display the log messages on console. The value can range from 0 to 4. The default value is 1. Note that in Sun Java System web Server 6.1, the loglevel attribute of the LOG element in server.xml is used in lieu of this element. |
-q |
(quiet) Sets the verbose level to zero. It is equivalent to the setting -V 0. |
-n |
prevents wdeploy from automatically sending the reconfigure command to the web server. For more information, see Using -n in the wdeploy Command. |
If you deploy a web application and do not specify a directory, the application is deployed to the document root directory. If you then delete the application using the hard parameter, the document root directory will be deleted.
When you execute the wdeploy deploy command, three things happen:
A web application with the given uri_path and directory gets added to the server.xml file.
The WAR file gets extracted at the target directory.
The server is dynamically reconfigured to load the new web application.
For example:
wdeploy deploy -u /hello -i server.sun.com -v acme.com -d /s1ws61/https-server.sun.com/acme.com/web-apps/hello /s1ws61/plugins/servlets/examples/web-apps/HelloWorld/ HelloWorld.war
This utility results in the following server.xml entry:
<VS> <WEBAPP uri="/hello" dir="/s1ws61/https-server.sun.com/acme.com/webapps/hello"> </VS>
The /s1ws61/https-server.sun.com/acme.com/web-apps/hello directory has the following contents:
colors index.jsp META-INF WEB-INF/ web.xml /classes/ HelloWorldServlet.class HelloWorldServlet.java SnoopServlet.class SnoopServlet.java
In Sun Java System Web Server 6.1, after deploying or deleting a web application, wdeploy dynamically reconfigures the server, causing the server to load or unload the web application that was deployed or deleted. Previously, you had to explicitly reconfigure the server in order for your changes to take effect by doing one of the following:
Using the reconfig script
Restarting the server
Clicking the Apply link in the Administration User Interface.
Now a successful wdeploy command will automatically be enabled to service requests for a new web application, or to stop servicing requests for a deleted web application.
The -n option prevents wdeploy from automatically sending the reconfigure command to the web server. Use the -n option in your command when deploying or undeploying multiple web applications (in a script for example), and you want to reconfigure the server only once after the last web application is deployed.
After you have deployed an application, you can access it from a browser as follows:
http://vs_urlhost[:vs_port]/uri_path/[index_page]
The parts of the URL have the following meanings:
One of the urlhosts values for the virtual server. |
|
(optional) Only needed if the virtual server uses a non-default port. |
|
The same one you used to deploy the application. This is also the context path. |
|
(optional) The page in the application that end users are meant to access first. |
http://acme.com:80/hello/index.jsp
or:
http://acme.com/hello/
The wdeploy option returns following exit values:
0: Indicates that the wdeploy option was executed successfully.
1: Indicates that an error occurred while executing the wdeploy option due to invalid command line arguments or invalid content of the configuration files.
2: Indicates that the error is due to operating system settings. Either the specified directory doesn’t exist or the file permission is not set.