Sun Java System Message Queue 3.7 UR1 Administration Guide

Step 2. Modifying the HTTP Tunnel Servlet .war File’s Descriptor File

The HTTP Tunnel Servlet’s .war file includes a deployment descriptor that contains the basic configuration information needed by the Web server/application server to load and run the servlet.

The deployment descriptor of the imqhttps.war file cannot know where you have placed the key store file needed by the tunnel servlet. This requires you to edit the tunnel servlet’s deployment descriptor (an XML file) to specify the key store location and password before deploying the imqhttps.war file.

ProcedureTo Modify the HTTPS Tunnel Servlet .war File

  1. Copy the .war file to a temporary directory.

    cp /usr/share/lib/imq/imqhttps.war /tmp (Solaris)

    cp /opt/sun/mq/share/lib/imqhttps.war /tmp (Linux)

    cp IMQ_HOME/lib/imqhttps.war /tmp (Windows)

  2. Make the temporary directory your current directory.

    $ cd /tmp

  3. Extract the contents of the .war file.

    $ jar xvf imqhttps.war

  4. List the .war file’s deployment descriptor.

    $ ls -l WEB-INF/web.xml

  5. Edit the web.xml file to provide correct values for the keystoreLocation and keystorePassword arguments (as well as servletPort and servletHost arguments, if necessary).

  6. Reassemble the contents of the .war file.

    $ jar uvf imqhttps.war WEB-INF/web.xml

    You are now ready to use the modified imqhttps.war file to deploy the HTTPS tunnel servlet. (If you are concerned about exposure of the key store password, you can use file system permissions to restrict access to the imqhttps.war file.)