Chapter 2. Upgrading your broker 2.1. About upgrades 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 , for example, from AMQ Broker 6 to AMQ Broker 7. This type of upgrade is not addressed in this guide. 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. 2.2. Upgrading older 7.x versions 2.2.1. Upgrading a broker instance from 7.0.x to 7.0.y 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. Upgrading from 7.0.x to 7.0.y on Linux Upgrading from 7.0.x to 7.0.y on Windows 2.2.1.1. Upgrading from 7.0.x to 7.0.y on Linux 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 Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading the AMQ Broker archive . Change the owner of the archive to the same user that owns the AMQ Broker installation to be upgraded. Move the archive to the directory created during the original installation of AMQ Broker. In the following example, the directory /opt/redhat is used. 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. Stop the broker if it is running. Back up the instance directory of the broker by copying it to the home directory of the current user. (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 . 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. Start the upgraded broker. (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. 2.2.1.2. Upgrading from 7.0.x to 7.0.y on Windows 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 Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . Stop the broker if it is running by entering the following command. Back up the broker by using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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 . 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. Start the upgraded broker. (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. 2.2.2. Upgrading a broker instance from 7.0.x to 7.1.0 AMQ Broker 7.1.0 includes configuration files and settings that were not included with 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.0.x to 7.1.0 on Linux Upgrading from 7.0.x to 7.1.0 on Windows 2.2.2.1. Upgrading from 7.0.x to 7.1.0 on Linux 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 If it is running, stop the 7.0.x broker you want to upgrade: Back up the instance directory of the broker by copying it to the home directory of the current user. Open the file artemis.profile in the <broker_instance_dir> /etc/ directory of the 7.0.x broker. Update the ARTEMIS_HOME property so that its value refers to the installation directory for AMQ Broker 7.1.0: 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: Update the JAVA_ARGS property by adding the jolokia.policyLocation parameter and assigning it the following value: 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 : 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. Copy the management.xml file: Copy the jolokia-access.xml file: Open up the bootstrap.xml file in the <broker_instance_dir> /etc/ directory of the 7.0.x broker. Comment out or delete the following two lines: Add the following to replace the two lines removed in the step: Start the broker that you upgraded: Additional Resources For more information about creating an instance of the broker, see Creating a broker instance . 2.2.2.2. Upgrading from 7.0.x to 7.1.0 on Windows 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 If it is running, stop the 7.0.x broker you want to upgrade: Back up the instance directory of the broker by using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . Open the file artemis.profile in the <broker_instance_dir> /etc/ directory of the 7.0.x broker. Update the ARTEMIS_HOME property so that its value refers to the installation directory for AMQ Broker 7.1.0: 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: Update the JAVA_ARGS property by adding the jolokia.policyLocation parameter and assigning it the following value: 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 : 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. Copy the management.xml file: Copy the jolokia-access.xml file: Open up the bootstrap.xml file in the <broker_instance_dir> /etc/ directory of the 7.0.x broker. Comment out or delete the following two lines: Add the following to replace the two lines removed in the step: Start the broker that you upgraded: Additional Resources For more information about creating an instance of the broker, see Creating a broker instance . 2.2.3. Upgrading a broker instance from 7.1.x to 7.2.0 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.1.x to 7.2.0 on Linux Upgrading from 7.1.x to 7.2.0 on Windows 2.2.3.1. Upgrading from 7.1.x to 7.2.0 on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading the AMQ Broker archive . Change the owner of the archive to the same user that owns the AMQ Broker installation to be upgraded. Move the archive to the directory created during the original installation of AMQ Broker. In the following example, the directory /opt/redhat is used. 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. Stop the broker if it is running. Back up the instance directory of the broker by copying it to the home directory of the current user. (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 . 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. Start the upgraded broker. (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. 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. 2.2.3.2. Upgrading from 7.1.x to 7.2.0 on Windows Procedure Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . Stop the broker if it is running by entering the following command. Back up the broker by using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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 . 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. Start the upgraded broker. (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. 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. 2.2.4. Upgrading a broker instance from 7.2.x to 7.3.0 The following subsections describe how to upgrade a 7.2.x broker instance to 7.3.0 for different operating systems. 2.2.4.1. Resolve exception due to deprecated dispatch console 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: 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: 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.2.x to 7.3.0 on Linux Upgrading from 7.2.x to 7.3.0 on Windows 2.2.4.2. Upgrading from 7.2.x to 7.3.0 on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading the AMQ Broker archive . Change the owner of the archive to the same user that owns the AMQ Broker installation to be upgraded. Move the archive to the directory created during the original installation of AMQ Broker. In the following example, the directory /opt/redhat is used. 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. Stop the broker if it is running. Back up the instance directory of the broker by copying it to the home directory of the current user. (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 . 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. Start the upgraded broker. (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. 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. 2.2.4.3. Upgrading from 7.2.x to 7.3.0 on Windows Procedure Download the desired archive from the Red Hat Customer Portal by following the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . Stop the broker if it is running by entering the following command. Back up the broker by using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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 . 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. 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. 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. Start the upgraded broker. (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. 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. 2.2.5. Upgrading a broker instance from 7.3.0 to 7.4.0 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.3.0 to 7.4.0 on Linux Upgrading from 7.3.0 to 7.4.0 on Windows 2.2.5.1. Upgrading from 7.3.0 to 7.4.0 on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. Edit the JAVA_ARGS property. Add the bootstrap class path argument, which references a dependent file for the log manager. 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. Start the upgraded broker. (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. 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. 2.2.5.2. Upgrading from 7.3.0 to 7.4.0 on Windows Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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. 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. 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. 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. 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. Start the upgraded broker. (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. 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. 2.3. Upgrading a broker instance from 7.4.0 to 7.4.x 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . The following subsections describe how to upgrade a 7.4.0 broker instance to 7.4.x for different operating systems. Upgrading from 7.4.0 to 7.4.x on Linux Upgrading from 7.4.0 to 7.4.x on Windows 2.3.1. Upgrading from 7.4.0 to 7.4.x on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. Start the upgraded broker. (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. 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. 2.3.2. Upgrading from 7.4.0 to 7.4.x on Windows Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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. 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. Start the upgraded broker. (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. 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. 2.4. Upgrading a broker instance from 7.4.x to 7.5.0 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.4.x to 7.5.0 on Linux Upgrading from 7.4.x to 7.5.0 on Windows 2.4.1. Upgrading from 7.4.x to 7.5.0 on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. Edit the JAVA_ARGS property. Add the bootstrap class path argument, which references a dependent file for the log manager. Start the upgraded broker. (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. 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. 2.4.2. Upgrading from 7.4.x to 7.5.0 on Windows Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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. 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. 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. 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. Start the upgraded broker. (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. 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. 2.5. Upgrading a broker instance from 7.5.0 to 7.6.0 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.5.0 to 7.6.0 on Linux Upgrading from 7.5.0 to 7.6.0 on Windows 2.5.1. Upgrading from 7.5.0 to 7.6.0 on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. Edit the JAVA_ARGS property. Add the bootstrap class path argument, which references a dependent file for the log manager. Start the upgraded broker. (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. 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. 2.5.2. Upgrading from 7.5.0 to 7.6.0 on Windows Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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. 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. 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. 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. Start the upgraded broker. (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. 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. 2.6. Upgrading a broker instance from 7.6.0 to 7.7.0 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 AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.6.0 to 7.7.0 on Linux Upgrading from 7.6.0 to 7.7.0 on Windows 2.6.1. Upgrading from 7.6.0 to 7.7.0 on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. For example: 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. Edit the <broker_instance_dir> /etc/logging.properties configuration file. 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 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 .. Start the upgraded broker. (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. 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. 2.6.2. Upgrading from 7.6.0 to 7.7.0 on Windows Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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. 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. 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. 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. Edit the <broker_instance_dir> \etc\logging.properties configuration file. 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 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 .. Start the upgraded broker. (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. 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. 2.7. Upgrading a broker instance from 7.7.0 to 7.8.0 The following subsections describe how to upgrade a 7.7.0 broker instance to 7.8.0 for different operating systems. Important Starting with AMQ Broker 7.1.0, you can access AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.7.0 to 7.8.0 on Linux Upgrading from 7.7.0 to 7.8.0 on Windows 2.7.1. Upgrading from 7.7.0 to 7.8.0 on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. For example: 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. Edit the <broker_instance_dir> /etc/bootstrap.xml configuration file. In the web element, update the name of the .war file required by AMQ Management Console in 7.8. <web bind="http://localhost:8161" path="web"> ... <app url="console" war="hawtio.war"/> ... </web> Start the upgraded broker. (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. 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. 2.7.2. Upgrading from 7.7.0 to 7.8.0 on Windows Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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. 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. 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. 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. Edit the <broker_instance_dir> \etc\bootstrap.xml configuration file. In the web element, update the name of the .war file required by AMQ Management Console in 7.8. <web bind="http://localhost:8161" path="web"> ... <app url="console" war="hawtio.war"/> ... </web> Start the upgraded broker. (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. 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. 2.8. Upgrading a broker instance from 7.8.x to 7.9.x The following subsections describe how to upgrade a 7.8.x broker instance to 7.9.x for different operating systems. Important Starting with AMQ Broker 7.1.0, you can access AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.8.x to 7.9.x on Linux Upgrading from 7.8.x to 7.9.x on Windows 2.8.1. Upgrading from 7.8.x to 7.9.x on Linux Note The name of the archive that you download could differ from what is used in the following examples. Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. For example: 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. Edit the <broker_instance_dir> /etc/bootstrap.xml configuration file. In the web element, update the name of the .war file required by AMQ Management Console in 7.9. <web bind="http://localhost:8161" path="web"> ... <app url="console" war="hawtio.war"/> ... </web> Start the upgraded broker. (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. 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. 2.8.2. Upgrading from 7.8.x to 7.9.x on Windows Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder amd select Copy . Right-click in the same window and select Paste . (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. 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. 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. 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. Edit the <broker_instance_dir> \etc\bootstrap.xml configuration file. In the web element, update the name of the .war file required by AMQ Management Console in 7.9. <web bind="http://localhost:8161" path="web"> ... <app url="console" war="hawtio.war"/> ... </web> Start the upgraded broker. (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. 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. 2.9. Upgrading a broker instance from 7.9.x to 7.10.x The following subsections describe how to upgrade a 7.9.x broker instance to 7.10.x for different operating systems. Important Starting with AMQ Broker 7.1.0, you can access AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.9.x to 7.10.x on Linux Upgrading from 7.9.x to 7.10.x on Windows 2.9.1. Upgrading from 7.9.x to 7.10.x on Linux Note The name of the archive that you download could differ from what is used in the following examples. Prerequisites At a minimum, AMQ Broker 7.11 requires Java version 11 to run. Ensure that each AMQ Broker host is running Java version 11 or higher. For more information on supported configurations, see Red Hat AMQ Broker 7 Supported Configurations . If AMQ Broker 7.9 is configured to persist message data in a database, the data type of the HOLDER_EXPIRATION_TIME column is timestamp in the node manager database table. In AMQ Broker 7.11, the data type of the column changed to number . Before you upgrade to AMQ Broker 7.11, you must drop the node manager table, that is, remove it from the database. After you drop the table, it is recreated with the new schema when you restart the upgraded broker. In a shared store high availability (HA) configuration, the node manager table is shared between brokers. Therefore, you must ensure that all brokers that share the table are stopped before you drop the table. The following example drops a node manager table called NODE_MANAGER_TABLE : Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. If the broker is running, stop it. Back up the instance directory of the broker by copying it to the home directory of the current user. (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. 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. For example: Edit the <broker_instance_dir> /etc/bootstrap.xml configuration file. In the web element, update the name of the .war file required by AMQ Management Console in 7.10. <web path="web"> <binding uri="https://localhost:8161" ... <app url="console" war="hawtio.war"/> ... </web> + In the broker xmlns element, change the schema value from "http://activemq.org/schema" to "http://activemq.apache.org/schema" . + <broker xmlns="http://activemq.apache.org/schema"> Edit the <broker_instance_dir> /etc/management.xml file. In the management-context xmlns element, change the schema value from "http://activemq.org/schema" to "http://activemq.apache.org/schema" . <management-context xmlns="http://activemq.apache.org/schema"> Start the upgraded broker. (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. 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. 2.9.2. Upgrading from 7.9.x to 7.10.x on Windows Prerequisites At a minimum, AMQ Broker 7.11 requires Java version 11 to run. Ensure that each AMQ Broker host is running Java version 11 or higher. For more information on supported configurations, see Red Hat AMQ Broker 7 Supported Configurations . If AMQ Broker 7.9 is configured to persist message data in a database, the data type of the HOLDER_EXPIRATION_TIME column is timestamp in the node manager database table. In AMQ Broker 7.11, the data type of the column changed to number . Before you upgrade to AMQ Broker 7.11, you must drop the node manager table, that is, remove it from the database. After you drop the table, it is recreated with the new schema when you restart the upgraded broker. In a shared store high availability (HA) configuration, the node manager table is shared between brokers. Therefore, you must ensure that all brokers that share the table are stopped before you drop the table. The following example drops a node manager table called NODE_MANAGER_TABLE : Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . If the broker is running, stop it. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . (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. 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. 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. 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. Edit the <broker_instance_dir> \etc\bootstrap.xml configuration file. In the web element, update the name of the .war file required by AMQ Management Console in 7.10. <web path="web"> <binding uri="https://localhost:8161" ... <app url="console" war="hawtio.war"/> ... </web> In the broker xmlns element, change the schema value from "http://activemq.org/schema" to "http://activemq.apache.org/schema" . <broker xmlns="http://activemq.apache.org/schema"> Edit the <broker_instance_dir> /etc/management.xml file. In the management-context xmlns element, change the schema value from "http://activemq.org/schema" to "http://activemq.apache.org/schema" . <management-context xmlns="http://activemq.apache.org/schema"> Start the upgraded broker. (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. 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. 2.10. Upgrading a broker instance from 7.10.x to 7.11.x The following subsections describe how to upgrade a 7.10.x broker instance to 7.11.x for different operating systems. Important Starting with AMQ Broker 7.1.0, you can access AMQ Management Console only from the local host by default. To learn about configuring remote access to the console, see Configuring local and remote access to AMQ Management Console . Upgrading from 7.10.x to 7.11.x on Linux Upgrading from 7.10.x to 7.11.x on Windows 2.10.1. Upgrading from 7.10.x to 7.11.x on Linux Note The name of the archive that you download could differ from what is used in the following examples. Prerequisites At a minimum, AMQ Broker 7.11 requires Java version 11 to run. Ensure that each AMQ Broker host is running Java version 11 or higher. For more information on supported configurations, see Red Hat AMQ Broker 7 Supported Configurations . Procedure Download the desired archive from the Red Hat Customer Portal. Follow the instructions provided in Downloading the AMQ Broker archive . 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 . Move the archive to the directory created during the original installation of AMQ Broker. The following example uses /opt/redhat . 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. Note The contents of the archive are extracted to a directory called apache-artemis-2.28.0.redhat-00019 in your current directory. If the broker is running, stop it. (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. Back up the instance directory of the broker by copying it to the home directory of the current user. Change to directory to which you extracted the contents of the compressed archive. 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. 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. Updates the <broker_instance_dir> bin/artemis script to use the Apache Log4j 2 logging utility, which is bundled with AMQ Broker 7.11, instead of the the JBoss Logging framework used in versions. Deletes the existing <broker_instance_dir> /etc/logging.properties file used by JBoss and creates a new <broker_instance_dir> /etc/log4j2.properties file for the Apache Log4j 2 logging utility. If the Prometheus metrics plugin included with AMQ Broker is enabled in 7.10.x, change the class name of the plugin from org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin to com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin , which is the new class name of the plugin in AMQ Broker 7.11. Open the <broker_instance_dir> /etc/broker.xml configuration file. In the <plugin> sub-element of the <metrics> element, update the plugin class name to com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin . <metrics> <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics> Save the broker.xml configuration file. Start the upgraded broker. (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. 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. 2.10.2. Upgrading from 7.10.x to 7.11.x on Windows Prerequisites At a minimum, AMQ Broker 7.11 requires Java version 11 to run. Ensure that each AMQ Broker host is running Java version 11 or higher. For more information on supported configurations, see Red Hat AMQ Broker 7 Supported Configurations . Procedure Follow the instructions provided in Downloading the AMQ Broker archive to download the AMQ Broker archive. Use a file manager to move the archive to the folder you created during the last installation of AMQ Broker. Extract the contents of the archive. Right-click the .zip file and select Extract All . Note The contents of the archive are extracted to a folder called apache-artemis-2.28.0.redhat-00019 in the current folder. If the broker is running, stop it. (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. Back up the broker using a file manager. Right-click the <broker_instance_dir> folder and select Copy . Right-click in the same window and select Paste . Change to directory to which you extracted the contents of the compressed archive. For example: 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. 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. Updates the <broker_instance_dir> \bin\artemis.cmd script to use the Apache Log4j 2 logging utility, which is bundled with AMQ Broker 7.11, instead of the the JBoss Logging framework used in versions. Deletes the existing <broker_instance_dir> \etc\logging.properties file used by JBoss and creates a new <broker_instance_dir> \etc\log4j2.properties file for the Apache Log4j 2 logging utility. If the Prometheus metrics plugin included with AMQ Broker was enabled in 7.10.x, change the class name of the plugin from org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin to com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin , which is the new class name of the plugin in 7.11. Open the <broker_instance_dir> \etc\broker.xml configuration file. In the <plugin> sub-element of the <metrics> element, update the plugin class name to com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin . <metrics> <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics> Save the broker.xml configuration file. Start the upgraded broker. (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. 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.

Commands:
sudo chown amq-broker:amq-broker jboss-amq-7.x.x.redhat-1.zip
sudo mv jboss-amq-7.x.x.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip jboss-amq-7.x.x.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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
ARTEMIS_HOME='/opt/redhat/jboss-amq-7.x.x-redhat-1'
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
<broker_instance_dir> \bin\artemis-service.exe start
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]
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
ARTEMIS_HOME=" <7.1.0_install_dir> "
ARTEMIS_INSTANCE_URI="file:// <7.0.x_broker_instance_dir> "
-Djolokia.policyLocation=USD{ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
<7.1.0_install_dir> /bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
cp <temporary_7.1.0_broker_instance_dir> /etc/management.xml <7.0_broker_instance_dir> /etc/
cp <temporary_7.1.0_broker_instance_dir> /etc/jolokia-access.xml <7.0_broker_instance_dir> /etc/
<app url="jolokia" war="jolokia.war"/> <app url="hawtio" war="hawtio-no-slf4j.war"/>
<app url="console" war="console.war"/>
<broker_instance_dir> /bin/artemis run
> <broker_instance_dir> \bin\artemis-service.exe stop
ARTEMIS_HOME=" <7.1.0_install_dir> "
ARTEMIS_INSTANCE_URI="file:// <7.0.x_broker_instance_dir> "
-Djolokia.policyLocation=USD{ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
> <7.1.0_install_dir> /bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
> cp <temporary_7.1.0_broker_instance_dir> /etc/management.xml <7.0_broker_instance_dir> /etc/
> cp <temporary_7.1.0_broker_instance_dir> /etc/jolokia-access.xml <7.0_broker_instance_dir> /etc/
<app url="jolokia" war="jolokia.war"/> <app url="hawtio" war="hawtio-no-slf4j.war"/>
<app url="console" war="console.war"/>
> <broker_instance_dir> \bin\artemis-service.exe start
sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip jboss-amq-7.x.x.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
<broker_instance_dir> \bin\artemis-service.exe start
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]
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.
<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>
sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip jboss-amq-7.x.x.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-7.x.x-redhat-1'
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
JAVA_ARGS= <install_dir> \lib\jboss-logmanager-2.0.3.Final-redhat-1.jar
<startargument>Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar</startargument>
<broker_instance_dir> \bin\artemis-service.exe start
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]
sudo chown amq-broker:amq-broker amq-broker-7.x.x.redhat-1.zip
sudo mv amq-broker-7.x.x.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.x.x.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-redhat-1'
-Xbootclasspath/a:USDARTEMIS_HOME/lib/wildfly-common-1.5.1.Final-redhat-00001.jar
<app url="metrics" war="metrics.war"/>
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
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
<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>
<app url="metrics" war="metrics.war"/>
<broker_instance_dir> \bin\artemis-service.exe start
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]
sudo chown amq-broker:amq-broker amq-broker-7.4.x.redhat-1.zip
sudo mv amq-broker-7.4.x.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.4.x.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.4.x-redhat-1'
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
<broker_instance_dir> \bin\artemis-service.exe start
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]
sudo chown amq-broker:amq-broker amq-broker-7.5.0.redhat-1.zip
sudo mv amq-broker-7.5.0.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.5.0.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.5.0-redhat-1'
-Xbootclasspath/a:USDARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00001.jar
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
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
<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>
<broker_instance_dir> \bin\artemis-service.exe start
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]
sudo chown amq-broker:amq-broker amq-broker-7.6.0.redhat-1.zip
sudo mv amq-broker-7.6.0.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.6.0.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.6.0-redhat-1'
-Xbootclasspath/a:USDARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
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
<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>
<broker_instance_dir> \bin\artemis-service.exe start
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]
sudo chown amq-broker:amq-broker amq-broker-7.7.0.redhat-1.zip
sudo mv amq-broker-7.7.0.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.7.0.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.7.0-redhat-1'
-Xbootclasspath/a:USDARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
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
.. 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 ..
<broker_instance_dir> /bin/artemis run
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]
<broker_instance_dir> \bin\artemis-service.exe stop
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
ARTEMIS_HOME= <install_dir>
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
<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>
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
.. 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 ..
<broker_instance_dir> \bin\artemis-service.exe start
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]
sudo chown amq-broker:amq-broker amq-broker-7.8.0.redhat-1.zip
sudo mv amq-broker-7.8.0.redhat-1.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.8.0.redhat-1.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.8.0-redhat-1'
-Xbootclasspath/a:USDARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
<web bind="http://localhost:8161" path="web"> <app url="console" war="hawtio.war"/> </web>
<broker_instance_dir> /bin/artemis run
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.16.0.redhat-00007 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
<broker_instance_dir> \bin\artemis-service.exe stop
INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
ARTEMIS_HOME= <install_dir>
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
<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>
<web bind="http://localhost:8161" path="web"> <app url="console" war="hawtio.war"/> </web>
<broker_instance_dir> \bin\artemis-service.exe start
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.16.0.redhat-00007 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
sudo mv amq-broker-7.x.x-bin.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.x.x-bin.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
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]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-bin'
-Xbootclasspath/a:USDARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
<web bind="http://localhost:8161" path="web"> <app url="console" war="hawtio.war"/> </web>
<broker_instance_dir> /bin/artemis run
INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mes INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live sage Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
<broker_instance_dir> \bin\artemis-service.exe stop
INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
ARTEMIS_HOME= <install_dir>
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
<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>
<web bind="http://localhost:8161" path="web"> <app url="console" war="hawtio.war"/> </web>
<broker_instance_dir> \bin\artemis-service.exe start
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.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
DROP TABLE NODE_MANAGER_TABLE
sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
sudo mv amq-broker-7.x.x-bin.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.x.x-bin.zip
<broker_instance_dir> /bin/artemis stop
cp -r <broker_instance_dir> ~/
INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-bin'
<web path="web"> <binding uri="https://localhost:8161" <app url="console" war="hawtio.war"/> </web>
<broker xmlns="http://activemq.apache.org/schema">
<management-context xmlns="http://activemq.apache.org/schema">
<broker_instance_dir> /bin/artemis run
INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mes INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live sage Broker version 2.21.0.redhat-00025 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
DROP TABLE NODE_MANAGER_TABLE
<broker_instance_dir> \bin\artemis-service.exe stop
INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
ARTEMIS_HOME= <install_dir>
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
<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>
<web path="web"> <binding uri="https://localhost:8161" <app url="console" war="hawtio.war"/> </web>
<broker xmlns="http://activemq.apache.org/schema">
<management-context xmlns="http://activemq.apache.org/schema">
<broker_instance_dir> \bin\artemis-service.exe start
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.21.0.redhat-00025 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
sudo mv amq-broker-7.x.x-bin.zip /opt/redhat
su - amq-broker cd /opt/redhat unzip amq-broker-7.x.x-bin.zip
<broker_instance_dir> /bin/artemis stop
INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
cp -r <broker_instance_dir> ~/
cd /opt/redhat/apache-artemis-2.28.0.redhat-00019/bin
./artemis upgrade /var/opt/amq-broker/mybroker
<metrics> <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics>
<broker_instance_dir> /bin/artemis run
2023-02-08 20:53:50,128 INFO [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server version {upstreamversion}.redhat-{build} 2023-02-08 20:53:51,077 INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version {upstreamversion}.redhat-{build} [0.0.0.0, nodeID=be02a2b2-3e42-11ec-9b8a-4c796e887ecb]
<broker_instance_dir> \bin\artemis-service.exe stop
INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
cd \redhat\amq-broker\apache-artemis-2.28.0.redhat-00019\bin
artemis upgrade C:\redhat\amq-broker\mybroker
<metrics> <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/> </metrics>
<broker_instance_dir> \bin\artemis-service.exe start
2023-02-08 20:53:50,128 INFO [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server version {upstreamversion}.redhat-{build} 2023-02-08 20:53:51,077 INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version {upstreamversion}.redhat-{build} [0.0.0.0, nodeID=be02a2b2-3e42-11ec-9b8a-4c796e887ecb]