2.6. 将代理实例从 7.6.0 升级到 7.7.0

流程

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

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

   sudo chown amq-broker:amq-broker amq-broker-7.7.0.redhat-1.zip

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

   sudo mv amq-broker-7.7.0.redhat-1.zip /opt/redhat

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.7.0.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.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

8. 编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件。

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

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.7.0-redhat-1'

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

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

9. 编辑 & lt;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 handler configuration 部分前，为资源日志记录器添加默认配置。

      ..
      
      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>/bin/artemis run

11. （可选）确认代理正在运行，并且版本已更改。启动代理后，打开 < 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 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]

流程

1. 从红帽客户门户下载所需的存档。按照 下载 AMQ Broker 归档 中的说明进行操作。
2. 使用文件管理器将存档移到您在上次安装 AMQ Broker 时创建的文件夹。
3. 提取存档的内容。右键单击 .zip 文件并选择 Extract All。

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

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

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

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

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

   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

7. 编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 和 <broker_instance_dir> \bin\artemis-service.xml 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时所创建的新目录。

   ARTEMIS_HOME=<install_dir>

8. 编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 配置文件。确保 JAVA_ARGS 环境变量引用日志管理器和依赖文件的正确版本，如下所示。

   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

9. 编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。确保 bootstrap 类 path start 参数引用日志管理器和依赖文件的正确版本，如下所示。

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

10. 编辑 & lt;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 handler configuration 部分前，为资源日志记录器添加默认配置。

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

11. 启动升级的代理。

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

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