Installing Apache ActiveMQ for ESB on Linux

In order to enable the WSO2 ESB JMS transport and try out JMS samples, the ActiveMQ client libraries must be installed in the ESB classpath before you can enable the JMS transport.

Apache ActiveMQ v.4.1.0 or higher is recommended for WSO2 ESB.

In case any other JMS provider is used (e.g. Apache Qpid), install any necessary libraries and/or components.

Follow the instructions below to install Apache ActiveMQ on Linux.

Step 1. Download Apache ActiveMQ

Type the following command:

wget http://www.apache.org/dist//activemq/apache-activemq/5.5.0/apache-activemq-5.5.0-bin.tar.gz

Step 2. Extract the Archive

1. Extract the distribution archive, i.e. apache-activemq-5.5.0-bin.tar.gz to the directory you wish to install Apache ActiveMQ. These instructions assume you chose /opt. The subdirectory apache-activemq-5.5.0 will be created from the archive.

tar -zxvf apache-activemq-5.5.0-bin.tar.gz

2. If the ActiveMQ start-up script is not executable, change its permissions:

chmod 755 activemq

Step 3. Run Apache ActiveMQ

Run ActiveMQ from a command shell:

sudo sh activemq start

Step 4. Testing the Installation

ActiveMQ's default port is 61616. From another window, run netstat and search for port 61616.

netstat -an|grep 61616

The port should be opened and LISTEN on 61616.

Step 5. Monitoring ActiveMQ

There are various ways to monitor ActiveMQ. If you are on version 4.2 or later of ActiveMQ, you can then monitor ActiveMQ, using the Web Console by pointing your browser at:

http://localhost:8161/admin

Or you can use the JMX support to view the running state of ActiveMQ.

Step 6. Use Apache ActiveMQ

In case WSO2 ESB is already installed, proceed to the section for instructions on how to install client libraries in the ESB classpath to enable the JMS transport. Otherwise, go to Installing ESB on Linux and Solaris from Binary Distribution for instructions on WSO2 ESB installation.