1.9. 在 Long Term Support 版本间升级代理实例

步骤

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

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

   sudo chown amq-broker:amq-broker amq-broker-7.8.x.redhat-1.zip

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

   sudo mv amq-broker-7.8.x.redhat-1.zip /opt/redhat

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.8.x.redhat-1.zip

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

   BROKER_INSTANCE_DIR/bin/artemis stop

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

   cp -r BROKER_INSTANCE_DIR ~/

7. （可选）请注意代理的当前版本。代理停止后，您会看到与以下类似的一行，它位于 BROKER_INSTANCE_DIR/log/artemis.log 文件的末尾。

   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]

8. 编辑 BROKER_INSTANCE_DIR/etc/artemis.profile 配置文件。

   1. 将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.8.x-redhat-1'

   2. 找到 JAVA_ARGS 属性。确保 bootstrap 类路径参数引用日志管理器所需的依赖版本，如下所示。

      -Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar

9. 编辑 BROKER_INSTANCE_DIR/etc/logging.properties 配置文件。

   1. 在要配置的额外日志记录器列表上，包含在 AMQ Broker 7.7.0 中添加的 org.apache.activemq.audit.resource 资源日志记录器。

      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

   2. 在 Console 处理程序配置 部分之前，为资源日志记录器添加默认配置。

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

10. 编辑 BROKER_INSTANCE_DIR/etc/bootstrap.xml 配置文件。在 web 元素中，更新 7.8 中 AMQ 管理控制台所需的 .war 文件的名称。

    <web bind="http://localhost:8161" path="web">
        ...
        <app url="console" war="hawtio.war"/>
        ...
    </web>

11. 启动升级的代理。

    BROKER_INSTANCE_DIR/bin/artemis run

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

    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-00012 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]