Deploying the HTTP Tunnel Servlet on Sun Java System Web Server

The instructions below refer to deployment on Sun Java System Web Server. You can verify successful HTTP tunnel servlet deployment by accessing the servlet URL using a Web browser. It should display status information.

To Deploy the HTTP Tunnel Servlet as a .war File

1. In the browser-based administration GUI, select the Virtual Server Class tab and select Manage Classes.

2. Select the appropriate virtual server class name (for example, defaultClass) and click the Manage button.

3. Select Manage Virtual Servers.

4. Select an appropriate virtual server name and click the Manage button.

5. Select the Web Applications tab.

6. Click on Deploy Web Application.

7. Select the appropriate values for the WAR File On and WAR File Path fields so as to point to the imqhttp.war file, which can be found in a directory that depends on your operating system (see Appendix A, Platform-Specific Locations of Message Queue^TM Data).

8. Enter a path in the Application URI field.

   The Application URI field value is the /contextRoot portion of the tunnel servlet URL:

   http://hostName :portNumber / contextRoot/tunnel

   For example, if you set the contextRoot to imq, the Application URI field would be:

   /imq

9. Enter the installation directory path (typically somewhere under the Sun Java System Web Server installation root) where the servlet should be deployed.

10. Click OK.

11. Restart the Web server instance.

    The servlet is now available at the following address:

    http://hostName:portNumber/ contextRoot/tunnel

    Clients can now use this URL to connect to the message service using an HTTP connection.

Disabling a Server Access Log

You do not have to disable the server access log, but you will obtain better performance if you do.

To Disable the Server Access Log

1. Select the Status tab.

2. Choose the Log Preferences Page.

   Use the Log client accesses control to disable logging.