管理 AMQ Broker

流程

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

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

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

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

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

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

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

8. 编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。

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

9. 启动升级的代理。

   <broker_instance_dir>/bin/artemis run

10. （可选）确认代理正在运行并且版本已更改。启动代理后，打开 < 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.9.0.redhat-00001 [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.7.0.redhat-00054 [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. 启动升级的代理。

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

9. （可选）确认代理正在运行并且版本已更改。启动代理后，打开 < 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.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.5.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.7.0.redhat-00054 [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.5.0-redhat-1'

   2. 编辑 JAVA_ARGS 属性。添加 bootstrap 类路径参数，该参数引用日志管理器的依赖文件。

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

9. 启动升级的代理。

   <broker_instance_dir>/bin/artemis run

10. （可选）确认代理正在运行并且版本已更改。启动代理后，打开 < 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.9.0.redhat-00001 [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.7.0.redhat-00054 [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-00001.jar

9. 编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。设置 bootstrap 类路径启动参数来引用正确的日志管理器版本和依赖文件。

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

10. 启动升级的代理。

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

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 Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.6.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.9.0.redhat-00054 [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.6.0-redhat-1'

   2. 编辑 JAVA_ARGS 属性。添加 bootstrap 类路径参数，该参数引用日志管理器的依赖文件。

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

9. 启动升级的代理。

   <broker_instance_dir>/bin/artemis run

10. （可选）确认代理正在运行并且版本已更改。启动代理后，打开 < 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.11.0.redhat-00001 [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.9.0.redhat-00054 [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 类路径启动参数来引用正确的日志管理器版本和依赖文件。

   <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. 启动升级的代理。

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

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 Message Broker version 2.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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 配置部分 之前，为资源日志记录器添加默认配置。

      ..
      
      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 类路径启动参数引用日志管理器和依赖文件的正确版本，如下所示。

   <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 配置部分 之前，为资源日志记录器添加默认配置。

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

流程

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

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

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

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

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

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

   su - amq-broker
   cd /opt/redhat
   unzip amq-broker-7.8.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.13.0.redhat-00003 [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.8.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/bootstrap.xml 配置文件。在 web 元素中，更新 7.8 中 AMQ 管理控制台所需的 .war 文件的名称。

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

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.16.0.redhat-00007 [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.13.0.redhat-00003 [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 类路径启动参数引用日志管理器和依赖文件的正确版本，如下所示。

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

流程

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

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.13.0.redhat-00003 [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.x.x-bin'

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

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

9. 编辑 & lt;broker_instance_dir> /etc/bootstrap.xml 配置文件。在 web 元素中，更新 AMQ 管理控制台在 7.9 中所需的 .war 文件的名称。

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

10. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

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

    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]

流程

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.13.0.redhat-00003 [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 类路径启动参数引用日志管理器和依赖文件的正确版本，如下所示。

   <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\bootstrap.xml 配置文件。在 web 元素中，更新 AMQ 管理控制台在 7.9 中所需的 .war 文件的名称。

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

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

流程

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

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.18.0.redhat-00010 [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.x.x-bin'

9. 编辑 & lt;broker_instance_dir> /etc/bootstrap.xml 配置文件。

   在 web 元素中，更新 AMQ 管理控制台在 7.10 中所需的 .war 文件的名称。

   <web path="web">
       <binding uri="https://localhost:8161"
       ...
       <app url="console" war="hawtio.war"/>
       ...
   </web>

1. 编辑 & lt;broker_instance_dir> /etc/management.xml 文件。

   在 management-context xmlns 元素中，将 schema 值从 "http://activemq.org/schema" 更改为 "http://activemq.apache.org/schema "。

   <management-context xmlns="http://activemq.apache.org/schema">

2. 启动升级的代理。

   <broker_instance_dir>/bin/artemis run

3. （可选）确认代理正在运行并且版本已更改。启动代理后，打开 < broker_instance_dir>/log/artemis.log 文件。找到与下面相似的两行。请注意，当代理可用时，日志中出现的新版本号。

   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]

流程

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.18.0.redhat-00010[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 类路径启动参数引用日志管理器和依赖文件的正确版本，如下所示。

   <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\bootstrap.xml 配置文件。

    在 web 元素中，更新 AMQ 管理控制台在 7.10 中所需的 .war 文件的名称。

    <web path="web">
        <binding uri="https://localhost:8161"
        ...
        <app url="console" war="hawtio.war"/>
        ...
    </web>

    在 broker xmlns 元素中，将 schema 值从 "http://activemq.org/schema" 更改为 "http://activemq.apache.org/schema "。

    <broker xmlns="http://activemq.apache.org/schema">

11. 编辑 & lt;broker_instance_dir> /etc/management.xml 文件。

    在 management-context xmlns 元素中，将 schema 值从 "http://activemq.org/schema" 更改为 "http://activemq.apache.org/schema "。

    <management-context xmlns="http://activemq.apache.org/schema">

12. 启动升级的代理。

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

13. （可选）确认代理正在运行并且版本已更改。启动代理后，打开 < 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.21.0.redhat-00025 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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-00019 的目录。

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-00019/bin

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

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

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

   • 在您要升级的代理的 broker 实例目录的 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 捆绑，而不是之前版本中使用的 JBoss Logging 框架。
   • 删除 JBoss 使用的现有 <broker_instance_dir> /etc/logging.properties 文件，并为 Apache Log4j 2 日志记录实用程序创建一个新的 <broker_instance_dir> /etc/log4j2.properties 文件。

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

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

流程

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

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

   注意

   存档的内容提取到当前文件夹中名为 apache-artemis-2.28.0.redhat-00019 的文件夹。

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-00019\bin

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

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

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

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

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

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

流程

1. 切换到安装期间创建的用户帐户。

   $ su - amq-broker

2. 使用 artemis run 命令启动代理实例。

   $ /var/opt/amq-broker/mybroker/bin/artemis run
   
             __  __  ____    ____            _
       /\   |  \/  |/ __ \  |  _ \          | |
      /  \  | \  / | |  | | | |_) |_ __ ___ | | _____ _ __
     / /\ \ | |\/| | |  | | |  _ <| '__/ _ \| |/ / _ \ '__|
    / ____ \| |  | | |__| | | |_) | | | (_) |   <  __/ |
   /_/    \_\_|  |_|\___\_\ |____/|_|  \___/|_|\_\___|_|
   
   Red Hat JBoss AMQ 7.2.1.GA
   
   10:53:43,959 INFO  [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server
   10:53:44,076 INFO  [org.apache.activemq.artemis.core.server] AMQ221000: live Message Broker is starting with configuration Broker Configuration (clustered=false,journalDirectory=./data/journal,bindingsDirectory=./data/bindings,largeMessagesDirectory=./data/large-messages,pagingDirectory=./data/paging)
   10:53:44,099 INFO  [org.apache.activemq.artemis.core.server] AMQ221012: Using AIO Journal
   ...

   代理使用以下信息启动并显示日志输出：

   • 事务日志和集群配置的位置。
   • 用于消息持久性的日志类型（本例中为 AIO）。

   • 可接受客户端连接的 URI。

     默认情况下，端口 61616 可以接受来自任何支持的协议（CORE、MQTT、AMQP、STOMP、HORNETQ 和 OPENWIRE）的连接。每个协议也都有单独的端口。

   • Web 控制台位于 http://localhost:8161。
   • Jolokia 服务(JMX over REST)位于 http://localhost:8161/jolokia。

流程

1. 在 /etc/systemd/system/ 目录中创建一个新的 amq-broker.service 文件。

2. 将以下文本复制到文件中。

   根据代理实例创建过程中提供的信息修改路径和用户字段。在以下示例中，用户 amq-broker 启动安装在 /var/opt/amq-broker/mybroker/ 目录下的代理服务。

   [Unit]
   Description=AMQ Broker
   After=syslog.target network.target
   
   [Service]
   ExecStart=/var/opt/amq-broker/mybroker/bin/artemis run
   Restart=on-failure
   User=amq-broker
   Group=amq-broker
   
   # A workaround for Java signal handling
   SuccessExitStatus=143
   
   [Install]
   WantedBy=multi-user.target

3. 打开终端。

4. 使用以下命令启用代理服务：

   sudo systemctl enable amq-broker

5. 使用以下命令运行代理服务：

   sudo systemctl start amq-broker

流程

1. 打开命令提示符以输入命令

2. 使用以下命令将代理作为服务安装：

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

3. 使用以下命令启动该服务：

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

4. （可选）卸载该服务：

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

流程

1. 打开配置文件 < broker_instance_dir> \etc\broker.xml。

2. 添加 secure ful-shutdown-enabled 配置元素，并将值设为 true。

   <configuration>
        <core>
             ...
             <graceful-shutdown-enabled>
                 true
             </graceful-shutdown-enabled>
             ...
        </core>
   </configuration>

3. 添加 secure ful-shutdown-timeout 配置元素，并以毫秒为单位为超时设置值。在以下示例中，在发出 stop 命令后，客户端连接会强制关闭 30 秒(30000 毫秒)。

   <configuration>
        <core>
             ...
             <graceful-shutdown-enabled>
                 true
             </graceful-shutdown-enabled>
             <graceful-shutdown-timeout>
                 30000
             </graceful-shutdown-timeout>
             ...
        </core>
   </configuration>

流程

1. 实施适当的接口并覆盖其拦截器 （） 方法。

   1. 如果使用 AMQP 协议，请实施 org.apache.activemq.artemis.protocol.amqp.broker.AmqpInterceptor 接口。

      package com.example;
      
      import org.apache.activemq.artemis.protocol.amqp.broker.AMQPMessage;
      import org.apache.activemq.artemis.protocol.amqp.broker.AmqpInterceptor;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements AmqpInterceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        public boolean intercept(final AMQPMessage message, RemotingConnection connection)
        {
          int size = message.getEncodeSize();
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This AMQPMessage has an acceptable size.");
            return true;
          }
          return false;
        }
      }

   2. 如果使用核心协议，您的拦截器必须实施 org.apache.artemis.activemq.api.core.Interceptor 接口。

      package com.example;
      
      import org.apache.artemis.activemq.api.core.Interceptor;
      import org.apache.activemq.artemis.core.protocol.core.Packet;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements Interceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        boolean intercept(Packet packet, RemotingConnection connection)
        throws ActiveMQException
        {
          int size = packet.getPacketSize();
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This Packet has an acceptable size.");
            return true;
          }
          return false;
        }
      }

   3. 如果您使用 mq 协议，请实施 org.apache.activemq.artemis.core.protocol.mqtt.mqInterceptor 接口。

      package com.example;
      
      import org.apache.activemq.artemis.core.protocol.mqtt.MQTTInterceptor;
      import io.netty.handler.codec.mqtt.MqttMessage;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements Interceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        boolean intercept(MqttMessage mqttMessage, RemotingConnection connection)
        throws ActiveMQException
        {
          byte[] msg = (mqttMessage.toString()).getBytes();
          int size = msg.length;
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This MqttMessage has an acceptable size.");
            return true;
          }
          return false;
        }
      }

   4. 如果您使用 STOMP 协议，请实施 org.apache.activemq.artemis.core.protocol.stomp.StompFrameInterceptor 接口。

      package com.example;
      
      import org.apache.activemq.artemis.core.protocol.stomp.StompFrameInterceptor;
      import org.apache.activemq.artemis.core.protocol.stomp.StompFrame;
      import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection;
      
      public class MyInterceptor implements Interceptor
      {
        private final int ACCEPTABLE_SIZE = 1024;
      
        @Override
        boolean intercept(StompFrame stompFrame, RemotingConnection connection)
        throws ActiveMQException
        {
          int size = stompFrame.getEncodedSize();
          if (size <= ACCEPTABLE_SIZE) {
            System.out.println("This StompFrame has an acceptable size.");
            return true;
          }
          return false;
        }
      }

流程

1. Open <broker_instance_dir>/etc/broker.xml

2. 通过在 <broker _instance_dir> /etc/broker.xml中添加配置，将代理配置为使用拦截器

   1. 如果拦截器旨在用于传入消息，请将其 class-name 添加到 remoting-incoming-interceptors 列表中。

      <configuration>
        <core>
          ...
          <remoting-incoming-interceptors>
             <class-name>org.example.MyIncomingInterceptor</class-name>
          </remoting-incoming-interceptors>
          ...
        </core>
      </configuration>

   2. 如果拦截器旨在用于传出消息，请将其 class-name 添加到 remoting-outgoing-interceptors 列表中。

      <configuration>
        <core>
          ...
          <remoting-outgoing-interceptors>
             <class-name>org.example.MyOutgoingInterceptor</class-name>
          </remoting-outgoing-interceptors>
        </core>
      </configuration>

流程

1. 配置 Red Hat Single Sign-On：

   1. 导航到您要用来保护 AMQ 管理控制台的 Red Hat Single Sign-On 中的域。Red Hat Single Sign-On 中的每个域都包括一个名为 Broker 的客户端。此客户端与 AMQ 无关。
   2. 在 Red Hat Single Sign-On 中创建一个新客户端，如 artemis-console。

   3. 进入客户端设置页面并设置：

      • 有效的重定向 URI 到 AMQ 管理控制台 URL，后跟 192.168.1.0/24，例如：

        https://broker.example.com:8161/console/*

      • Web Origins 与 Valid Redirect URI 的值相同。Red Hat Single Sign-On 允许您输入 +，这表示允许的 CORS 源包含 Valid Redirect URI 的值。
   4. 为客户端创建一个角色，如 guest。
   5. 确保需要访问 AMQ 管理控制台的所有用户都被分配了上述角色，例如使用 Red Hat Single Sign-On 组。

2. 配置 AMQ Broker 实例：

   1. 将以下内容添加到 < broker-instance-dir> /instances/broker0/etc/login.config 文件中，将 AMQ 管理控制台配置为使用 Red Hat Single Sign-On：

      console {
          org.keycloak.adapters.jaas.BearerTokenLoginModule required
              keycloak-config-file="${artemis.instance}/etc/keycloak-bearer-token.json"
              role-principal-class=org.apache.activemq.artemis.spi.core.security.jaas.RolePrincipal
          ;
      };

      添加此配置设置 JAAS 主体，以及来自红帽单点登录的 bearer 令牌的要求。与 Red Hat Single Sign-On 的连接在 keycloak-bearer-token.json 文件中定义，如下一步所述。

   2. 创建包含以下内容的 &lt ;broker-instance-dir> /etc/keycloak-bearer-token.json 文件，以指定与用于 bearer 令牌交换的 Red Hat Single Sign-On 的连接：

      {
        "realm": "<realm-name>",
        "resource": "<client-name>",
        "auth-server-url": "<RHSSO-URL>/auth",
        "principal-attribute": "preferred_username",
        "use-resource-role-mappings": true,
        "ssl-required": "external",
        "confidential-port": 0
      }

      <realm-name>

      Red Hat Single Sign-On 中的域名

      <client-name>

      Red Hat Single Sign-On 中的客户端名称

      <RHSSO-URL>

      Red Hat Single Sign-On 的 URL

   3. 创建包含以下内容的 &lt ;broker-instance-dir> /etc/keycloak-js-token.json 文件，以指定 Red Hat Single Sign-On 身份验证端点：

      {
        "realm": "<realm-name>",
        "clientId": "<client-name>",
        "url": "<RHSSO-URL>/auth"
      }

   4. 通过编辑 < broker-instance-dir> /etc/broker.xml 文件来配置 安全设置。

      例如，要允许具有 amq 角色的用户使用消息并允许具有 guest 角色的用户发送消息，请添加以下内容：

               <security-setting match="Info">
                  <permission roles="amq" type="createDurableQueue"/>
                  <permission roles="amq" type="deleteDurableQueue"/>
                  <permission roles="amq" type="createNonDurableQueue"/>
                  <permission roles="amq" type="deleteNonDurableQueue"/>
                  <permission roles="guest" type="send"/>
                  <permission roles="amq" type="consume"/>
               </security-setting>

3. 运行 AMQ Broker 实例并验证 AMQ 管理控制台配置。

流程

1. 打开 & lt;broker_instance_dir> /etc/bootstrap.xml 文件。

2. 在 & lt;web > 元素中，添加以下属性：

   <web path="web">
       <binding uri="https://0.0.0.0:8161" keyStorePath="<path_to_keystore>" keyStorePassword="<password>"
       clientAuth="<true/false>" trustStorePath="<path_to_truststore>" trustStorePassword="<password>">
       </binding>
   </web>

   bind

   对于到控制台的安全连接，请将 URI 方案更改为 https。

   keyStorePath

   密钥存储文件的路径。例如：

   keyStorePath="<broker_instance_dir>/etc/keystore.jks"

   keyStorePassword

   密钥存储密码。此密码可以被加密。

   clientAuth

   指定是否需要客户端身份验证。默认值为 false。

   trustStorePath

   信任存储文件的路径。只有在 clientAuth 设为 true 时，才需要定义此属性。

   trustStorePassword

   信任存储密码。此密码可以被加密。

流程

1. 从可信证书颁发机构获取代理和客户端的证书，或生成自签名证书。如果要生成自签名证书，请完成以下步骤：

   1. 为代理生成自签名证书。

      $ keytool -storetype pkcs12 -keystore broker-keystore.p12 -storepass securepass -keypass securepass -alias client -genkey -keyalg "RSA" -keysize 2048 -dname "CN=ActiveMQ Broker, OU=Artemis, O=ActiveMQ, L=AMQ, S=AMQ, C=AMQ" -ext bc=ca:false -ext eku=cA

   2. 从代理密钥存储导出证书，使其可以与客户端共享。

      $ keytool -storetype pkcs12 -keystore broker-keystore.p12 -storepass securepass -alias client -exportcert -rfc > broker.crt

   3. 在客户端上，将代理证书导入到客户端信任存储中。

      $ keytool -storetype pkcs12 -keystore client-truststore.p12 -storepass securepass -keypass securepass -importcert -alias client-ca -file broker.crt -noprompt

   4. 在客户端上，为客户端生成自签名证书。

      $ keytool -storetype pkcs12 -keystore client-keystore.p12 -storepass securepass -keypass securepass -alias client -genkey -keyalg "RSA" -keysize 2048 -dname "CN=ActiveMQ Client, OU=Artemis, O=ActiveMQ, L=AMQ, S=AMQ, C=AMQ" -ext bc=ca:false -ext eku=cA

   5. 将客户端证书从客户端密钥存储导出到文件，以便可以将其添加到代理信任存储中。

      $ keytool -storetype pkcs12 -keystore client-keystore.p12 -storepass securepass -alias client -exportcert -rfc > client.crt

   6. 将客户端证书导入到代理信任存储中。

      $ keytool -storetype pkcs12 -keystore client-truststore.p12 -storepass securepass -keypass securepass -importcert -alias client-ca -file client.crt -noprompt

      注意

      在代理机器上，确保密钥存储和信任存储文件位于代理可访问的位置。

2. 在 & lt;broker_instance_dir>/etc/bootstrap.xml 文件中，更新 Web 配置来为代理控制台启用 HTTPS 协议和客户端身份验证。例如：

   ...
   <web path="web">
       <binding uri="https://localhost:8161" keyStorePath="${artemis.instance}/etc/server-keystore.p12" keyStorePassword="password"
       clientAuth="true" trustStorePath="${artemis.instance}/etc/client-truststore.p12" trustStorePassword="password">
       ...
       </binding>
   </web>
   ...

   binding uri

   指定 https 协议来启用 SSL 并添加主机名和端口。

   keystorePath

   安装代理证书的密钥存储的路径。

   keystorePassword

   安装代理证书的密钥存储的密码。

   clientAuth

   设置为 true，将代理配置为要求每个客户端在客户端尝试连接到代理控制台时提供证书。

   trustStorePath

   如果客户端使用自签名证书，请指定安装客户端证书的信任存储的路径。

   trustStorePassword

   如果客户端使用自签名证书，请指定安装客户端证书的信任存储的密码。

   备注。只有在客户端使用自签名证书时，才需要配置 trustStorePath 和 trustStorePassword 属性。

3. 从每个客户端证书获取 Subject Distinguished Names (DN)，以便您可以在每个客户端证书和代理用户之间创建映射。

   1. 将客户端密钥存储文件中的每个客户端证书导出到临时文件中。例如：

      keytool -export -file <file_name> -alias broker-localhost -keystore broker.ks -storepass <password>

   2. 显示导出的证书的内容：

      keytool -printcert -file <file_name>

      输出结果类似如下：

      Owner: CN=AMQ Client, OU=Artemis, O=AMQ, L=AMQ, ST=AMQ, C=AMQ
      Issuer: CN=AMQ Client, OU=Artemis, O=AMQ, L=AMQ, ST=AMQ, C=AMQ
      Serial number: 51461f5d
      Valid from: Sun Apr 17 12:20:14 IST 2022 until: Sat Jul 16 12:20:14 IST 2022
      Certificate fingerprints:
      	 SHA1: EC:94:13:16:04:93:57:4F:FD:CA:AD:D8:32:68:A4:13:CC:EA:7A:67
      	 SHA256: 85:7F:D5:4A:69:80:3B:5B:86:27:99:A7:97:B8:E4:E8:7D:6F:D1:53:08:D8:7A:BA:A7:0A:7A:96:F3:6B:98:81

      Owner 条目是 Subject DN。用于输入 Subject DN 的格式取决于您的平台。以上字符串也可以表示：

      Owner: `CN=localhost,\ OU=broker,\ O=Unknown,\ L=Unknown,\ ST=Unknown,\ C=Unknown`

4. 为代理控制台启用基于证书的验证。

   1. 打开 & lt;broker_instance_dir> /etc/login.config 配置文件。添加证书登录模块并引用用户和角色属性文件。例如：

      activemq {
          org.apache.activemq.artemis.spi.core.security.jaas.TextFileCertificateLoginModule
              debug=true
              org.apache.activemq.jaas.textfiledn.user="artemis-users.properties"
              org.apache.activemq.jaas.textfiledn.role="artemis-roles.properties";
      };

      org.apache.activemq.artemis.spi.core.security.jaas.TextFileCertificateLoginModule

      实施类。

      org.apache.activemq.jaas.textfiledn.user

      指定相对于包含登录配置文件的目录的用户属性文件的位置。

      org.apache.activemq.jaas.textfiledn.role

      指定将用户映射到为登录模块实施定义的角色的属性文件。

      注意

      如果您更改了 < broker_instance_dir>/etc/login.config 文件中的证书登录模块配置的默认名称，您必须更新 < broker_instance_dir>/etc/artemis.profile 文件中的 -dhawtio. realm 参数的值，以匹配新名称。默认名称为 activemq。

   2. 打开 & lt;broker_instance_dir>/etc/artemis-users.properties 文件。通过将从每个客户端证书获取的 Subject DNS 添加到代理用户，创建客户端证书和代理用户之间的映射。例如：

      user1=CN=user1,O=Progress,C=US
      user2=CN=user2,O=Progress,C=US

      在本例中，user1 代理用户映射到具有 Subject Distinguished Name 为 CN=user1,O=Progress,C=US Subject DN 的客户端证书。在客户端证书和代理用户之间创建映射后，代理可以使用证书来验证用户。

   3. 打开 & lt;broker_instance_dir>/etc/artemis-roles.properties 文件。通过将用户权限添加到为 < broker_instance_dir>/etc/artemis.profile 文件中 HAWTIO_ROLE 变量指定的角色中，授予用户登录控制台的权限。HAWTIO_ROLE 变量的默认值为 amq。例如：

      amq=user1, user2

5. 为 HTTPS 协议配置以下推荐的安全属性。

   1. 打开 & lt;broker_instance_dir>/etc/artemis.profile 文件。

   2. 设置 hawtio.http.strictTransportSecurity 属性，仅允许 HTTPS 请求到 AMQ 管理控制台，并将任何 HTTP 请求转换为 HTTPS。例如：

      hawtio.http.strictTransportSecurity = max-age=31536000; includeSubDomains; preload

   3. 设置 hawtio.http.publicKeyPins 属性，以指示 Web 浏览器将特定的加密密钥与 AMQ 管理控制台关联，以减少使用伪证书的"man-in-the-middle"攻击的风险。例如：

      hawtio.http.publicKeyPins = pin-sha256="..."; max-age=5184000; includeSubDomains

流程

1. 打开 & lt;broker_instance_dir> /etc/bootstrap.xml 文件。

2. 在 & lt;web > 元素中，使用 org.eclipse.jetty.server.ForwardedRequestCustomizer 的值添加 customizer 属性。例如：

   <web path="web" customizer="org.eclipse.jetty.server.ForwardedRequestCustomizer">
   ..
   </web>

3. 保存 bootstrap.xml 文件。

4. 输入以下命令启动或重启代理：

   • On Linux: <broker_instance_dir>/bin/artemis run
   • 在 Windows 上： <broker_instance_dir&gt; \bin\artemis-service.exe start

流程

1. 在左侧菜单中，单击 Artemis。

2. 在主窗格中，点 Broker 图 选项卡。

   控制台显示集群拓扑图。这包括集群中的所有代理以及本地代理中的任何地址和队列，如图所示。

   图 4.3. 代理图 标签页

   
3. 要更改图中显示哪些项目，请使用图顶部的复选框。单击 Refresh。

4. 要显示本地代理或连接的地址或队列的属性，请点击图中的节点。例如，下图显示包含本地代理属性的示意图。

   图 4.4. 代理图 标签页，包括属性

   

流程

1. 在左侧菜单中，单击 Artemis。
2. 在文件夹树中，单击 acceptors。

3. 要查看有关如何配置接受者的详细信息，请点 acceptor。

   控制台显示在 Attributes 选项卡上的对应属性，如图所示。

   图 4.5. AMQP acceptor 属性

   
4. 要查看属性的完整详情，请点属性。此时会打开一个额外的窗口来显示详情。

流程

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

2. 设置 & lt;jmx-management-enabled>。

   <jmx-management-enabled>true</jmx-management-enabled>

   如果启用了 JMX，可以使用 jconsole 在本地管理代理。

   注意

   为安全起见，默认不启用到 JMX 的远程连接。

3. 如果要从同一 MBeanServer 管理多个代理，请为每个代理配置 JMX 域。

   默认情况下，代理使用 JMX 域 org.apache.activemq.artemis。

   <jmx-domain>my.org.apache.activemq</jmx-domain>

   注意

   如果您在 Windows 系统上使用 AMQ Broker，则必须在 artemis 或 artemis.cmd 中设置系统属性。shell 脚本位于 < install_dir> /bin 下。

流程

1. 打开 & lt;broker-instance-dir> /etc/management.xml 配置文件。

2. 为 JMX 代理定义连接器。connector-port 设置建立 RMI registry，如 jconsole 查询 JMX 连接器服务器。例如，允许在端口 1099 上进行远程访问：

   <connector connector-port="1099"/>

3. 使用 jconsole 验证与 JMX 代理的连接：

   service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi

4. 在连接器中定义附加属性，如下所述。

   connector-host

   用于公开代理的代理服务器主机。要防止远程访问，请将 connector-host 设置为 127.0.0.1 (localhost)。

   rmi-registry-port

   JMX RMI 连接器服务器绑定的端口。如果没有设置，则端口始终为随机。设置此属性以避免通过防火墙隧道的远程 JMX 连接问题。

   jmx-realm

   用于身份验证的 JMX 域。默认值为 activemq，以匹配 JAAS 配置。

   object-name

   用于公开远程连接器的对象名称。默认值为 connector:name=rmi。

   secured

   指定连接器是否使用 SSL 进行保护。默认值为 false。将值设为 true 以确保安全通信。

   key-store-path

   密钥存储的位置。如果您设置了 secure="true"，则需要此项。

   key-store-password

   密钥存储密码。如果您设置了 secure="true"，则需要此项。可以加密密码。

   key-store-provider

   密钥存储提供程序。如果您设置了 secure="true"，则需要此项。默认值为 JKS。

   trust-store-path

   信任存储的位置。如果您设置了 secure="true"，则需要此项。

   trust-store-password

   truststore 密码。如果您设置了 secure="true"，则需要此项。可以加密密码。

   trust-store-provider

   truststore 供应商。如果您设置了 secure="true"，则需要此项。默认值为 JKS

   password-codec

   要使用的密码 codec 的完全限定类名称。有关此操作的详情，请参见以下链接的密码屏蔽文档。

5. 使用 jdk.serialFilter 为端点序列化设置适当的值，如 Java Platform 文档所述。

流程

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

2. 添加 & lt;management-address > 元素并指定管理地址。

   默认情况下，管理地址为 activemq.management。您只需要在您不想使用默认地址时指定不同的地址。

   <management-address>my.management.address</management-address>

3. 为管理地址提供 管理用户权限 类型。

   此权限类型可让管理地址接收和处理管理消息。

   <security-setting-match="activemq.management">
       <permission-type="manage" roles="admin"/>
   </security-setting>

流程

1. 创建一个 QueueRequestor，将消息发送到管理地址并接收回复。
2. 创建 消息。
3. 使用 helper 类 org.apache.activemq.artemis.api.jms.management.JMSManagementHelper 来填充管理属性的消息。
4. 使用 QueueRequestor 发送消息。
5. 使用 helper 类 org.apache.activemq.artemis.api.jms.management.JMSManagementHelper，从管理回复中检索操作结果。

流程

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

2. 启用消息计数器。

   <message-counter-enabled>true</message-counter-enabled>

3. 设置消息计数器历史记录和抽样周期。

   <message-counter-max-day-history>7</message-counter-max-day-history>
   <message-counter-sample-period>60000</message-counter-sample-period>

   message-counter-max-day-history

   代理应存储队列指标的天数。默认值为 10 天。

   message-counter-sample-period

   代理应对其进行队列抽样（以毫秒为单位）来收集指标的频率。默认值为 10000 毫秒。