Installing Apache ActiveMQ for ESB on Windows

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. Apache ActiveMQ 5.0.0 or higher is required if you want to enable the WSO2 ESB JMS transport and try out JMS samples.

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

Note

See ESB Installation Prerequisites for the list of all applications necessary to install and work with WSO2 ESB, and links to them.

Follow the instructions below to install Apache ActiveMQ on Windows.

Step 1. Download Apache ActiveMQ

1. Open a Web browser and access the following URL:

http://activemq.apache.org/

2. Apache ActiveMQ home page opens. There is the link to the latest version download on the homepage. Follow it.

3. The link to the latest stable version stands alone from the general list at the top of the page. Follow the link.

4. Go to the "Getting the Binary Distributions" part of the page and follow the download link for Windows.

5. The link redirects to the page suggesting a mirror site for the download. Follow the link on the page.

6. The download dialog opens.

7. Click "OK."

8. The download starts.

Step 2. Extract the Archive

After the download is complete, extract files to the user-defined folder. For example, C:\WSO2\apache-activemq-5.5.0.

Step 3. Run Apache ActiveMQ

Follow the instructions below to run Apache ActiveMQ.

1. Click "Start" "Run."

2. Type "cmd" without quotes and click "OK" to access Windows command prompt (CMD).

3. In the opened CMD window, type the following command to change current directory to the ActiveMQ installation directory:

cd <activemq_install_dir>

where "<activemq_install_dir>" is the directory where ActiveMQ files where extracted to, for example, C:\WSO2\apache-activemq-5.5.0.

4. Press "Enter."

5. Execute the following command to run ActiveMQ:

bin\activemq

6. Operation log is displayed.

7. Apache ActiveMQ is running.

Step 4. 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 Windows from Binary Distribution for instructions on WSO2 ESB installation.