2.11. Upgrading a broker instance from 7.11.x to 7.12.x

Procedure

1. Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive.

2. Change the owner of the archive that you downloaded to the same user that owns the AMQ Broker installation to be upgraded. The following example shows a user called amq-broker.

   sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip

3. Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat.

   sudo mv amq-broker-7.x.x-bin.zip /opt/redhat

4. As the directory owner, extract the contents of the compressed archive. In the following example, the user amq-broker extracts the archive using the unzip command.

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.x.x-bin.zip

   注意

   The contents of the latest archive are extracted to a directory called apache-artemis-2.33.0.redhat-00013 in your current directory.

5. If the broker is running, stop it.

   <broker_instance_dir>/bin/artemis stop

6. (Optional) Note the current version of the broker. After the broker stops, you see a line similar to the one below at the end of the <broker_instance_dir>/log/artemis.log file.

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.28.0.redhat-00019 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

7. Back up the instance directory of the broker by copying it to the home directory of the current user.

   cp -r <broker_instance_dir> ~/

8. Change to directory to which you extracted the contents of the compressed archive.

   cd /opt/redhat/apache-artemis-2.33.0.redhat-00013/bin

9. Run the artemis upgrade command to upgrade your existing broker. The following example upgrades a broker instance in the /var/opt/amq-broker/mybroker directory.

   ./artemis upgrade /var/opt/amq-broker/mybroker

   The artemis upgrade command completes the following steps to upgrade the broker.

   • Makes a backup of each file it modifies in an old-config-bkp.<n> subdirectory of the broker instance directory for the broker that you are upgrading.
   • Sets the ARTEMIS_HOME property in the <broker_instance_dir>/etc/artemis.profile file to the new directory created when you extracted the archive.

10. Start the upgraded broker.

    <broker_instance_dir>/bin/artemis run

11. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the <broker_instance_dir>/log/artemis.log file. Find lines similar to the ones below. Note the new version number that appears in the log after the broker starts.

    2023-02-08 20:53:50,128 INFO  [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server version 2.33.0.redhat-00013
    2023-02-08 20:53:51,077 INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.33.0.redhat-00013 [0.0.0.0, nodeID=be02a2b2-3e42-11ec-9b8a-4c796e887ecb]

Procedure

1. Follow the instructions provided in Downloading the AMQ Broker archive to download the AMQ Broker archive.
2. Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker.

3. Extract the contents of the archive. Right-click the .zip file and select Extract All.

   注意

   The contents of the latest archive are extracted to a folder called apache-artemis-2.33.0.redhat-00013 in the current folder.

4. If the broker is running, stop it.

   <broker_instance_dir>\bin\artemis-service.exe stop

5. (Optional) Note the current version of the broker. After the broker stops, you see a line similar to the one below at the end of the <broker_instance_dir>\log\artemis.log file.

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.28.0.redhat-00019[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

6. Back up the broker using a file manager.

   1. Right-click the <broker_instance_dir> folder and select Copy.
   2. Right-click in the same window and select Paste.

7. Change to directory to which you extracted the contents of the compressed archive. For example:

   cd \redhat\amq-broker\apache-artemis-2.33.0.redhat-00013\bin

8. Run the artemis upgrade command to upgrade your existing broker. The following example upgrades the broker instance in the C:\redhat\amq-broker\mybroker directory.

   artemis upgrade C:\redhat\amq-broker\mybroker

   The artemis upgrade command completes the following steps to upgrade the broker.

   • Makes a backup of each file it modifies in an old-config-bkp.<n> subdirectory of the broker instance directory for the broker that you are upgrading.
   • Sets the ARTEMIS_HOME property in the <broker_instance_dir>\etc\artemis.cmd.profile file to the new directory created when you extracted the archive.

9. Start the upgraded broker.

   <broker_instance_dir>\bin\artemis-service.exe start

10. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the <broker_instance_dir>\log\artemis.log file. Find two lines similar to the ones below. Note the new version number that appears in the log when the broker is live.

    2023-02-08 20:53:50,128 INFO  [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server version 2.33.0.redhat-00013
    2023-02-08 20:53:51,077 INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.33.0.redhat-00013 [0.0.0.0, nodeID=be02a2b2-3e42-11ec-9b8a-4c796e887ecb]