This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Configuring with ActiveMQ

This section describes how to configure the JMS transport of the Business Process profile in WSO2 Enterprise Integrator (WSO2 EI) with ActiveMQ.

Follow the instructions below to set up and configure.

  1. Download, set up, and start Apache ActiveMQ.   
  2. Follow the Installation Guide and set up WSO2 EI.

    Do not start WSO2 EI at this point. ActiveMQ should be up and running before starting WSO2 EI.

  3.  Copy the following client libraries from the   <ACTIVEMQ_HOME>/lib directory  to the  < EI_HOME>/lib  directory.   

             ActiveMQ 5.8.0 and above 

    • activemq-broker-5.8.0.jar
    • activemq-client-5.8.0.jar
    • activemq-kahadb-store-5.8.0.jar 
    • geronimo-jms_1.1_spec-1.1.1.jar
    • geronimo-j2ee-management_1.1_spec-1.0.1.jar
    • geronimo-jta_1.0.1B_spec-1.0.1.jar
    • hawtbuf-1.9.jar
    • Slf4j-api-1.6.6.jar
    • activeio-core-3.1.4.jar (available in <ACTIVEMQ_HOME>/lib/optional folder) 
     

           Earlier version of ActiveMQ

    • activemq-core-5.5.1.jar

    • geronimo-j2ee-management_1.0_spec-1.0.jar

    • geronimo-jms_1.1_spec-1.1.1.jar

  4. Enable the JMS transport listener and sender.

    Note

    When you need to listen to a JMS queue you need to enable the JMS transport listener, and when you need to send messages to a JMS queue you need to enable the JMS transport sender. 

  5. Start ActiveMQ by navigating to <ACTIVEMQ_HOME>/bin folder and executing ./activemq console(on Linux/OSX) or activemq start(on Windows).

  6. Start the business process profile of WSO2 EI by navigating to <EI_HOME>/wso2/business-process/bin folder and executing ./wso2server.sh(on Linux/OSX) or wso2server.bat(on Windows).

If you are using ActiveMQ version 5.12.0 or later, you need to start WSO2 EI with the following command:

./integrator.sh -Dorg.apache.activemq.SERIALIZABLE_PACKAGES="*"

Now you have configured the JMS transport of the Business Process profile in WSO2 EI with ActiveMQ.