How do I manually update the ActiveMQ component?

The following instructions apply to both meshIQ Track 1.5 and 1.6.

Customers who would like to manually update the Apache ActiveMQ component may follow the instructions below.

1. Stop the ActiveMQ service by using the command ./stop.sh mq in $APIN_HOME/sbin.
2. To update the ActiveMQ component, download the latest ActiveMQ 5.xx version from https://activemq.apache.org/download.
3. Unlink the current version of ActiveMQ by using the command unlink current.
4. Link the current version in $APIN_HOME/actmq using ln-s actmq 5.xx current.
5. To update the files, please follow the instructions below for Upgrading ActiveMQ to v5.17.4.
6. After all steps have been completed, restart the ActiveMQ service by using the command ./start.sh mq to apply the changes.

Upgrading ActiveMQ to v5.17.4

1. Make the following changes to $APIN_HOME/actmq/current/conf/activemq.xml.
   1. Update the <broker> element by adding schedulePeriodForDestinationPurge="300000"

   <broker xmlns="http://activemq.apache.org/schema/core" brokerName="JKMessageBus" dataDirectory="${activemq.data}" schedulePeriodForDestinationPurge="300000">

   2. (Optional.) Change brokerName in the line from step a.
   3. Within the policyEntries element found here:
      <destinationPolicy>
      <policyMap>
      <policyEntries>
      Add the following:

      <policyEntry queue="jkool.client.>" gcInactiveDestinations="true" inactiveTimoutBeforeGC="120000" sendAdvisoryIfNoConsumers="true"/>

2. The default address that the console listens on has changed. To connect to it, it must be run on a local machine. To be able to connect-to-console remotely, restore the "host" value for bean "jettyPort" from "127.0.0.1" back to "0.0.0.0" by updating line 123 of $APIN_HOME/actmq/current/conf/jetty.xml:

   <bean
       id="jettyPort" class="org.apache.activemq.web.WebConsolePort" init-method="start">
       <!-- the default port number for the web console -->
       <property name="host" value="0.0.0.0"/>
       <property name="port" value="8161"/>
   </bean>

3. Change the ActiveMQ path in $APIN_HOME/sbin/apin_env.sh as follows:
   export ACTIVEMQ_HOME=`realpath $APIN_HOME/actmq/current`