Skip to main content
Version: 1.0

ActiveMQ Maintenance

This chapter is special guide for ActiveMQ maintenance and settings. And you can refer to Administrator and Steps after installing for some general settings that including: Configure Domain, HTTPS Setting, Migration, Web Server configuration, Docker Setting, Database connection, Backup & Restore...

Maintenance guide​

Backup and Restore​

Upgrade​

ActiveMQ upgrade is similar to installation, you can upgrade it by the following steps

  1. Prepare for upgrade 
    docker exec -it activemq bash
    # stop ActiveMQ service
    systemctl stop activemq

    # rename the dir of ActiveMQ for backup
    mv /opt/activemq  /opt/activemqBK
  2. Download ActiveMQ and upload it to the directory /opt after unzip it, then renamed the directory to activemq
  3. Run the following modify permissions separately 
    chown -R activemq. /opt/activemq
    chmod 640  /opt/activemq/examples/stomp/php/*
    chmod +x /opt/activemq/bin/activemq
  4. Restart the ActiveMQ Service

Troubleshoot​

In addition to the ActiveMQ issues listed below, you can refer to Troubleshoot + FAQ to get more.

ActiveMQ service can't start?​

  1. Use the debug mode of activemq console and you can see the errors

    docker exec -it activemq bash
    /opt/activemq/bin/activemq

  2. Search the keywords Failed or error in the log file: /opt/activemq/data/activemq.log

  3. The most common reasons are as follows:

    • The hostname have "." string, e.g: activemq5.6, you must rename it and restart the service by the following commands
    hostnamectl set-hostname activemq
    systemctl restart activemq
    • Java environment variable problem. you can use the command echo $JAVA_HOME or which java to check it

FAQ​

What the difference between Active Classic and ActiveMQ Artemis?​

ActiveMQ Artemis is the next generation of ActiveMQClassic. Refer to: ActiveMQ Classic, ActiveMQ Artemis

How can I enable the debug mode of ActiveMQ service?​

docker exec -it activemq bash  
systemctl stop activemq
/opt/activemq/bin/activemq console

How can I log out ActiveMQ console?​

coming soon...

Is the Tomcat included in the ActiveMQ directory?​

Yes, ActiveMQ integrated the Tomcat

Is it possible to modify the source path of ActiveMQ?​

Yes, but you should reset the PATH of ActiveMQ by the following command

echo 'export PATH="$PATH:/opt/activemq/bin"' >> /etc/profile

How to change the permissions of file system?​

docker exec -it activemq bash
chown -R activemq.activemq /opt/activemq
find /opt/activemq -type d -exec chmod 750 {} \;
find /opt/activemq -type f -exec chmod 640 {} \;