WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Installing and customizing a web servlet container for the proxy servlet

Download, install, and customize a web servlet container, such as WebSphere® Application Server or Apache Tomcat, for the proxy servlet to use to receive HTTP requests from web services client applications.

Before you install the servlet container, you must have completed the following tasks:
  • Installed WebSphere Message Broker.
  • If you are planning to install Apache Tomcat V6 as your web servlet, you must have installed a Java™ SDK that is compatible with Apache Tomcat V6.

The documentation in this section is based on an Apache Tomcat Version 6 installation, however this procedure can be used to guide you through the installation of a different web servlet container because the procedures are similar. This information describes the Apache Tomcat V6 installation on Windows, and assumes WebSphere Message Broker is installed and running on the same server.

Windows platformWindows

  1. Download Apache Tomcat V6 to your local directory from the Apache Tomcat 6 Downloads website at: Apache Tomcat 6 download page
  2. Run the Apache Tomcat V6 installer.
    1. Accept the license agreement.
    2. Select the required Apache Tomcat components and features to install.
    3. Select the destination directory for the Apache Tomcat installation. For example, C:\Tomcat6.
    4. Enter an HTTP listener port. For example, 8181.
    5. Type an administrator user ID and password. For example, admin.
    6. Browse and select the path to a Java Runtime Environment (JRE) version that is equal to (or greater than) the version used in your WebSphere Message Broker installation. For example, C:\Program Files\IBM\MQSI\8.0.0.0\jre16
    7. Click Install to start the installation.
  3. Restart Windows. Apache Tomcat is now running as a Windows Service.
  4. Open a web browser, such as Internet Explorer, and enter web address http://localhost:8181. Apache Tomcats home page is displayed.
  5. Find file catalina.properties in your local directory. For example, <tomcat_installation_path>/conf. Where <tomcat_installation_path> specifies the name of your Apache Tomcat installation directory.
  6. Edit catalina.properties and change shared.loader= to shared.loader= ${catalina.home}/shared/lib,${catalina.home}/shared/lib/*.jar.
  7. Create a directory called <tomcat_installation_path>/shared/lib.
  8. Copy the required WebSphere MQ JAR files into the Apache Tomcat shared loader directory. The proxy servlet uses WebSphere MQ to communicate with WebSphere Message Broker. It requires the following JAR files to exist in the Apache Tomcat shared loader directory: com.ibm.mq.jar and connector.jar. From WebSphere MQ Version 7.0 onwards, you also require the following JAR files:
    • com.ibm.mq.commonservices.jar
    • com.ibm.mq.headers.jar
    • com.ibm.mq.pcf.jar
    • com.ibm.mq.jmqi.jar
    Copy the JAR files from <WebSphere_MQ_installation_path>\Java\lib to <tomcat_installation_path>\shared\lib.

You have downloaded, installed, and customized Apache Tomcat V6 ready for use by the proxy servlet.

You must now configure the proxy servlet, see:
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:46:35


Task topicTask topic | Version 8.0.0.7 | ac69410_