IBM Integration Bus, Version 10.0.0.5 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Deploying the HTTP proxy servlet on WebSphere Application Server Liberty Profile

Load and install the HTTP proxy servlet file on WebSphere® Application Server Liberty Profile.

Before you begin

Before you deploy the HTTP proxy servlet, you must complete the following tasks:

About this task

Install and customize a WebSphere Application Server Liberty Profile (Liberty) server, and then deploy the HTTP proxy servlet by completing the following steps. The instructions assume that IBM® Integration Bus is installed and running on the same machine as the Liberty server.

Procedure

To deploy the HTTP proxy servlet on the Liberty server, complete the following steps:

  1. Follow the instructions on the WebSphere Application Server V8.5.5 Liberty Profile download page to download and install a Liberty server.
  2. Create the following sub directory in your Liberty server installation: Liberty_installation_path\wlp\usr\shared\resources\wmq.
  3. Copy the following WebSphere MQ JAR files from WebSphere_MQ_installation_path\Java\lib to Liberty_installation_path\wlp\usr\shared\resources\wmq:
    • com.ibm.mq.commonservices.jar
    • com.ibm.mq.headers.jar
    • com.ibm.mq.jar
    • com.ibm.mq.jmqi.jar
    • com.ibm.mq.pcf.jar
    • connector.jar
    The HTTP proxy servlet uses WebSphere MQ to communicate with IBM Integration Bus.
  4. Copy the HTTP proxy servlet .war file that you exported from IBM Integration Bus (for example, myproxyservlet.war) to Liberty_installation_path\wlp\usr\shared\apps.
  5. In the Eclipse workspace for the Liberty server, click the Servers tab and open the server.xml file by double-clicking the Server Configuration entry.
  6. Add the following lines to server.xml to define the shared library that contains the WebSphere MQ .jar files:
    <library id="wmq" name="wmq">
         <fileset dir="${shared.resource.dir}/wmq" includes="*.jar"/>
    </library>
  7. Add the following lines to server.xml to set the context root for the HTTP proxy servlet and link the HTTP proxy servlet with the WebSphere MQ shared library. For information about the context root, see Importance of the context root when you configure the HTTP proxy servlet.
    <application id="proxyservlet" location="servlet_file_name.war"
            name="proxyservlet" type="war" context-root="context_root">
            <classloader privateLibraryRef="wmq"/>    
    </application>
    where:
    servlet_file_name
    Specifies the name of the HTTP proxy servlet file that you exported from IBM Integration Bus.
    context_root
    Specifies the context root you want to assign to the HTTP proxy servlet.
    Note: If you want the HTTP proxy servlet to use an empty context root set context-root="/".
  8. Save and close server.xml, and start the Liberty server.
  9. To test if the HTTP proxy servlet is active, enter the following URL in a web browser:
    http://host_name:port/context_root
    where:
    host_name
    Specifies the host name of your Liberty server.
    port
    Specifies the port number of your Liberty server.
    context_root
    Specifies the context root that you assigned to the HTTP proxy servlet.

    For example: http://localhost:9080/.

    If the HTTP proxy servlet can reach the integration node, then you should get an HTTP Status 404 response with the following error message:
    URI / does not map to any message flow in integration node integration_node
    where integration_node is the name of your integration node.

Results

The HTTP proxy servlet is deployed on the WebSphere Application Server Liberty Profile server.

What to do next

The HTTP proxy servlet is now ready to be tested with an integration node that receives HTTP (not HTTPS) requests and passes them to a message flow. For information about how to complete this task, see Testing the HTTP proxy servlet.


ac69452_.htm | Last updated 2016-06-25 08:07:22