Deploying the HTTP proxy servlet on WebSphere Application Server Liberty Profile

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 broker, then you should get an HTTP Status 404 response with the following error message:

   URI / does not map to any message flow in broker integration_node

   where integration_node is the name of your broker.