2.10. 将代理实例从 7.10.x 升级到 7.11.x

流程

1. 从红帽客户门户下载所需的存档。按照 下载 AMQ Broker 归档 中的说明进行操作。

2. 将您下载的存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。

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

3. 将存档移到 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。

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

4. 作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。

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

   注意

   最新存档的内容提取到当前目录中名为 apache-artemis-2.28.0.redhat-00022 的目录。

5. 如果代理正在运行，请停止它。

   <broker_instance_dir>/bin/artemis stop

6. （可选）请注意代理的当前版本。代理停止后，您可以在 < broker_instance_dir>/log/artemis.log 文件末尾看到类似如下的行。

   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]

7. 通过将代理实例目录复制到当前用户的主目录来备份代理实例目录。

   cp -r <broker_instance_dir> ~/

8. 更改到您提取压缩存档内容的目录。

   cd /opt/redhat/apache-artemis-2.28.0.redhat-00022/bin

9. 运行 artemis upgrade 命令，以升级现有代理。以下示例在 /var/opt/amq-broker/mybroker 目录中升级代理实例。

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

   artemis upgrade 命令完成以下步骤来升级代理。

   • 备份了您要升级的代理实例目录中的 old-config-bkp.<n > 子目录。
   • 将 < broker_instance_dir> /etc/artemis.profile 文件中的 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
   • 更新 & lt;broker_instance_dir> bin/artemis 脚本，以使用 Apache Log4j 2 日志记录工具，它与 AMQ Broker 7.11.x 捆绑，而不是之前版本中使用的 JBoss Logging 框架。
   • 删除 JBoss 使用的现有 <broker_instance_dir> /etc/logging.properties 文件，并为 Apache Log4j 2 logging 工具创建一个新的 <broker_instance_dir> /etc/log4j2.properties 文件。

10. 如果在 7.10.x 中启用了 AMQ Broker 中包含的 Prometheus 指标插件，请将插件的类名称从 org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin 改为 com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin，这是 AMQ Broker 7.11.x 中的插件的新类名称。

    1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

    2. 在 & lt; metrics> 元素的 <plugin& gt; 子元素中，将插件类名称更新为 com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin。

       <metrics>
           <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/>
       </metrics>

    3. 保存 broker.xml 配置文件。

11. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

12. （可选）确认代理正在运行，并且版本已更改。启动代理后，打开 < broker_instance_dir>/log/artemis.log 文件。查找类似以下的行。请注意代理启动后，日志中出现的新版本号。

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

流程

1. 按照 下载 AMQ Broker 归档中 提供的说明下载 AMQ Broker 归档。
2. 使用文件管理器将存档移到您在上次安装 AMQ Broker 时创建的文件夹。

3. 提取存档的内容。右键单击 .zip 文件并选择 Extract All。

   注意

   最新存档的内容提取到当前目录中名为 apache-artemis-2.28.0.redhat-00022 的文件夹。

4. 如果代理正在运行，请停止它。

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

5. （可选）请注意代理的当前版本。代理停止后，您可以在 < broker_instance_dir>\log\artemis.log 文件末尾看到类似如下的行。

   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

6. 使用文件管理器备份代理。

   1. 右键单击 < broker_instance_dir> 文件夹，然后选择 Copy。
   2. 在同一窗口中右键单击并选择 粘贴。

7. 更改到您提取压缩存档内容的目录。例如：

   cd \redhat\amq-broker\apache-artemis-2.28.0.redhat-00022\bin

8. 运行 artemis upgrade 命令，以升级现有代理。以下示例在 C:\redhat\amq-broker\mybroker 目录中升级代理实例。

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

   artemis upgrade 命令完成以下步骤来升级代理。

   • 备份了您要升级的代理实例目录中的 old-config-bkp.<n > 子目录。
   • 将 < broker_instance_dir> \etc\artemis.cmd.profile 文件中的 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
   • 更新 & lt;broker_instance_dir> \bin\artemis.cmd 脚本以使用 Apache Log4j 2 logging 工具，该工具与 AMQ Broker 7.11.x 捆绑，而不是之前版本中使用的 JBoss Logging 框架。
   • 删除 JBoss 使用的现有 <broker_instance_dir> \etc\logging.properties 文件，并为 Apache Log4j 2 logging 工具创建一个新的 <broker_instance_dir> \etc\log4j2.properties 文件。

9. 如果 AMQ Broker 附带的 Prometheus metrics 插件在 7.10.x 中被启用，请将来自 org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin 的类名称改为 com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin，这是 7.11.x 中的插件的新类名称。

   1. 打开 & lt;broker_instance_dir> \etc\broker.xml 配置文件。

   2. 在 & lt; metrics> 元素的 <plugin& gt; 子元素中，将插件类名称更新为 com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin。

      <metrics>
          <plugin class-name="com.redhat.amq.broker.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/>
      </metrics>

   3. 保存 broker.xml 配置文件。

10. 启动升级的代理。

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

11. （可选）确认代理正在运行，并且版本已更改。启动代理后，打开 < broker_instance_dir>\log\artemis.log 文件。找到类似如下的两行。请注意，当代理处于活动状态时，日志中出现的新版本号。

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