×
Community Blog How to Install Apache ActiveMQ on ECS Ubuntu 18.04

How to Install Apache ActiveMQ on ECS Ubuntu 18.04

In this tutorial, we will learn how to install and configure Apache ActiveMQ on an Alibaba Cloud Elastic Compute Service (ECS) Ubuntu 18.04 server.

By Hitesh Jethva, Alibaba Cloud Community Blog author.

Introduction

Apache ActiveMQ is a free, open source message broker software written in Java. It is used for the communication between two distributed processes or applications that have different or incompatible languages. Apache ActiveMQ is designed for high-performance clustering and communication, and supports a wide range of language clients and protocols such as, Java, C, C++, Ruby and Python.

In this tutorial, we will learn how to install and configure Apache ActiveMQ on an Alibaba Cloud Elastic Compute Service (ECS) Ubuntu 18.04 server.

Prerequisites

  • A fresh Alibaba Cloud instance with Ubuntu 18.04 installed.
  • A root password is set up to your instance.

Create a new ECS instance and connect to your instance as the root user.

Once you are logged into your Ubuntu 18.04 instance, run the following command to update your base system with the latest available packages.

apt-get update -y

Install Java

Apache ActiveMQ is written in the Java language, so you will need to install Java to your instance. By default, the latest version of the Java is available in the Ubuntu 18.04 default repository. You can install it by just running the following command:

apt-get install openjdk-11-jre -y

Once the Java is installed, you can check the version of java with the following command:

java -version

You should see the following output:

openjdk version "10.0.2" 2018-07-17
OpenJDK Runtime Environment (build 10.0.2+13-Ubuntu-1ubuntu0.18.04.4)
OpenJDK 64-Bit Server VM (build 10.0.2+13-Ubuntu-1ubuntu0.18.04.4, mixed mode)

Install Apache ActiveMQ

The best way to install Apache ActiveMQ is to download their binaries from Apache official websites. You can download the Apache ActiveMQ binaries using the following command:

wget http://archive.apache.org/dist/activemq/5.15.8/apache-activemq-5.15.8-bin.tar.gz

Once the download is completed, extract the downloaded file with the following command:

tar -xvzf apache-activemq-5.15.8-bin.tar.gz

Move the extracted file to the /opt directory:

mv apache-activemq-5.15.8 /opt/activemq

You will need to create user and group named activemq that will be used to run ActiveMQ.

You can create a activemq user and group with the following command:

addgroup --quiet --system activemq
adduser --quiet --system --ingroup activemq --no-create-home --disabled-password activemq

Change the ownership of /opt/activemq directory to user activemq and group activemq:

chown -R activemq:activemq /opt/activemq

Create Systemd Service File for ActiveMQ

Next, you will need to create a systemd service file for managing ActiveMQ service. You can do it with the following command:

nano /etc/systemd/system/activemq.service

Add the following lines:

[Unit]
Description=Apache ActiveMQ
After=network.target

[Service]
Type=forking

User=activemq
Group=activemq

ExecStart=/opt/activemq/bin/activemq start
ExecStop=/opt/activemq/bin/activemq stop

[Install]
WantedBy=multi-user.target

Save and close the file, when you are finished.

Reload systemd with the following command:

systemctl daemon-reload

Start ActiveMQ service and enable it to start on boot with the following command:

systemctl start activemq
systemctl enable activemq

You can also check the status of ActiveMQ with the following command:

/opt/activemq/bin/activemq status

You should see the following output:

INFO: Loading '/opt/activemq//bin/env'
INFO: Using java '/usr/bin/java'
ActiveMQ is running (pid '17543')

Configure ActiveMQ

All the configurations are located in /opt/activemq/conf/activemq.xml file. You can change it as per your need:

nano /opt/activemq/conf/activemq.xml

You can define transport connector, storage and message limit as below:

          <systemUsage>
            <systemUsage>
                <memoryUsage>
                    <memoryUsage percentOfJvmHeap="70" />
                </memoryUsage>
                <storeUsage>
                    <storeUsage limit="100 gb"/>
                </storeUsage>
                <tempUsage>
                    <tempUsage limit="50 gb"/>
                </tempUsage>
            </systemUsage>
        </systemUsage>


        <destinationPolicy>
            <policyMap>
              <policyEntries>
                <policyEntry topic=">" >
                    <!-- The constantPendingMessageLimitStrategy is used to prevent
                         slow topic consumers to block producers and affect other consumers
                         by limiting the number of messages that are retained
                         For more information, see:

                         http://activemq.apache.org/slow-consumer-handling.html

                    -->
                  <pendingMessageLimitStrategy>
                    <constantPendingMessageLimitStrategy limit="1000"/>
                  </pendingMessageLimitStrategy>
                </policyEntry>
              </policyEntries>
            </policyMap>
        </destinationPolicy>

Save and close the file. Then, restart ActiveMQ with the following command:

systemctl restart activemq

You can check ActiveMQ process with the following command:

ps aux | grep activemq

You can also check ActiveMQ default port and admin port with the following command:

netstat -naptu | grep 61616

Access ActiveMQ Web Interface

Now, open your web browser and type the URL http://your-server-ip:8161/admin . You will be redirected to the following page:

1

Enter the default username and password as admin / admin. Then, click on the Ok button. You should see the ActiveMQ default dashboard in the following page:

2

Monitor ActiveMQ With Hawt.io

You can also monitor ActiveMQ with Hawt.io. Hawt.io is a modular web console for managing your Java stuff.

First, download the latest version of Hawt.io from their official website using the following command:

wget https://oss.sonatype.org/content/repositories/public/io/hawt/hawtio-default/2.5.0/hawtio-default-2.5.0.war

Once the download is completed, extract the downloaded file with the following command:

unzip hawtio-default-2.5.0.war -d hawtio

Move the extracted directory to the /opt/activemq/webapps/ with the following command:

mv hawtio /opt/activemq/webapps/

You will need to change ACTIVEMQ_OPTS to add hawtio options. You can do it by editing the following file:

nano /opt/activemq/bin/env

Make the following changes:

ACTIVEMQ_OPTS="$ACTIVEMQ_OPTS_MEMORY -Djava.util.logging.config.file=logging.properties -Djava.security.auth.login.config=$ACTIVEMQ_CONF/login.config -Dhawtio.realm=activemq -Dhawtio.role=admins -Dhawtio.rolePrincipalClasses=org.apache.activemq.jaas.GroupPrincipal"

Save and close the file. Then, open another file:

nano /opt/activemq/conf/jetty.xml

Make the following changes:

<bean id="rewriteHandler" class="org.eclipse.jetty.rewrite.handler.RewriteHandler">

<bean class="org.eclipse.jetty.webapp.WebAppContext">
    <property name="contextPath" value="/hawtio" />
    <property name="resourceBase" value="${activemq.home}/webapps/hawtio" />
    <property name="logUrlOnStart" value="true" />
</bean>

Save and close the file. Then, restart ActiveMQ service with the following command:

systemctl restart activemq

Next, open your web browser and type the URL http://ipaddress:8161/hawtio . You will be redirected to the Hawtio ActiveMQ dashboard in the following page:

3

0 0 0
Share on

Hiteshjethva

38 posts | 4 followers

You may also like

Comments

Hiteshjethva

38 posts | 4 followers

Related Products