TN0014: Updating the Deployment Descriptor for a Previously-Deployed Java EE Web Application Archive (WAR)

Summary

There are times when it may be necessary to make modifications to the Jazz Team Server Java EE Web Application Archive (WAR) deployment descriptor (web.xml) after the WAR has already been deployed, for example, if you wish to change the basic security configuration. This document provides details on how to do this in both an Apache Tomcat and WebSphere Application Server environment

More Information

Apache Tomcat

Modifying the deployment descriptor on Tomcat is just a matter of locating the web.xml file and editing it.

(Note: This example assumes Jazz Team Server is rooted at C:jazzserver. Please adjust based on your actual install directory.)

1. Modify the web.xml file found at C:jazzservertomcatwebappsjazzWEB-INFweb.xml
2. Restart Tomcat for the modification to take effect

WebSphere Application Server (WAS)

1. Access the WAS Admin Web UI and navigate to the “Enterprise Applications” page.
2. Select the Jazz Team Server WAR application and click the “Update” button.
3. A new page will appear with a number of options. Select the “Replace or add a single file” radio button.
4. In the “Specify the path beginning with the installed application archive file to the file to be replaced or added” entry field enter jazz.warWEB-INFweb.xml
5. Use the “Local file system” Browse button to select your modified web.xml file
6. Click the “Next” button and then the “Ok” button on the following page.
7. Select the “Save directly to the master configuration” link to complete the modification.
8. Restart the Jazz Team Server application for the changes to take effect.

References

• TN0013: Jazz Team Server Authentication Explained – Provides background information on how Jazz Team Server is packaged as a WAR and information on various configuration options for the web.xml deployment descriptor.