Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

Ce contenu n'est pas disponible dans la langue sélectionnée.

Chapter 1. Upgrading Your Broker

1.1. About Upgrades
Copier lien

Red Hat releases new versions of AMQ Broker to the Customer Portal. Update your brokers to the newest version to ensure that you have the latest enhancements and fixes. In general, Red Hat releases a new version of AMQ Broker in one of three ways:

Major Release
A major upgrade or migration is required when an application is transitioned from one major release to the next, for example, from AMQ Broker 6 to AMQ Broker 7. This type of upgrade is not addressed in this guide. For instructions on how to upgrade from previous releases of AMQ Broker, see Migrating to Red Hat AMQ 7.
Minor Release
AMQ Broker periodically provides minor releases, which are updates that include new features, as well as bug and security fixes. If you plan to upgrade from one AMQ Broker minor release to another, for example, from AMQ Broker 7.0 to AMQ Broker 7.1, code changes should not be required for applications that do not use private, unsupported, or tech preview components.
Micro Release
AMQ Broker also periodically provides micro releases that contain minor enhancements and fixes. Micro releases increment the minor release version by the last digit, for example from 7.0.1 to 7.0.2. A micro release should not require code changes, however, some releases may require configuration changes.

1.2. Upgrading a Broker Instance from 7.0.x to 7.0.y
Copier lien

The procedure for upgrading AMQ Broker from one version of 7.0 to another is similar to the one for installation: you download an archive from the Customer Portal and then extract it.

The following subsections describe how to upgrade a 7.0.x broker for different operating systems.

1.2.1. Upgrading from 7.0.x to 7.0.y on Linux
Copier lien

The name of the archive that you download could differ from what is used in the following examples.

Prerequisites

  • Before upgrading AMQ Broker, review the release notes for the target release.

    The release notes describe important enhancements, known issues, and changes to behavior in the target release.

    For more information, see the AMQ Broker 7.0 Release Notes.

Procedure

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

  2. Change the owner of the archive to the same user that owns the AMQ Broker installation to be upgraded. 

    sudo chown amq-broker:amq-broker jboss-amq-7.x.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  3. Move the archive to the directory created during the original installation of AMQ Broker. In the following example, the directory /opt/redhat is used. 

    sudo mv jboss-amq-7.x.x.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

  4. As the directory owner, extract the contents of the compressed archive. The archive is kept in a compressed format. In the following example, the user amq-broker extracts the archive by using the unzip command. 

    su - amq-broker
cd /opt/redhat
unzip jboss-amq-7.x.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. Stop the broker if it is running. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (Optional) Note the current version of the broker. After the broker stops, a line similar to the one below is displayed at the end of its log file, which can be found at BROKER_INSTANCE_DIR/log/artemis.log. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file to set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME='/opt/redhat/jboss-amq-7.x.x-redhat-1'
    Copy to Clipboard Toggle word wrap

  9. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  10. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the log file BROKER_INSTANCE_DIR/log/artemis.log and find two lines similar to the ones below. Note the new version number that appears in the log after the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]
    Copy to Clipboard Toggle word wrap

1.2.2. Upgrading from 7.0.x to 7.0.y on Windows
Copier lien

Prerequisites

  • Before upgrading AMQ Broker, review the release notes for the target release.

    The release notes describe important enhancements, known issues, and changes to behavior in the target release.

    For more information, see the AMQ Broker 7.0 Release Notes.

Procedure

  1. Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading 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 file contents into the directory by right-clicking on the zip file and choosing Extract All.

  4. Stop the broker if it is running by entering the following command. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker by using a file manager.

    1. Right click on the BROKER_INSTANCE_DIR folder and select Copy.
    2. Right click in the same window and select Paste.

  6. (Optional) Note the current version of the broker. After the broker stops, a line similar to the one below is displayed at the end of its log file, which can be found at BROKER_INSTANCE_DIR\log\artemis.log. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile configuration file to set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  9. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the log file BROKER_INSTANCE_DIR\log\artemis.log and find two lines similar to the ones below. Note the new version number that appears in the log after the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]
    Copy to Clipboard Toggle word wrap

1.3. Upgrading a Broker instance from 7.0.x to 7.1.0
Copier lien

AMQ Broker 7.1.0 includes configuration files and settings that were not included with previous versions. Upgrading a broker instance from 7.0.x to 7.1.0 requires adding these new files and settings to your existing 7.0.x broker instances. The following subsections describe how to upgrade a 7.0.x broker instance to 7.1.0 for different operating systems.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

1.3.1. Upgrading from 7.0.x to 7.1.0 on Linux
Copier lien

Before you can upgrade a 7.0.x broker, you need to install Red Hat AMQ Broker 7.1.0 and create a temporary broker instance. This will generate the 7.1.0 configuration files required to upgrade a 7.0.x broker.

Prerequisites

  • Before upgrading AMQ Broker, review the release notes for the target release.

    The release notes describe important enhancements, known issues, and changes to behavior in the target release.

    For more information, see the AMQ Broker 7.1 Release Notes.

  • Before upgrading your 7.0.x brokers, you must first install version 7.1.

    For steps on installing 7.1 on Linux, see Installing AMQ Broker.

Procedure

  1. If it is running, stop the 7.0.x broker you want to upgrade: 

    $ BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  3. Open the file artemis.profile in the BROKER_INSTANCE_DIR/etc/ directory of the 7.0.x broker.

    1. Update the ARTEMIS_HOME property so that its value refers to the installation directory for AMQ Broker 7.1.0: 

      ARTEMIS_HOME="7.1.0_INSTALL_DIR"
      Copy to Clipboard Toggle word wrap

    2. On the line below the one you updated, add the property ARTEMIS_INSTANCE_URI and assign it a value that refers to the 7.0.x broker instance directory: 

      ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"
      Copy to Clipboard Toggle word wrap

    3. Update the JAVA_ARGS property by adding the jolokia.policyLocation parameter and assigning it the following value: 

      -Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
      Copy to Clipboard Toggle word wrap

  4. Create a 7.1.0 broker instance. The creation procedure generates the configuration files required to upgrade from 7.0.x to 7.1.0. In the following example, note that the instance is created in the directory upgrade_tmp: 

    $ 7.1.0_INSTALL_DIR/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
    Copy to Clipboard Toggle word wrap

  5. Copy configuration files from the etc directory of the temporary 7.1.0 instance into the BROKER_INSTANCE_DIR/etc/ directory of the 7.0.x broker.

    1. Copy the management.xml file: 

      $ cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/management.xml 7.0_BROKER_INSTANCE_DIR/etc/
      Copy to Clipboard Toggle word wrap

    2. Copy the jolokia-access.xml file: 

      $ cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/jolokia-access.xml 7.0_BROKER_INSTANCE_DIR/etc/
      Copy to Clipboard Toggle word wrap

  6. Open up the bootstrap.xml file in the BROKER_INSTANCE_DIR/etc/ directory of the 7.0.x broker.

    1. Comment out or delete the following two lines: 

      <app url="jolokia" war="jolokia.war"/>
<app url="hawtio" war="hawtio-no-slf4j.war"/>
      Copy to Clipboard Toggle word wrap

    2. Add the following to replace the two lines removed in the previous step: 

      <app url="console" war="console.war"/>
      Copy to Clipboard Toggle word wrap

  7. Start the broker that you upgraded: 

    $ BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

Additional Resources

For more information about creating an instance of the broker, see Creating a broker instance.

1.3.2. Upgrading from 7.0.x to 7.1.0 on Windows
Copier lien

Before you can upgrade a 7.0.x broker, you need to install Red Hat AMQ Broker 7.1.0 and create a temporary broker instance. This will generate the 7.1.0 configuration files required to upgrade a 7.0.x broker.

Prerequisites

  • Before upgrading AMQ Broker, review the release notes for the target release.

    The release notes describe important enhancements, known issues, and changes to behavior in the target release.

    For more information, see the AMQ Broker 7.1 Release Notes.

  • Before upgrading your 7.0.x brokers, you must first install version 7.1.

    For steps on installing 7.1 on Windows, see Installing AMQ Broker.

Procedure

  1. If it is running, stop the 7.0.x broker you want to upgrade: 

    > BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  2. Back up the instance directory of the broker by using a file manager.

    1. Right click on the BROKER_INSTANCE_DIR folder and select Copy.
    2. Right click in the same window and select Paste.

  3. Open the file artemis.profile in the BROKER_INSTANCE_DIR/etc/ directory of the 7.0.x broker.

    1. Update the ARTEMIS_HOME property so that its value refers to the installation directory for AMQ Broker 7.1.0: 

      ARTEMIS_HOME="7.1.0_INSTALL_DIR"
      Copy to Clipboard Toggle word wrap

    2. On the line below the one you updated, add the property ARTEMIS_INSTANCE_URI and assign it a value that refers to the 7.0.x broker instance directory: 

      ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"
      Copy to Clipboard Toggle word wrap

    3. Update the JAVA_ARGS property by adding the jolokia.policyLocation parameter and assigning it the following value: 

      -Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
      Copy to Clipboard Toggle word wrap

  4. Create a 7.1.0 broker instance. The creation procedure generates the configuration files required to upgrade from 7.0.x to 7.1.0. In the following example, note that the instance is created in the directory upgrade_tmp: 

    > 7.1.0_INSTALL_DIR/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
    Copy to Clipboard Toggle word wrap

  5. Copy configuration files from the etc directory of the temporary 7.1.0 instance into the BROKER_INSTANCE_DIR/etc/ directory of the 7.0.x broker.

    1. Copy the management.xml file: 

      > cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/management.xml 7.0_BROKER_INSTANCE_DIR/etc/
      Copy to Clipboard Toggle word wrap

    2. Copy the jolokia-access.xml file: 

      > cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/jolokia-access.xml 7.0_BROKER_INSTANCE_DIR/etc/
      Copy to Clipboard Toggle word wrap

  6. Open up the bootstrap.xml file in the BROKER_INSTANCE_DIR/etc/ directory of the 7.0.x broker.

    1. Comment out or delete the following two lines: 

      <app url="jolokia" war="jolokia.war"/>
<app url="hawtio" war="hawtio-no-slf4j.war"/>
      Copy to Clipboard Toggle word wrap

    2. Add the following to replace the two lines removed in the previous step: 

      <app url="console" war="console.war"/>
      Copy to Clipboard Toggle word wrap

  7. Start the broker that you upgraded: 

    > BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

Additional Resources

For more information about creating an instance of the broker, see Creating a broker instance.

1.4. Upgrading a Broker instance from 7.1.x to 7.2.0
Copier lien

AMQ Broker 7.2.0 includes configuration files and settings that were not included with 7.0.x versions. If you are running 7.0.x instances, you must first upgrade those broker instances from 7.0.x to 7.1.0 before upgrading to 7.2.0. The following subsections describe how to upgrade a 7.1.x broker instance to 7.2.0 for different operating systems.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

1.4.1. Upgrading from 7.1.x to 7.2.0 on Linux
Copier lien

Note

The name of the archive that you download could differ from what is used in the following examples.

Procedure

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

  2. Change the owner of the archive to the same user that owns the AMQ Broker installation to be upgraded. 

    sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  3. Move the archive to the directory created during the original installation of AMQ Broker. In the following example, the directory /opt/redhat is used. 

    sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

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

    su - amq-broker
cd /opt/redhat
unzip jboss-amq-7.x.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. Stop the broker if it is running. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (Optional) Note the current version of the broker. After the broker stops, a line similar to the one below is displayed at the end of its log file, which can be found at BROKER_INSTANCE_DIR/log/artemis.log. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.5.0.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file to set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
    Copy to Clipboard Toggle word wrap

  9. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  10. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the log file BROKER_INSTANCE_DIR/log/artemis.log and find two lines similar to the ones below. Note the new version number that appears in the log after the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.5.0.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR/etc/artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the etc/ and data/ directories within the broker instance’s directory.

1.4.2. Upgrading from 7.1.x to 7.2.0 on Windows
Copier lien

Procedure

  1. Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading 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 file contents into the directory by right-clicking on the zip file and choosing Extract All.

  4. Stop the broker if it is running by entering the following command. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker by using a file manager.

    1. Right click on the BROKER_INSTANCE_DIR folder and select Copy.
    2. Right click in the same window and select Paste.

  6. (Optional) Note the current version of the broker. After the broker stops, a line similar to the one below is displayed at the end of its log file, which can be found at BROKER_INSTANCE_DIR\log\artemis.log. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.0.0.amq-700005-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd and BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration files to set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  9. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the log file BROKER_INSTANCE_DIR\log\artemis.log and find two lines similar to the ones below. Note the new version number that appears in the log after the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.5.0.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR\etc\artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the \etc and \data directories within the broker instance’s directory.

1.5. Upgrading a Broker instance from 7.2.x to 7.3.0
Copier lien

The following subsections describe how to upgrade a 7.2.x broker instance to 7.3.0 for different operating systems.

1.5.1. Resolve exception due to deprecated dispatch console
Copier lien

Starting in version 7.3.0, AMQ Broker no longer ships with the Hawtio dispatch console plugin dispatch-hawtio-console.war. Previously, the dispatch console was used to manage AMQ Interconnect. However, AMQ Interconnect now uses its own, standalone web console. This change affects the upgrade procedures in the sections that follow.

If you take no further action before upgrading your broker instance to 7.3.0, the upgrade process produces an exception that looks like the following: 

2019-04-11 18:00:41,334 WARN  [org.eclipse.jetty.webapp.WebAppContext] Failed startup of context o.e.j.w.WebAppContext@1ef3efa8{/dispatch-hawtio-console,null,null}{/opt/amqbroker/amq-broker-7.3.0/web/dispatch-hawtio-console.war}: java.io.FileNotFoundException: /opt/amqbroker/amq-broker-7.3.0/web/dispatch-hawtio-console.war.
Copy to Clipboard Toggle word wrap

You can safely ignore the preceding exception without affecting the success of your upgrade.

However, if you would prefer not to see this exception during your upgrade, you must first remove a reference to the Hawtio dispatch console plugin in the bootstrap.xml file of your existing broker instance. The bootstrap.xml file is in the {instance_directory}/etc/ directory of your broker instance. The following example shows some of the contents of the bootstrap.xml file for a AMQ Broker 7.2.4 instance: 

<broker xmlns="http://activemq.org/schema">
....
   <!-- The web server is only bound to localhost by default -->
   <web bind="http://localhost:8161" path="web">
       <app url="redhat-branding" war="redhat-branding.war"/>
       <app url="artemis-plugin" war="artemis-plugin.war"/>
       <app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war"/>
       <app url="console" war="console.war"/>
   </web>
</broker>
Copy to Clipboard Toggle word wrap

To avoid an exception when upgrading AMQ Broker to version 7.3.0, delete the line <app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war"/>, as shown in the preceding example. Then, save the modified bootstrap file and start the upgrade process, as described in the sections that follow.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

1.5.2. Upgrading from 7.2.x to 7.3.0 on Linux
Copier lien

Note

The name of the archive that you download could differ from what is used in the following examples.

Procedure

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

  2. Change the owner of the archive to the same user that owns the AMQ Broker installation to be upgraded. 

    sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  3. Move the archive to the directory created during the original installation of AMQ Broker. In the following example, the directory /opt/redhat is used. 

    sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

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

    su - amq-broker
cd /opt/redhat
unzip jboss-amq-7.x.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. Stop the broker if it is running. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (Optional) Note the current version of the broker. After the broker stops, a line similar to the one below is displayed at the end of its log file, which can be found at BROKER_INSTANCE_DIR/log/artemis.log. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.6.3.amq-720001-redhat-1 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file to set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
    Copy to Clipboard Toggle word wrap

  9. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  10. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the log file BROKER_INSTANCE_DIR/log/artemis.log and find two lines similar to the ones below. Note the new version number that appears in the log after the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR/etc/artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the etc/ and data/ directories within the broker instance’s directory.

1.5.3. Upgrading from 7.2.x to 7.3.0 on Windows
Copier lien

Procedure

  1. Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading 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 file contents into the directory by right-clicking on the zip file and choosing Extract All.

  4. Stop the broker if it is running by entering the following command. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker by using a file manager.

    1. Right click on the BROKER_INSTANCE_DIR folder and select Copy.
    2. Right click in the same window and select Paste.

  6. (Optional) Note the current version of the broker. After the broker stops, a line similar to the one below is displayed at the end of its log file, which can be found at BROKER_INSTANCE_DIR\log\artemis.log. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.6.3.amq-720001-redhat-1 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd and BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration files to set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd configuration file to set the JAVA_ARGS environment variable to reference the correct log manager version. 

    JAVA_ARGS=NEW_INSTALL_DIR\lib\jboss-logmanager-2.0.3.Final-redhat-1.jarNEW_INSTALL_DIR\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar
    Copy to Clipboard Toggle word wrap

  9. Edit the BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration file to set the bootstrap class path start argument to reference the correct log manager version. 

    <startargument>Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar</startargument>
    Copy to Clipboard Toggle word wrap

  10. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  11. (Optional) Confirm that the broker is running and that the version has changed. After starting the broker, open the log file BROKER_INSTANCE_DIR\log\artemis.log and find two lines similar to the ones below. Note the new version number that appears in the log after the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR\etc\artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the \etc and \data directories within the broker instance’s directory.

1.6. Upgrading a Broker instance from 7.3.0 to 7.4.0
Copier lien

The following subsections describe how to upgrade a 7.3.0 broker instance to 7.4.0 for different operating systems.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

1.6.1. Upgrading from 7.3.0 to 7.4.0 on Linux
Copier lien

Note

The name of the archive that you download could differ from what is used in the following examples.

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 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.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  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.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

  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.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (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.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file.

    1. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-redhat-1'
      Copy to Clipboard Toggle word wrap

    2. Edit the JAVA_ARGS property. Add the bootstrap class path argument, which references a dependent file for the log manager. 

      -Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.1.Final-redhat-00001.jar
      Copy to Clipboard Toggle word wrap

  9. Edit the BROKER_INSTANCE_DIR/etc/bootstrap.xml configuration file. In the <web> configuration element, add a reference to the metrics plugin file for AMQ Broker. 

    <app url="metrics" war="metrics.war"/>
    Copy to Clipboard Toggle word wrap

  10. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  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 two lines similar to the ones below. Note the new version number that appears in the log when the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR/etc/artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the etc/ and data/ directories within the broker instance’s directory.

1.6.2. Upgrading from 7.3.0 to 7.4.0 on Windows
Copier lien

Procedure

  1. Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading 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 file contents into the installation directory. Right-click the .zip file and select Extract All.

  4. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker using a file manager.

    1. Right click the BROKER_INSTANCE_DIR folder. Select Copy.
    2. Right click in the same window. Select Paste.

  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] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd and BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration files. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd configuration file. Set the JAVA_ARGS environment variable to reference the correct log manager version and dependent file. 

    JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final-redhat-00001.jar
    Copy to Clipboard Toggle word wrap

  9. Edit the BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration file. Set the bootstrap class path start argument to reference the correct log manager version and dependent file. 

    <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.1.Final-redhat-00001.jar</startargument>
    Copy to Clipboard Toggle word wrap

  10. Edit the BROKER_INSTANCE_DIR\etc\bootstrap.xml configuration file. In the <web> configuration element, add a reference to the metrics plugin file for AMQ Broker. 

    <app url="metrics" war="metrics.war"/>
    Copy to Clipboard Toggle word wrap

  11. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  12. (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. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR\etc\artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the \etc and \data directories within the broker instance’s directory.

1.7. Upgrading a Broker instance from 7.4.0 to 7.4.x
Copier lien

Important

AMQ Broker 7.4 has been designated as a Long Term Support (LTS) release version. Bug fixes and security advisories will be made available for AMQ Broker 7.4 in a series of micro releases (7.4.1, 7.4.2, and so on) for a period of at least 12 months. This means that you will be able to get recent bug fixes and security advisories for AMQ Broker without having to upgrade to a new minor release. For more information, see Long Term Support for AMQ Broker.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

The following subsections describe how to upgrade a 7.4.0 broker instance to 7.4.x for different operating systems.

1.7.1. Upgrading from 7.4.0 to 7.4.x on Linux
Copier lien

Note

The name of the archive that you download could differ from what is used in the following examples.

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 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.4.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  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.4.x.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

  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.4.x.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (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.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME='/opt/redhat/amq-broker-7.4.x-redhat-1'
    Copy to Clipboard Toggle word wrap

  9. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  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. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR/etc/artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the etc/ and data/ directories within the broker instance’s directory.

1.7.2. Upgrading from 7.4.0 to 7.4.x on Windows
Copier lien

Procedure

  1. Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading 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 file contents into the installation directory. Right-click the .zip file and select Extract All.

  4. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker using a file manager.

    1. Right click the BROKER_INSTANCE_DIR folder. Select Copy.
    2. Right click in the same window. Select Paste.

  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] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd and BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration files. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  9. (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. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR\etc\artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the \etc and \data directories within the broker instance’s directory.

1.8. Upgrading a Broker instance from 7.4.x to 7.5.0
Copier lien

The following subsections describe how to upgrade a 7.4.x broker instance to 7.5.0 for different operating systems.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

1.8.1. Upgrading from 7.4.x to 7.5.0 on Linux
Copier lien

Note

The name of the archive that you download could differ from what is used in the following examples.

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 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.5.0.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  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.5.0.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

  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.5.0.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (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.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file.

    1. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.5-redhat-1'
      Copy to Clipboard Toggle word wrap

    2. Edit the JAVA_ARGS property. Add the bootstrap class path argument, which references a dependent file for the log manager. 

      -Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00001.jar
      Copy to Clipboard Toggle word wrap

  9. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  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. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR/etc/artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the etc/ and data/ directories within the broker instance’s directory.

1.8.2. Upgrading from 7.4.x to 7.5.0 on Windows
Copier lien

Procedure

  1. Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading 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 file contents into the installation directory. Right-click the .zip file and select Extract All.

  4. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker using a file manager.

    1. Right click the BROKER_INSTANCE_DIR folder. Select Copy.
    2. Right click in the same window. Select Paste.

  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] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd and BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration files. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd configuration file. Set the JAVA_ARGS environment variable to reference the correct log manager version and dependent file. 

    JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00001.jar
    Copy to Clipboard Toggle word wrap

  9. Edit the BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration file. Set the bootstrap class path start argument to reference the correct log manager version and dependent file. 

    <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00001.jar</startargument>
    Copy to Clipboard Toggle word wrap

  10. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  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 two lines similar to the ones below. Note the new version number that appears in the log when the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR\etc\artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the \etc and \data directories within the broker instance’s directory.

1.9. Upgrading a Broker instance from 7.5.0 to 7.6.0
Copier lien

The following subsections describe how to upgrade a 7.5.0 broker instance to 7.6.0 for different operating systems.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

1.9.1. Upgrading from 7.5.0 to 7.6.0 on Linux
Copier lien

Note

The name of the archive that you download could differ from what is used in the following examples.

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 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.6.0.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  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.6.0.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

  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.6.0.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (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.9.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file.

    1. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.6-redhat-1'
      Copy to Clipboard Toggle word wrap

    2. Edit the JAVA_ARGS property. Add the bootstrap class path argument, which references a dependent file for the log manager. 

      -Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
      Copy to Clipboard Toggle word wrap

  9. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  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. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR/etc/artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the etc/ and data/ directories within the broker instance’s directory.

1.9.2. Upgrading from 7.5.0 to 7.6.0 on Windows
Copier lien

Procedure

  1. Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading 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 file contents into the installation directory. Right-click the .zip file and select Extract All.

  4. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker using a file manager.

    1. Right click the BROKER_INSTANCE_DIR folder. Select Copy.
    2. Right click in the same window. Select Paste.

  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] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd and BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration files. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd configuration file. Set the JAVA_ARGS environment variable to reference the correct log manager version and dependent file. 

    JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar
    Copy to Clipboard Toggle word wrap

  9. Edit the BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration file. Set the bootstrap class path start argument to reference the correct log manager version and dependent file. 

    <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>
    Copy to Clipboard Toggle word wrap

  10. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  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 two lines similar to the ones below. Note the new version number that appears in the log when the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR\etc\artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the \etc and \data directories within the broker instance’s directory.

1.10. Upgrading a Broker instance from 7.6.0 to 7.7.0
Copier lien

The following subsections describe how to upgrade a 7.6.0 broker instance to 7.7.0 for different operating systems.

Important

Starting with AMQ Broker 7.1.0, you can access the AMQ Management Console only from the local host by default. You must modify the configuration in BROKER_INSTANCE_DIR/etc/jolokia-access.xml to enable remote access. For more information, see Securing AMQ Management Console and AMQ Broker Connections.

1.10.1. Upgrading from 7.6.0 to 7.7.0 on Linux
Copier lien

Note

The name of the archive that you download could differ from what is used in the following examples.

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 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.7.0.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  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.7.0.redhat-1.zip /opt/redhat
    Copy to Clipboard Toggle word wrap

  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.7.0.redhat-1.zip
    Copy to Clipboard Toggle word wrap

  5. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR/bin/artemis stop
    Copy to Clipboard Toggle word wrap

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

    cp -r BROKER_INSTANCE_DIR ~/
    Copy to Clipboard Toggle word wrap

  7. (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.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR/etc/artemis.profile configuration file.

    1. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. For example: 

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.7-redhat-1'
      Copy to Clipboard Toggle word wrap

    2. Locate the JAVA_ARGS property. Ensure that the bootstrap class path argument references the required version of a dependent file for the log manager, as shown below. 

      -Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
      Copy to Clipboard Toggle word wrap

  9. Edit the BROKER_INSTANCE_DIR/etc/logging.properties configuration file.

    1. On the list of additional loggers to be configured, include the org.apache.activemq.audit.resource resource logger that was added in AMQ Broker 7.7.0. 

      loggers=org.eclipse.jetty,org.jboss.logging,org.apache.activemq.artemis.core.server,org.apache.activemq.artemis.utils,org.apache.activemq.artemis.journal,org.apache.activemq.artemis.jms.server,org.apache.activemq.artemis.integration.bootstrap,org.apache.activemq.audit.base,org.apache.activemq.audit.message,org.apache.activemq.audit.resource
      Copy to Clipboard Toggle word wrap

    2. Before the Console handler configuration section, add a default configuration for the resource logger. 

      ..

logger.org.apache.activemq.audit.resource.level=ERROR
logger.org.apache.activemq.audit.resource.handlers=AUDIT_FILE
logger.org.apache.activemq.audit.resource.useParentHandlers=false

# Console handler configuration
..
      Copy to Clipboard Toggle word wrap

  10. Start the upgraded broker. 

    BROKER_INSTANCE_DIR/bin/artemis run
    Copy to Clipboard Toggle word wrap

  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 two lines similar to the ones below. Note the new version number that appears in the log when the broker is live. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mesq.audit.resource.handlers=AUDIT_FILE
logger.org.apache.activemq.audit.resource.useParentHandlers=false
sage Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR/etc/artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the etc/ and data/ directories within the broker instance’s directory.

1.10.2. Upgrading from 7.6.0 to 7.7.0 on Windows
Copier lien

Procedure

  1. Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading 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 file contents into the installation directory. Right-click the .zip file and select Extract All.

  4. If the broker is running, stop it. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe stop
    Copy to Clipboard Toggle word wrap

  5. Back up the broker using a file manager.

    1. Right click the BROKER_INSTANCE_DIR folder. Select Copy.
    2. Right click in the same window. Select Paste.

  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] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.11.0.redhat-00001 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
    Copy to Clipboard Toggle word wrap

  7. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd and BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration files. Set the ARTEMIS_HOME property to the new directory created when the archive was extracted. 

    ARTEMIS_HOME=NEW_INSTALL_DIR
    Copy to Clipboard Toggle word wrap

  8. Edit the BROKER_INSTANCE_DIR\etc\artemis.profile.cmd configuration file. Ensure that the JAVA_ARGS environment variable references the correct versions for the log manager and dependent file, as shown below. 

    JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar
    Copy to Clipboard Toggle word wrap

  9. Edit the BROKER_INSTANCE_DIR\bin\artemis-service.xml configuration file. Ensure that the bootstrap class path start argument references the correct versions for the log manager and dependent file, as shown below. 

    <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>
    Copy to Clipboard Toggle word wrap

  10. Edit the BROKER_INSTANCE_DIR\etc\logging.properties configuration file.

    1. On the list of additional loggers to be configured, include the org.apache.activemq.audit.resource resource logger that was added in AMQ Broker 7.7.0. 

      loggers=org.eclipse.jetty,org.jboss.logging,org.apache.activemq.artemis.core.server,org.apache.activemq.artemis.utils,org.apache.activemq.artemis.journal,org.apache.activemq.artemis.jms.server,org.apache.activemq.artemis.integration.bootstrap,org.apache.activemq.audit.base,org.apache.activemq.audit.message,org.apache.activemq.audit.resource
      Copy to Clipboard Toggle word wrap

    2. Before the Console handler configuration section, add a default configuration for the resource logger. 

      ..

logger.org.apache.activemq.audit.resource.level=ERROR
logger.org.apache.activemq.audit.resource.handlers=AUDIT_FILE
logger.org.apache.activemq.audit.resource.useParentHandlers=false

# Console handler configuration
..
      Copy to Clipboard Toggle word wrap

  11. Start the upgraded broker. 

    BROKER_INSTANCE_DIR\bin\artemis-service.exe start
    Copy to Clipboard Toggle word wrap

  12. (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. 

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
...
INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
    Copy to Clipboard Toggle word wrap

Additional Resources

  • For more information about creating an instance of the broker, see Creating a broker instance.
  • You can now store a broker instance’s configuration files and data in any custom directory, including locations outside of the broker instance’s directory. In the BROKER_INSTANCE_DIR\etc\artemis.profile file, update the ARTEMIS_INSTANCE_ETC_URI property by specifying the location of the custom directory after creating the broker instance. Previously, these configuration files and data could only be stored in the \etc and \data directories within the broker instance’s directory.
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat