This section describes how you can configure the ESB's JMS inbound protocol with WSO2 Message Broker (WSO2 MB).
When you configure WSO2 ESB’s JMS inbound protocol with WSO2 MB, be sure to use WSO2 MB 3.0.0. We do not recommend WSO2 MB 2.2.0 or a previous version.
Follow the steps below to configure the JMS inbound protocol with WSO2 MB 3.0.0.
Start WSO2 MB
Follow the steps given below to set up and start the WSO2 MB server.
Download and install WSO2 MB. For instructions, see Getting Started with WSO2 MB. The unzipped WSO2 MB distribution folder will be referred to as
<MB_HOME>throughout the documentation.
It is not possible to start multiple WSO2 products with their default configurations simultaneously in the same environment. Since all WSO2 products use the same port in their default configuration, there will be port conflicts. Therefore, to avoid port conflicts, apply a port offset in the
<MB_HOME>/repository/conf/carbon.xmlfile by changing the offset value as shown below.
- Open a command line terminal and navigate to the
- Execute one of the following startup scripts to start the broker profile:
- On Linux/Mac OS: sh wso2server.sh
On Windows: wso2server.bat --run
Set up WSO2 ESB to connect with the broker
When the ESB is started, it should be able to connect to the relevant queue in WSO2 MB. Follow the steps given below to set up the ESB to connect with the broker.
- Copy the following JAR files from the
<MB_HOME>/clent-lib folder to the <ESB_HOME>/repository/components/libfolder.
<ESB_HOME>/repository/conf/jndi.propertiesfile and create the connection from the ESB to the WSO2 MB runtime as shown below:
Note the following in the above configuration:
The virtual host is carbon.
- The ESB is connecting to a queue named
The topic is commented out since it is not required in this scenario. However, in order to avoid getting the
javax.naming.NameNotFoundException:TopicConnectionFactoryexception during server startup, we will maintain the
You can now start the WSO2 ESB server and configure the JMS inbound endpoint.
Configure the JMS inbound listener
Configure the JMS inbound listener in the ESB by using the management console:
- Ensure that WSO2 MB is still running.
- Open a command line terminal (or a shell in Linux) and navigate to the
- Execute one of the following commands to start the ESB:
- On Linux/Mac OS:
- On Linux/Mac OS:
- Open the management console of the ESB (from https://10.100.5.12:9443/carbon) and click Inbound Endpoints (in the Main menu) to start creating the endpoint. Listed below are the values you need to provide:
Endpoint Name: jms_inbound
Error Sequence: fault
For more information on the JMS configuration parameters given above, see JMS Connection Factory Parameters.
Click Save once you have entered all the values as shown below.
Following is a sample JMS inbound listener configuration:Sample JMS Inbound Endpoint
Now you have an instance of WSO2 MB and an ESB inbound endpoint configured and running. You can verify this by checking the log in the ESB startup terminal.