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:
- Follow the instructions on the
WebSphere Application
Server V8.5.5 Liberty Profile download
page to download and install a Liberty server.
- Create the following sub directory in your Liberty server
installation: Liberty_installation_path\wlp\usr\shared\resources\wmq.
- 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.
- 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.
- 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.
- 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>
- 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="/".
- Save and close server.xml, and start
the Liberty server.
- 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.