管理 AMQ Broker

Red Hat AMQ Broker 7.10

对于使用 AMQ Broker 7.10

摘要

本指南介绍了如何监控、管理和升级 AMQ Broker。

使开源包含更多

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情，请参阅我们的首席技术官 Chris Wright 提供的消息。

第 1 章概述

AMQ Broker 是一个基于 ActiveMQ Artemis 的高性能消息传递的实施。它具有快速、基于日志的消息持久性，支持多种语言、协议和平台。

AMQ Broker 提供多个接口来管理并与代理实例交互，如管理控制台、管理 API 和命令行界面。另外，您可以通过收集运行时指标来监控代理性能，配置代理来主动监控死锁等问题，并以交互方式检查代理和队列的健康状况。

本指南提供有关典型的代理管理任务的详细信息，例如：

升级代理实例
使用命令行界面和管理 API
检查代理和队列的健康状况
收集代理运行时指标
主动监控关键代理操作

1.1. 支持的配置

有关 AMQ Broker 支持的配置的当前信息，请参阅红帽客户门户网站中的"Red Hat AMQ 7 支持的配置"文章。

1.2. 文档惯例

本文档对 sudo 命令、文件路径和可替换值使用以下惯例：

`sudo` 命令

在本文档中，sudo 用于任何需要 root 特权的命令。使用 sudo 时，您应始终谨慎操作，因为任何更改都可能会影响整个系统。

有关使用 sudo 的更多信息，请参阅管理 sudo 访问。

关于在此文档中使用文件路径

在这个文档中，所有文件路径都对 Linux、UNIX 和类似操作系统（例如 /home/...）有效。如果您使用的是 Microsoft Windows，则应使用等效的 Microsoft Windows 路径（例如，C:\Users\...）。

可替换值

本文档有时会使用可替换值，您必须将这些值替换为特定于环境的值。可替换的值为小写，以尖括号(<>)括起，样式则使用斜体和 monospace 字体。用下划线(_)分隔多个词语。

例如，在以下命令中，将 <install_dir> 替换为您自己的目录名称。

$ <install_dir>/bin/artemis create mybroker

第 2 章升级代理

2.1. 关于升级

红帽将 AMQ Broker 的新版本发布到客户门户网站。将您的代理更新至最新版本，确保您有最新的改进和修复。通常，红帽以三种方式之一发布一个新的 AMQ Broker 版本：

主发行版本: 当应用程序从一个主版本转换到下一个主发行版本（例如，从 AMQ Broker 6 转换到 AMQ Broker 7 时，需要一个主要升级或迁移）。这个类型的升级没有在这个指南中被解决。
次发行版本: AMQ Broker 定期更新，包括新功能以及程序错误和安全修复。如果您计划从一个 AMQ Broker 次版本升级到另一个次版本，例如：从 AMQ Broker 7.0 升级到 AMQ Broker 7.1，则不使用私有、不支持或技术预览组件的应用程序不需要代码更改。
微版本: AMQ Broker 还定期提供包含次要改进和程序修复的微版本。微版本根据最后一个数字递增次要版本，例如从 7.0.1 增加到 7.0.2。微版本应该不需要代码更改，但有些版本可能需要配置更改。

2.2. 升级旧的 7.x 版本

2.2.1. 将代理实例从 7.0.x 升级到 7.0.y

将 AMQ Broker 从一个版本 7.0 升级到另一个版本的过程与安装类似：您可以从客户门户网站下载存档，然后提取它。

以下小节介绍了如何为不同的操作系统升级 7.0.x 代理。

在 Linux 上从 7.0.x 升级到 7.0.y
在 Windows 上从 7.0.x 升级到 7.0.y

2.2.1.1. 在 Linux 上从 7.0.x 升级到 7.0.y

您下载的存档名称可能与以下示例中使用的存档不同。

先决条件

在升级 AMQ Broker 前，请查看目标发行版本的发行注记。
发行注记描述了目标版本中行为的重要增强功能、已知问题和更改。
如需更多信息，请参阅 AMQ Broker 7.0 发行注记。

流程

按照下载 AMQ Broker 归档中的说明，从红帽客户门户网站下载所需的存档。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。
```
sudo chown amq-broker:amq-broker jboss-amq-7.x.x.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。在以下示例中，使用 /opt/redhat 目录。
```
sudo mv jboss-amq-7.x.x.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。存档以压缩格式保存。在以下示例中，用户 amq-broker 通过使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，位于 < broker_instance_dir> /log/artemis.log 的末尾会显示类似如下的一行。

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

编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件，将 ARTEMIS_HOME 属性设置为存档时创建的新目录。
```
ARTEMIS_HOME='/opt/redhat/jboss-amq-7.x.x-redhat-1'
```
启动升级的代理。
```
<broker_instance_dir>/bin/artemis run
```

（可选）确认代理正在运行，并且版本已改变。启动代理后，打开日志文件 < 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.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]

2.2.1.2. 在 Windows 上从 7.0.x 升级到 7.0.y

先决条件

在升级 AMQ Broker 前，请查看目标发行版本的发行注记。
发行注记描述了目标版本中行为的重要增强功能、已知问题和更改。
如需更多信息，请参阅 AMQ Broker 7.0 发行注记。

流程

按照下载 AMQ Broker 归档中的说明，从红帽客户门户网站下载所需的存档。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

输入以下命令停止代理。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，在日志文件末尾会显示类似如下的一行，它位于 < broker_instance_dir> \log\artemis.log。

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

编辑 & lt;broker_instance_dir> \etc\artemis.profile 配置文件，将 ARTEMIS_HOME 属性设置为存档时创建的新目录。
```
ARTEMIS_HOME=<install_dir>
```

启动升级的代理。

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

（可选）确认代理正在运行，并且版本已改变。启动代理后，打开日志文件 < 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.1.0.amq-700005-redhat-1 [0.0.0.0, nodeID=4782d50d-47a2-11e7-a160-9801a793ea45]

2.2.2. 将代理实例从 7.0.x 升级到 7.1.0

AMQ Broker 7.1.0 包含之前版本中没有包括的配置文件和设置。将代理实例从 7.0.x 升级到 7.1.0 需要在现有的 7.0.x 代理实例中添加这些新文件和设置。以下小节介绍了如何针对不同的操作系统将 7.0.x 代理实例升级到 7.1.0。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.0.x 升级到 7.1.0
在 Windows 上从 7.0.x 升级到 7.1.0

2.2.2.1. 从 7.0.x 升级到 Linux 上的 7.1.0

在升级 7.0.x 代理前，您需要安装 Red Hat AMQ Broker 7.1.0 并创建一个临时代理实例。这将生成升级 7.0.x 代理所需的 7.1.0 配置文件。

先决条件

在升级 AMQ Broker 前，请查看目标发行版本的发行注记。
发行注记描述了目标版本中行为的重要增强功能、已知问题和更改。
如需更多信息，请参阅 AMQ Broker 7.1 发行注记。
在升级 7.0.x 代理前，您必须首先安装版本 7.1。
有关在 Linux 上安装 7.1 的步骤，请参阅安装 AMQ Broker。

流程

如果正在运行，停止您要升级的 7.0.x 代理：
```
$ <broker_instance_dir>/bin/artemis stop
```
通过将代理的实例目录复制到当前用户的主目录来备份代理的实例目录。
```
cp -r <broker_instance_dir> ~/
```
在 7.0.x 代理的 < broker_instance_dir>/etc/ 目录中打开 artemis.profile 文件。
1. 更新 ARTEMIS_HOME 属性，使其值指的是 AMQ Broker 7.1.0 的安装目录：
```
ARTEMIS_HOME="<7.1.0_install_dir>"
```
2. 在您更新的行中，添加 ARTEMIS_INSTANCE_URI 属性并为其分配引用 7.0.x 代理实例目录的值：
```
ARTEMIS_INSTANCE_URI="file://<7.0.x_broker_instance_dir>"
```
3. 通过添加 jolokia.policyLocation 参数并为其分配以下值来更新 JAVA_ARGS 属性：
```
-Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
```
创建 7.1.0 代理实例。创建步骤生成从 7.0.x 升级到 7.1.0 所需的配置文件。在以下示例中，注意实例是 在升级_tmp 目录中创建的：
```
$ <7.1.0_install_dir>/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
```

将临时 7.1.0 实例的 etc 目录中的配置文件复制到 7.0.x 代理的 & lt;broker_instance_dir> /etc/ 目录中。

复制 management.xml 文件：

$ cp <temporary_7.1.0_broker_instance_dir>/etc/management.xml <7.0_broker_instance_dir>/etc/

复制 jolokia-access.xml 文件：

$ cp <temporary_7.1.0_broker_instance_dir>/etc/jolokia-access.xml <7.0_broker_instance_dir>/etc/

在 7.0.x 代理的 < broker_instance_dir> /etc/ 目录中打开 bootstrap.xml 文件。
1. 注释掉或删除以下两行：
```
<app url="jolokia" war="jolokia.war"/>
<app url="hawtio" war="hawtio-no-slf4j.war"/>
```
2. 添加以下内容来替换上一步中删除的两行：
```
<app url="console" war="console.war"/>
```
启动您升级的代理：
```
$ <broker_instance_dir>/bin/artemis run
```

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。

2.2.2.2. 在 Windows 上从 7.0.x 升级到 7.1.0

在升级 7.0.x 代理前，您需要安装 Red Hat AMQ Broker 7.1.0 并创建一个临时代理实例。这将生成升级 7.0.x 代理所需的 7.1.0 配置文件。

先决条件

在升级 AMQ Broker 前，请查看目标发行版本的发行注记。
发行注记描述了目标版本中行为的重要增强功能、已知问题和更改。
如需更多信息，请参阅 AMQ Broker 7.1 发行注记。
在升级 7.0.x 代理前，您必须首先安装版本 7.1。
有关在 Windows 上安装 7.1 的步骤，请参阅安装 AMQ Broker。

流程

如果正在运行，停止您要升级的 7.0.x 代理：
```
> <broker_instance_dir>\bin\artemis-service.exe stop
```
使用文件管理器备份代理的实例目录。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。
在 7.0.x 代理的 < broker_instance_dir>/etc/ 目录中打开 artemis.profile 文件。
1. 更新 ARTEMIS_HOME 属性，使其值指的是 AMQ Broker 7.1.0 的安装目录：
```
ARTEMIS_HOME="<7.1.0_install_dir>"
```
2. 在您更新的行中，添加 ARTEMIS_INSTANCE_URI 属性并为其分配引用 7.0.x 代理实例目录的值：
```
ARTEMIS_INSTANCE_URI="file://<7.0.x_broker_instance_dir>"
```
3. 通过添加 jolokia.policyLocation 参数并为其分配以下值来更新 JAVA_ARGS 属性：
```
-Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
```
创建 7.1.0 代理实例。创建步骤生成从 7.0.x 升级到 7.1.0 所需的配置文件。在以下示例中，注意实例是 在升级_tmp 目录中创建的：
```
> <7.1.0_install_dir>/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
```

将临时 7.1.0 实例的 etc 目录中的配置文件复制到 7.0.x 代理的 & lt;broker_instance_dir> /etc/ 目录中。

复制 management.xml 文件：

> cp <temporary_7.1.0_broker_instance_dir>/etc/management.xml <7.0_broker_instance_dir>/etc/

复制 jolokia-access.xml 文件：

> cp <temporary_7.1.0_broker_instance_dir>/etc/jolokia-access.xml <7.0_broker_instance_dir>/etc/

在 7.0.x 代理的 < broker_instance_dir> /etc/ 目录中打开 bootstrap.xml 文件。
1. 注释掉或删除以下两行：
```
<app url="jolokia" war="jolokia.war"/>
<app url="hawtio" war="hawtio-no-slf4j.war"/>
```
2. 添加以下内容来替换上一步中删除的两行：
```
<app url="console" war="console.war"/>
```

启动您升级的代理：

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。

2.2.3. 将代理实例从 7.1.x 升级到 7.2.0

AMQ Broker 7.2.0 包括没有包括在 7.0.x 版本中的配置文件和设置。如果您正在运行 7.0.x 实例，您必须首先将这些代理实例从 7.0.x 升级到 7.1.0，然后才能升级到 7.2.0。以下小节介绍了如何为不同的操作系统升级 7.1.x 代理实例到 7.2.0。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.1.x 升级到 7.2.0
在 Windows 上从 7.1.x 升级到 7.2.0

2.2.3.1. 在 Linux 上从 7.1.x 升级到 7.2.0

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

按照下载 AMQ Broker 归档中的说明，从红帽客户门户网站下载所需的存档。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。
```
sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。在以下示例中，使用 /opt/redhat 目录。
```
sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 通过使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，位于 < broker_instance_dir> /log/artemis.log 的末尾会显示类似如下的一行。

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]

编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件，将 ARTEMIS_HOME 属性设置为存档时创建的新目录。
```
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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.2.3.2. 在 Windows 上从 7.1.x 升级到 7.2.0

流程

按照下载 AMQ Broker 归档中的说明，从红帽客户门户网站下载所需的存档。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

输入以下命令停止代理。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，在日志文件末尾会显示类似如下的一行，它位于 < broker_instance_dir> \log\artemis.log。

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

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.2.4. 将代理实例从 7.2.x 升级到 7.3.0

以下小节介绍了如何针对不同的操作系统将 7.2.x 代理实例升级到 7.3.0。

2.2.4.1. 解决已弃用的分配控制台导致的异常

从版本 7.3.0 开始，AMQ Broker 不再附带 Hawtio 分配控制台插件 assign -hawtio-console.war。在以前的版本中，发送控制台用于管理 AMQ Interconnect。但是，AMQ 互联现在使用自己的独立 Web 控制台。这个变化会影响后续部分中的升级步骤。

如果您在将代理实例升级到 7.3.0 之前执行进一步的操作，则升级过程会生成一个例外，如下所示：

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.

您可以安全地忽略前一个例外，而不影响升级成功。

但是，如果您不希望在升级过程中看到这个异常，您必须首先在现有代理实例的 bootstrap.xml 文件中删除对 Hawtio 分配控制台插件的引用。bootstrap.xml 文件位于代理实例的 {instance_directory}/etc/ 目录中。以下示例显示了 AMQ Broker 7.2.4 实例的 bootstrap.xml 文件的一些内容：

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

要避免在将 AMQ Broker 升级到 7.3.0 时避免例外，请删除 &lt ;app url="dispatch-hawtio-console" war="dispatch-hawtio-console.war" />，如上例中所示。然后，保存修改的 bootstrap 文件并启动升级过程，如后续小节中所述。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.2.x 升级到 7.3.0
在 Windows 上从 7.2.x 升级到 7.3.0

2.2.4.2. 从 7.2.x 升级到 Linux 上的 7.3.0

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

按照下载 AMQ Broker 归档中的说明，从红帽客户门户网站下载所需的存档。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。
```
sudo chown amq-broker:amq-broker amq-7.x.x.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。在以下示例中，使用 /opt/redhat 目录。
```
sudo mv amq-7.x.x.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 通过使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，位于 < broker_instance_dir> /log/artemis.log 的末尾会显示类似如下的一行。

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]

编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件，将 ARTEMIS_HOME 属性设置为存档时创建的新目录。
```
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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.2.4.3. 在 Windows 上从 7.2.x 升级到 7.3.0

流程

按照下载 AMQ Broker 归档中的说明，从红帽客户门户网站下载所需的存档。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

输入以下命令停止代理。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，在日志文件末尾会显示类似如下的一行，它位于 < broker_instance_dir> \log\artemis.log。

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

编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 和 &lt ;broker_instance_dir> \bin\artemis-service.xml 配置文件，将 ARTEMIS_HOME 属性设置为存档时创建的新目录。
```
ARTEMIS_HOME=<install_dir>
```
编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 配置文件，以设置 JAVA_ARGS 环境变量来引用正确的日志管理器版本。
```
JAVA_ARGS=<install_dir>\lib\jboss-logmanager-2.0.3.Final-redhat-1.jar
```
编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件，以设置 bootstrap 类路径 start 参数，以引用正确的日志管理器版本。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.2.5. 将代理实例从 7.3.0 升级到 7.4.0

以下小节介绍了如何为不同的操作系统升级 7.3.0 代理实例到 7.4.0。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.3.0 升级到 7.4.0
在 Windows 上从 7.3.0 升级到 7.4.0

2.2.5.1. 从 7.3.0 升级到 Linux 上的 7.4.0

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.x.x.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.x.x.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件。
1. 将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
```
ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-redhat-1'
```
2. 编辑 JAVA_ARGS 属性。添加 bootstrap 类路径参数，该参数引用日志管理器的依赖文件。
```
-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.1.Final-redhat-00001.jar
```
编辑 & lt;broker_instance_dir> /etc/bootstrap.xml 配置文件。在 & lt;web > 配置元素中，添加对 AMQ Broker 指标插件文件的引用。
```
<app url="metrics" war="metrics.war"/>
```
启动升级的代理。
```
<broker_instance_dir>/bin/artemis run
```

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.2.5.2. 在 Windows 上从 7.3.0 升级到 7.4.0

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 和 <broker_instance_dir> \bin\artemis-service.xml 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
```
ARTEMIS_HOME=<install_dir>
```
编辑 & 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.1.Final-redhat-00001.jar
```

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

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

编辑 & lt;broker_instance_dir> \etc\bootstrap.xml 配置文件。在 & lt;web > 配置元素中，添加对 AMQ Broker 指标插件文件的引用。
```
<app url="metrics" war="metrics.war"/>
```

启动升级的代理。

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

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.3. 将代理实例从 7.4.0 升级到 7.4.x

重要

AMQ Broker 7.4 被指定为 Long Term Support(LTS)发行版本。在一系列微版本（7.4.1、7.4.1、7.4.1、7.4.1、7.4.1、7.4.1、7.4.1、7.4.1、7.4.1、7.2 等）中，针对 AMQ Broker 7.4 提供了程序错误修正和安全公告，其中包括至少 12 个月的周期。这意味着，您可以在不需要升级到新的次版本的情况下为 AMQ Broker 获取更新的程序错误修复和安全公告。如需更多信息，请参阅 AMQ Broker 的 Long Term Support。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

以下小节论述了如何为不同的操作系统将 7.4.0 代理实例升级到 7.4.x。

在 Linux 上从 7.4.0 升级到 7.4.x
在 Windows 上从 7.4.0 升级到 7.4.x

2.3.1. 从 7.4.0 升级到 Linux 上的 7.4.x

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.4.x.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.4.x.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
```
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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.3.2. 在 Windows 上从 7.4.0 升级到 7.4.x

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.4. 将代理实例从 7.4.x 升级到 7.5.0

以下小节介绍了如何针对不同的操作系统将 7.4.x 代理实例升级到 7.5.0。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.4.x 升级到 7.5.0
在 Windows 上从 7.4.x 升级到 7.5.0

2.4.1. 在 Linux 上从 7.4.x 升级到 7.5.0

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.5.0.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.5.0.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & 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
```
启动升级的代理。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.4.2. 在 Windows 上从 7.4.x 升级到 7.5.0

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

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

编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。设置 bootstrap 类路径 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-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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.5. 将代理实例从 7.5.0 升级到 7.6.0

以下小节介绍了如何针对不同的操作系统将 7.5.0 代理实例升级到 7.6.0。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.5.0 升级到 7.6.0
在 Windows 上从 7.5.0 升级到 7.6.0

2.5.1. 从 7.5.0 升级到 Linux 上的 7.6.0

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.6.0.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.6.0.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & 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
```
启动升级的代理。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.5.2. 在 Windows 上从 7.5.0 升级到 7.6.0

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

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

编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。设置 bootstrap 类路径 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>

启动升级的代理。

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

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

以下小节介绍了如何将不同操作系统的 7.6.0 代理实例升级到 7.7.0。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.6.0 升级到 7.7.0
在 Windows 上从 7.6.0 升级到 7.7.0

2.6.1. 从 7.6.0 升级到 Linux 上的 7.7.0

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.7.0.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.7.0.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & 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
```

编辑 & lt;broker_instance_dir> /etc/logging.properties 配置文件。

在要配置的其他日志记录器列表中，包括在 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

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

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.6.2. 从 7.6.0 升级到 Windows 上的 7.7.0

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 和 <broker_instance_dir> \bin\artemis-service.xml 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
```
ARTEMIS_HOME=<install_dir>
```
编辑 & 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
```
编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。确保 bootstrap 类路径 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>
```

编辑 & lt;broker_instance_dir> \etc\logging.properties 配置文件。

在要配置的其他日志记录器列表中，包括在 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

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

启动升级的代理。

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.7. 将代理实例从 7.7.0 升级到 7.8.0

以下小节介绍了如何将 7.7.0 代理实例升级到 7.8.0 用于不同的操作系统。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.7.0 升级到 7.8.0
在 Windows 上从 7.7.0 升级到 7.8.0

2.7.1. 从 7.7.0 升级到 Linux 上的 7.8.0

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.8.0.redhat-1.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.8.0.redhat-1.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & 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
```
编辑 & lt;broker_instance_dir> /etc/bootstrap.xml 配置文件。在 web 元素中，更新 AMQ 管理控制台在 7.8 中所需的 .war 文件的名称。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.7.2. 从 7.7.0 升级到 Windows 上的 7.8.0

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 和 <broker_instance_dir> \bin\artemis-service.xml 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
```
ARTEMIS_HOME=<install_dir>
```
编辑 & 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
```
编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。确保 bootstrap 类路径 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>
```
编辑 & lt;broker_instance_dir> \etc\bootstrap.xml 配置文件。在 web 元素中，更新 AMQ 管理控制台在 7.8 中所需的 .war 文件的名称。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.8. 将代理实例从 7.8.x 升级到 7.9.x

以下小节介绍了如何为不同的操作系统将 7.8.x 代理实例升级到 7.9.x。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.8.x 升级到 7.9.x
在 Windows 上从 7.8.x 升级到 7.9.x

2.8.1. 从 7.8.x 升级到 Linux 上的 7.9.x

注意

您下载的存档名称可能与以下示例中使用的存档不同。

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.x.x-bin.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & 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
```
编辑 & lt;broker_instance_dir> /etc/bootstrap.xml 配置文件。在 web 元素中，在 7.9 中更新 AMQ Management Console 所需的 .war 文件的名称。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.8.2. 在 Windows 上从 7.8.x 升级到 7.9.x

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir> 文件夹 amd，选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 和 <broker_instance_dir> \bin\artemis-service.xml 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
```
ARTEMIS_HOME=<install_dir>
```
编辑 & 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
```
编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。确保 bootstrap 类路径 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>
```
编辑 & lt;broker_instance_dir> \etc\bootstrap.xml 配置文件。在 web 元素中，在 7.9 中更新 AMQ Management Console 所需的 .war 文件的名称。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

2.9. 将代理实例从 7.9.x 升级到 7.10.x

以下小节介绍了如何针对不同的操作系统将 7.9.x 代理实例升级到 7.10.x。

重要

从 AMQ Broker 7.1.0 开始，您只能从本地主机访问 AMQ 管理控制台。要了解如何配置远程访问控制台，请参阅配置本地和远程访问 AMQ 管理控制台。

在 Linux 上从 7.9.x 升级到 7.10.x
在 Windows 上从 7.9.x 升级到 7.10.x

2.9.1. 在 Linux 上从 7.9.x 升级到 7.10.x

注意

您下载的存档名称可能与以下示例中使用的存档不同。

先决条件

至少，AMQ Broker 7.10 需要 Java 版本 11 运行。确保每个 AMQ Broker 主机都在运行 Java 版本 11 或更高版本。有关支持的配置的更多信息，请参阅 Red Hat AMQ Broker 7 支持的配置。

如果 AMQ Broker 7.9 配置为将消息数据保存在数据库中，则 HOLDER_EXPIRATION_TIME 列的数据类型是节点管理器数据库表中 的时间戳。在 AMQ Broker 7.10 中，列的数据类型更改为 编号。升级到 AMQ Broker 7.10 之前，您必须丢弃节点管理器表（即从数据库中删除）。丢弃表后，重启代理时会使用新的 schema 重新创建它。在共享存储高可用性(HA)配置中，节点管理器表在代理间共享。因此，您必须确保在丢弃表前停止所有共享表的代理。以下示例丢弃名为 NODE_MANAGER_TABLE 的节点管理器表：

DROP TABLE NODE_MANAGER_TABLE

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
将存档的所有者更改为拥有 AMQ Broker 安装的同一用户。以下示例显示了名为 amq-broker 的用户。
```
sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
```
将存档移动到在 AMQ Broker 原始安装过程中创建的目录中。以下示例使用 /opt/redhat。
```
sudo mv amq-broker-7.x.x-bin.zip /opt/redhat
```
作为目录所有者，提取压缩的存档的内容。在以下示例中，用户 amq-broker 使用 unzip 命令提取存档。
```
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> ~/
```

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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]

编辑 & lt;broker_instance_dir> /etc/artemis.profile 配置文件。
1. 将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。例如：
```
ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-bin'
```
编辑 & lt;broker_instance_dir> /etc/bootstrap.xml 配置文件。
在 web 元素中，更新 7.10 中 AMQ 管理控制台所需的 .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">
```
编辑 & 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">
```
启动升级的代理。
```
<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]

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> /etc/artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 etc/ 和 data/ 目录中。

2.9.2. 在 Windows 上从 7.9.x 升级到 7.10.x

先决条件

至少，AMQ Broker 7.10 需要 Java 版本 11 运行。确保每个 AMQ Broker 主机都在运行 Java 版本 11 或更高版本。有关支持的配置的更多信息，请参阅 Red Hat AMQ Broker 7 支持的配置。

如果 AMQ Broker 7.9 配置为将消息数据保存在数据库中，则 HOLDER_EXPIRATION_TIME 列的数据类型是节点管理器数据库表中 的时间戳。在 AMQ Broker 7.10 中，列的数据类型更改为 编号。升级到 AMQ Broker 7.10 之前，您必须丢弃节点管理器表（即从数据库中删除）。丢弃表后，重启代理时会使用新的 schema 重新创建它。在共享存储高可用性(HA)配置中，节点管理器表在代理间共享。因此，您必须确保在丢弃表前停止所有共享表的代理。以下示例丢弃名为 NODE_MANAGER_TABLE 的节点管理器表：

DROP TABLE NODE_MANAGER_TABLE

流程

从红帽客户门户网站下载所需的存档。按照下载 AMQ Broker 归档中的说明进行操作。
使用文件管理器将归档移动到您在 AMQ Broker 的最后一个安装过程中创建的文件夹。
提取存档的内容。右键单击 .zip 文件并选择" 提取 "。

如果代理正在运行，请将其停止。

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

使用文件管理器备份代理。
1. 右键点击 < broker_instance_dir&gt; 文件夹并选择 Copy。
2. 右键点击同一窗口并选择" 粘贴 "。

（可选）请注意代理的当前版本。代理停止后，您会看到类似于 < 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

编辑 & lt;broker_instance_dir> \etc\artemis.profile.cmd 和 <broker_instance_dir> \bin\artemis-service.xml 配置文件。将 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。
```
ARTEMIS_HOME=<install_dir>
```
编辑 & 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
```
编辑 & lt;broker_instance_dir> \bin\artemis-service.xml 配置文件。确保 bootstrap 类路径 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>
```
编辑 & lt;broker_instance_dir> \etc\bootstrap.xml 配置文件。
在 web 元素中，更新 7.10 中 AMQ 管理控制台所需的 .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">
```
编辑 & 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">
```

启动升级的代理。

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

其它资源

有关创建代理实例的更多信息，请参阅创建代理实例。
现在，您可以将代理实例的配置文件和数据存储在任何自定义目录中，包括代理实例目录之外的位置。在 & lt;broker_instance_dir> \etc\artemis.profile 文件中，通过在创建代理实例后指定自定义目录的位置来更新 ARTEMIS_INSTANCE_ETC_URI 属性。在以前的版本中，这些配置文件和数据只能存储在代理实例的目录中的 \etc 和 \data 目录中。

第 3 章使用命令行界面

命令行界面(CLI)允许使用交互式终端与消息代理交互。使用 CLI 管理代理操作、配置消息并输入有用的命令。

命令行界面(CLI)允许使用交互式过程将用户和角色添加到文件中。

3.1. 启动代理实例

代理实例是一个包含所有配置和运行时数据的目录，如日志和数据文件。运行时数据与唯一的代理进程关联。

您可以使用 artemis 脚本、作为 Linux 服务或 Windows 服务，在前台启动代理。

3.1.1. 启动代理实例

创建代理实例后，您将使用 artemis run 命令启动它。

流程

切换到安装期间创建的用户帐户。
```
$ su - amq-broker
```

使用 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。

3.1.2. 将代理作为 Linux 服务启动

如果在 Linux 上安装了代理，您可以将其作为服务运行。

流程

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

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

根据代理实例创建过程中提供的信息，修改路径和用户字段。在以下示例中，用户 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

打开终端。
使用以下命令启用代理服务：
```
sudo systemctl enable amq-broker
```
使用以下命令运行代理服务：
```
sudo systemctl start amq-broker
```

3.1.3. 将代理作为 Windows 服务启动

如果在 Windows 上安装代理，您可以将其作为服务运行。

流程

打开命令提示输入命令

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

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

使用以下命令启动服务：

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

（可选）卸载服务：

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

3.2. 停止代理实例

手动停止代理实例，或者将代理配置为正常关闭。

3.2.1. 停止 broker 实例

创建独立代理并生成和使用测试消息后，您可以停止代理实例。

此流程手动停止代理，代理强制关闭所有客户端连接。在生产环境中，您应该将代理配置为正常停止，以便正确关闭客户端连接。

流程

使用 artemis stop 命令停止代理实例：

$ /var/opt/amq-broker/mybroker/bin/artemis stop
2018-12-03 14:37:30,630 INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.6.1.amq-720004-redhat-1 [b6c244ef-f1cb-11e8-a2d7-0800271b03bd] stopped, uptime 35 minutes
Server stopped!

3.2.2. 正常停止代理实例

输入 stop 命令后，手动关闭会强制断开所有客户端的连接。作为替代方案，使用启用了 graceful-shutdown 的配置元素将代理配置为安全关闭。

当启用 graceful-shutdown-enabled 时，在输入 stop 命令后不会允许新的客户端连接。但是，在关闭过程启动前，允许现有连接在客户端上关闭。graceful-shutdown-enabled 的默认值为 false。

使用 graceful-shutdown-timeout 配置元素设置长度（以毫秒为单位），客户端在强制从代理端关闭连接前断开连接。在所有连接关闭后，关闭过程将启动。使用 graceful-shutdown-timeout 的一个优点是它可防止客户端连接延迟关闭。graceful-shutdown-timeout 的默认值为 -1，这意味着代理会无限期等待客户端断开连接。

以下步骤演示了如何配置使用超时的安全关闭。

流程

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

添加 graceful-shutdown-enabled 配置元素，并将值设为 true。

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

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

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

3.3. 通过截获数据包进行审核消息

截获数据包进入或退出代理，以审核数据包或过滤信息。拦截器会更改其截获的数据包。这使得拦截器功能强大，但也会出现危险性。

开发拦截器以满足您的业务需求。拦截器是特定于协议的，必须实现适当的接口。

拦截器必须实现 intercept（） 方法，该方法返回布尔值。如果值为 true，则消息数据包将继续返回。如果为 false，则进程中止，不会调用其他拦截器，且不会进一步处理消息数据包。

3.3.1. 创建拦截器

拦截器可能会更改其被截获的数据包。您可以创建自己的传入和传出拦截器。所有拦截器都是特定的协议，为分别进入或退出服务器的任何数据包调用。这可让您创建拦截器来满足商业要求，如审核数据包。

拦截器及其依赖项必须放在代理的 Java 类路径中。您可以使用 &lt ;broker_instance_dir> /lib 目录，因为它是 classpath 的一部分。

以下示例演示了如何创建检查传递给它的每个数据包的拦截器。

注意

示例为每个协议实施特定的接口。

流程

实施适当的接口并覆盖其 intercept（） 方法。

如果您使用 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;
  }
}

如果您使用的是内核协议，您的拦截器必须实施 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;
  }
}

如果您使用 IFL 协议，实施 org.apache.activemq.artemis.core.protocol.mqtt.awxInterceptor 接口。

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

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

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

3.3.2. 配置代理以使用拦截器

先决条件

创建拦截器类，并将其添加到代理的 Java 类路径中（及其依赖项）。您可以使用 &lt ;broker_instance_dir> /lib 目录，因为它是 classpath 的一部分。

流程

Open <broker_instance_dir>/etc/broker.xml

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

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

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

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

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

3.3.3. 客户端上的拦截器

客户端可以使用拦截器来截获客户端发送到服务器或服务器到客户端的数据包。如果代理拦截器返回 false 值，则不会调用其他拦截器，客户端不会进一步处理数据包。除非以 阻塞 方式发送传出数据包，否则此进程会透明地发生。在本例中，ActiveMQException 会抛出给调用者。引发 ActiveMQException 包含返回 false 值的拦截器的名称。

在服务器中，客户端拦截器类及其依赖项必须添加到客户端的 Java 类路径中，才能正确实例化和调用。

3.4. 检查代理和队列的健康状况

AMQ Broker 包括一个命令行实用程序，可让您在代理拓扑中对代理和队列执行各种健康检查。

以下示例演示了如何使用实用程序来运行健康检查。

流程

请参阅代理拓扑中可为特定代理（即节点）运行的检查列表。

$ <broker_instance_dir>/bin/artemis help check node

您会看到输出来描述可与 artemis 检查节点命令一起使用的选项列表。

NAME
        artemis check node - Check a node

SYNOPSIS
        artemis check node [--backup] [--clientID <clientID>]
                [--diskUsage <diskUsage>] [--fail-at-end] [--live]
                [--memoryUsage <memoryUsage>] [--name <name>] [--password <password>]
                [--peers <peers>] [--protocol <protocol>] [--silent]
                [--timeout <timeout>] [--up] [--url <brokerURL>] [--user <user>]
                [--verbose]

OPTIONS
        --backup
            Check that the node has a backup

        --clientID <clientID>
            ClientID to be associated with connection

        --diskUsage <diskUsage>
            Disk usage percentage to check or -1 to use the max-disk-usage

        --fail-at-end
            If a particular module check fails, continue the rest of the checks

        --live
            Check that the node has a live

        --memoryUsage <memoryUsage>
            Memory usage percentage to check

        --name <name>
            Name of the target to check

        --password <password>
            Password used to connect

        --peers <peers>
            Number of peers to check

        --protocol <protocol>
            Protocol used. Valid values are amqp or core. Default=core.

        --silent
            It will disable all the inputs, and it would make a best guess for any required input

        --timeout <timeout>
            Time to wait for the check execution, in milliseconds

        --up
            Check that the node is started, it is executed by default if there are no other checks

        --url <brokerURL>
            URL towards the broker. (default: tcp://localhost:61616)

        --user <user>
            User used to connect

        --verbose
            Adds more information on the execution

例如，检查本地代理的磁盘用量是否低于为代理配置的最大磁盘用量。
```
$ <broker_instance_dir>/bin/artemis check node --url tcp://localhost:61616 --diskUsage -1

Connection brokerURL = tcp://localhost:61616
Running NodeCheck
Checking that the disk usage is less then the max-disk-usage ... success
Checks run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.065 sec - NodeCheck
```
在前面的示例中，为 --diskUsage 选项指定 -1 的值意味着，实用程序会根据为代理配置 的最大 磁盘用量检查磁盘用量。代理的最大磁盘用量是使用 broker.xml 配置文件中的 max-disk-usage 参数进行配置。为 max-disk-usage 指定的值代表代理允许使用的可用物理磁盘空间百分比。

查看您可以在代理拓扑中为特定队列运行的检查列表。

$ <broker_instance_dir>/bin/artemis help check queue

您看到输出来描述可与 artemis 检查队列命令一起使用的选项列表。

NAME
        artemis check queue - Check a queue

SYNOPSIS
        artemis check queue [--browse <browse>] [--clientID <clientID>]
                [--consume <consume>] [--fail-at-end] [--name <name>]
                [--password <password>] [--produce <produce>] [--protocol <protocol>]
                [--silent] [--timeout <timeout>] [--up] [--url <brokerURL>]
                [--user <user>] [--verbose]

OPTIONS
        --browse <browse>
            Number of the messages to browse or -1 to check that the queue is
            browsable

        --clientID <clientID>
            ClientID to be associated with connection

        --consume <consume>
            Number of the messages to consume or -1 to check that the queue is consumable

        --fail-at-end
            If a particular module check fails, continue the rest of the checks

        --name <name>
            Name of the target to check

        --password <password>
            Password used to connect

        --produce <produce>
            Number of the messages to produce

        --protocol <protocol>
            Protocol used. Valid values are amqp or core. Default=core.

        --silent
            It will disable all the inputs, and it would make a best guess for any required input

        --timeout <timeout>
            Time to wait for the check execution, in milliseconds

        --up
            Check that the queue exists and is not paused, it is executed by default if there are no other checks

        --url <brokerURL>
            URL towards the broker. (default: tcp://localhost:61616)

        --user <user>
            User used to connect

        --verbose
            Adds more information on the execution

实用程序可以通过单个命令执行多个选项。例如，要在本地代理的默认 helloworld 队列上检查 production、浏览和消耗 1000 个消息，请使用以下命令：

$ <broker_instance_dir>/bin/artemis check queue --name helloworld --produce 1000 --browse 1000 --consume 1000

Connection brokerURL = tcp://localhost:61616
Running QueueCheck
Checking that a producer can send 1000 messages to the queue helloworld ... success
Checking that a consumer can browse 1000 messages from the queue helloworld ... success
Checking that a consumer can consume 1000 messages from the queue helloworld ... success
Checks run: 3, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.882 sec - QueueCheck

在前面的示例中，观察您在运行队列检查时没有指定代理 URL。如果您没有明确指定 URL，实用程序将使用默认值 tcp://localhost:61616。

3.5. 命令行工具

AMQ Broker 包括一组命令行界面(CLI)工具，以便您可以管理消息传递日志。下表列出了每个工具的名称及其对应的描述。

工具	描述
address	地址工具组(create/delete/update/show)（示例 `./artemis address create`）。
browser	浏览实例上的消息。
消费者	使用实例上的消息。
data	打印有关日志记录的报告并压缩数据。
解码	从编码导入内部日志格式。
encode	显示为字符串编码的日志的内部格式。
exp	使用特殊和独立 XML 格式导出消息数据。
帮助	显示帮助信息。
imp	使用 `exp` 提供的输出将日志导入到正在运行的代理。
kill	终止通过 --allow-kill 启动的代理实例。
mask	屏蔽密码并将其打印出来。
perf-journal	计算应用于当前数据文件夹的 journal-buffer 超时。
队列	队列工具组(create/delete/update/stat)(example `./artemis queue create`)。
run	运行代理实例。
stop	停止代理实例。
user	默认基于文件的用户手册(add/rm/list/reset)（示例 `./artemis 用户列表`）

有关每个工具可用命令的完整列表，请使用 help 参数和工具的名称。例如，在以下示例中，CLI 输出会在用户进入命令 ./artemis 帮助数据后列出数据 工具可用的所有命令。

$ ./artemis help data

NAME
        artemis data - data tools group
        (print|imp|exp|encode|decode|compact) (example ./artemis data print)

SYNOPSIS
        artemis data
        artemis data compact [--broker <brokerConfig>] [--verbose]
                [--paging <paging>] [--journal <journal>]
                [--large-messages <largeMessges>] [--bindings <binding>]
        artemis data decode [--broker <brokerConfig>] [--suffix <suffix>]
                [--verbose] [--paging <paging>] [--prefix <prefix>] [--file-size <size>]
                [--directory <directory>] --input <input> [--journal <journal>]
                [--large-messages <largeMessges>] [--bindings <binding>]
        artemis data encode [--directory <directory>] [--broker <brokerConfig>]
                [--suffix <suffix>] [--verbose] [--paging <paging>] [--prefix <prefix>]
                [--file-size <size>] [--journal <journal>]
                [--large-messages <largeMessges>] [--bindings <binding>]
        artemis data exp [--broker <brokerConfig>] [--verbose]
                [--paging <paging>] [--journal <journal>]
                [--large-messages <largeMessges>] [--bindings <binding>]
        artemis data imp [--host <host>] [--verbose] [--port <port>]
                [--password <password>] [--transaction] --input <input> [--user <user>]
        artemis data print [--broker <brokerConfig>] [--verbose]
                [--paging <paging>] [--journal <journal>]
                [--large-messages <largeMessges>] [--bindings <binding>]

COMMANDS
        With no arguments, Display help information

        print
            Print data records information (WARNING: don't use while a
            production server is running)

        ...

您可以使用 help 参数来获得如何执行每个命令的更多信息。例如，CLI 在用户进入 ./artemis 帮助数据打印后列出了 data print 命令的更多信息。

$ ./artemis help data print

NAME
        artemis data print - Print data records information (WARNING: don't use
        while a production server is running)

SYNOPSIS
        artemis data print [--bindings <binding>] [--journal <journal>]
                [--paging <paging>]

OPTIONS
        --bindings <binding>
            The folder used for bindings (default ../data/bindings)

        --journal <journal>
            The folder used for messages journal (default ../data/journal)

        --paging <paging>
            The folder used for paging (default ../data/paging)

第 4 章使用 AMQ 管理控制台

AMQ 管理控制台是 AMQ Broker 安装中包含的 Web 控制台，可让您使用 Web 浏览器来管理 AMQ Broker。

AMQ 管理控制台基于 hawtio。

4.1. 概述

AMQ Broker 是一个功能齐全的面向消息的中间件代理。它提供了专用的队列行为、消息持久性和易管理性。它支持多种协议和客户端语言，从而让您自由使用许多应用程序资产。

AMQ Broker 的主要功能允许您：

监控 AMQ 代理和客户端
- 查看拓扑
- 查看网络健康状况一览
使用以下命令管理 AMQ 代理：
- AMQ 管理控制台
- 命令行界面(CLI)
- 管理 API

AMQ 管理控制台支持的 Web 浏览器是 Firefox 和 Chrome。有关支持的浏览器版本的更多信息，请参阅 AMQ 7 支持的配置。

4.2. 配置本地和远程访问 AMQ 管理控制台

本节中的步骤演示了如何配置本地和远程访问 AMQ 管理控制台。

远程访问控制台可采用两种形式之一：

在本地代理上的控制台会话中，您可以使用 Connect 选项卡连接到另一个远程代理
从远程主机，您可以使用本地代理的外部可访问 IP 地址连接到本地代理的控制台

先决条件

您必须升级到至少 AMQ Broker 7.1.0。作为此升级的一部分，将添加名为 jolokia-access.xml 的访问控制配置文件到代理实例中。有关升级的更多信息，请参阅将代理实例从 7.0.x 升级到 7.1.0。

流程

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

在 web 元素中，观察 Web 端口默认为仅绑定到 localhost。

<web path="web">
  <binding uri="http://localhost:8161">
    <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"/>
  </binding>
</web>

要从远程主机启用到本地代理的控制台的连接，请将 Web 端口绑定改为网络可访问接口。例如：
```
<web path="web">
  <binding uri="http://0.0.0.0:8161">
```
在前面的示例中，指定 0.0.0.0，您可以将 Web 端口绑定到本地代理 上的所有 接口。
保存 bootstrap.xml 文件。
打开 & lt;broker_instance_dir> /etc/jolokia-access.xml 文件。
在 & lt;cors >（即 Cross-Origin Resource Sharing）元素中，为每个要允许访问控制台的每个 HTTP 原始请求标头添加 allow-origin 条目。例如：
```
<cors>
   <allow-origin>*://localhost*</allow-origin>
   <allow-origin>*://192.168.0.49*</allow-origin>
   <allow-origin>*://192.168.0.51*</allow-origin>
   
   <strict-checking/>
</cors>
```
在上述配置中，您可以指定允许以下连接：
- 从本地主机（即本地代理实例的主机）到控制台的连接。
  - 第一个星号(*)通配符字符允许在连接请求中指定 http 或 https 方案，具体取决于您是否为安全连接配置了控制台。
  - 第二个星号通配符字符允许主机上的任何端口都用于连接。
- 使用本地代理的可外部可访问 IP 地址，从远程主机到本地代理控制台的连接。在这种情况下，本地代理的外部可访问 IP 地址为 192.168.0.49。
- 从另一个控制台会话中打开的、远程代理到本地代理的连接。在本例中，远程代理的 IP 地址为 192.168.0.51。
保存 jolokia-access.xml 文件。
打开 & lt;broker_instance_dir> /etc/artemis.profile 文件。
要在控制台中启用 Connect 选项卡，请将 Dhawtio.disableProxy 参数的值设置为 false。
```
-Dhawtio.disableProxy=false
```
重要
建议您从控制台启用远程连接（即，仅当控制台公开给安全网络时，把 Dhawtio.disableProxy 参数的值设置为 false）。
将一个新的参数 Dhawtio.proxyWhitelist 添加到 Java 系统参数的 JAVA_ARGS 列表中。作为以逗号分隔的列表，为您要从本地代理连接的任何远程代理指定 IP 地址（也就是说，通过在本地代理中运行的控制台会话中使用 Connect 选项卡）。例如：
```
-Dhawtio.proxyWhitelist=192.168.0.51
```
根据前面的配置，您可以使用本地代理控制台会话中的 Connect 选项卡连接到另一个，远程代理的 IP 地址为 192.168.0.51。
保存 is tmis.profile 文件。

其他资源

要了解如何访问控制台，请参阅第 4.3 节 “访问 AMQ 管理控制台”。
有关以下内容的更多信息：
- 跨资源共享，请参阅 W3C 建议。
- Jolokia security，请参阅 Jolokia Protocols。
- 保护到控制台的连接，请参阅第 4.4.3 节 “保护对 AMQ 管理控制台的网络访问”。

4.3. 访问 AMQ 管理控制台

本节中的步骤显示如何：

从本地代理打开 AMQ 管理控制台
从本地代理控制台会话中连接到其他代理
使用本地代理的可外部访问 IP 地址从远程主机打开本地代理的控制台实例

先决条件

您必须已经配置对控制台的本地和远程访问权限。更多信息请参阅第 4.2 节 “配置本地和远程访问 AMQ 管理控制台”。

流程

在网页浏览器中，导航到本地代理的控制台地址。
控制台地址为 http:// <host:port> /console/login。如果您使用默认地址，请导航到 http://localhost:8161/console/login。否则，使用为 < broker_instance_dir> /etc/bootstrap.xml 配置文件中 web 元素的 bind 属性定义的主机和端口值。
图 4.1. 控制台登录页面
使用您在创建代理时创建的默认用户名和密码登录到 AMQ Management Console。
要连接到另一个，从本地代理的控制台会话中远程代理：
1. 在左侧菜单中，单击" 连接 "选项卡。
2. 在主窗格中，在" 远程 "选项卡中，单击" 添加连接 "按钮。
3. 在 Add Connection 对话框中指定以下详情：
  名称
  远程连接的名称，如 my_other_broker。
  Scheme
  用于远程连接的协议。选择 http 作为不安全的连接，或使用 https 进行安全连接。
  主机
  远程代理的 IP 地址。您必须已经为这个远程代理配置了控制台访问权限。
  端口
  用于远程连接的本地代理上的端口。指定 < broker_instance_dir> /etc/bootstrap.xml 配置文件中 web 元素的 bind 属性定义的端口值。默认值为 8161。
  路径
  用于控制台访问的路径。指定 console/jolokia。
4. 要测试连接，请单击 Test Connection 按钮。
  如果连接测试成功，点 添加按钮。如果连接测试失败，请根据需要检查并修改连接详情。再次测试连接。
5. 在远程 页面中，在您添加的连接中点击 Connect 按钮。
  在远程代理中为控制台实例打开一个新的 Web 浏览器标签页。
6. 在 Log In 对话框中，为远程代理输入用户名和密码。点 Log In。
  远程代理的控制台实例将打开。
要从远程主机连接到本地代理的控制台，在 web 浏览器中为本地代理指定 Jolokia 端点。此端点包括您在配置远程控制台访问时为本地代理指定的外部可访问 IP 地址。例如：
```
http://192.168.0.49/console/jolokia
```

4.4. 配置 AMQ 管理控制台

配置用户访问权限并请求对代理上的资源的访问权限。

4.4.1. 使用红帽单点登录保护 AMQ 管理控制台

先决条件

Red Hat Single Sign-On 7.4

流程

配置红帽单点登录：
1. 导航到您要用于保护 AMQ Management 控制台的 Red Hat Single Sign-On 中的域。Red Hat Single Sign-On 中的每个域都包括一个名为 Broker 的客户端。这个客户端与 AMQ 无关。
2. 在红帽单点登录中创建一个新客户端，例如 artemis-console。
3. 进入客户端设置页面并设置：
  - 有效的 Redirect URI 到 AMQ 管理控制台 URL，后接 *，例如：
    https://broker.example.com:8161/console/*
  - Web Origin 的值与 有效的重定向 URI 相同。Red Hat Single Sign-On 允许您输入 +，表示允许 CORS origins 包含 有效的重定向 URI 的值。
4. 为客户端创建一个角色，如 guest。
5. 确保所有需要访问 AMQ 管理控制台的用户都被分配了上述角色，例如，使用红帽单点登录组。

配置 AMQ Broker 实例：

在您的 < 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
    ;
};
```
添加此配置会设置 Inventories 主体和来自 Red Hat Single Sign-On 的 bearer 令牌的要求。与 Red Hat Single Sign-On 的连接在 keycloak-bearer-token.json 文件中定义，如下一步中所述。
创建一个文件 & lt;broker-instance-dir> /etc/keycloak-bearer-token.json，以指定用于 bearer 令牌交换的红帽单点登录：
```
{
  "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
创建一个文件 &lt ;broker-instance-dir> /etc/keycloak-js-token.json，以指定 Red Hat Single Sign-On 身份验证端点：
```
{
  "realm": "<realm-name>",
  "clientId": "<client-name>",
  "url": "<RHSSO-URL>/auth"
}
```

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

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

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

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

4.4.2. 设置用户对 AMQ 管理控制台的访问

您可以使用代理登录凭证访问 AMQ 管理控制台。下表提供有关添加额外代理用户来访问 AMQ Management 控制台的不同方法的信息：

身份验证方法	描述
虚拟机验证	启用匿名访问。在这个配置中，任何没有凭证连接或有错误凭证的用户都会自动进行身份验证并分配特定的用户和角色。如需更多信息，请参阅配置 AMQ Broker 中的客户端访问。
基本用户和密码身份验证	对于每个用户，您必须定义一个用户名和密码并分配一个安全角色。用户只能使用这些凭证登录到 AMQ 管理控制台。如需更多信息，请参阅配置 AMQ Broker 中的基本用户和密码身份验证。
LDAP 身份验证	对存储在中央 X.500 目录服务器中的用户数据检查凭据来验证和授权用户。如需更多信息，请参阅配置 LDAP 以验证配置 AMQ Broker 中的客户端。

身份验证方法

描述

虚拟机验证

启用匿名访问。在这个配置中，任何没有凭证连接或有错误凭证的用户都会自动进行身份验证并分配特定的用户和角色。

如需更多信息， 请参阅配置 AMQ Broker 中的客户端访问。

基本用户和密码身份验证

对于每个用户，您必须定义一个用户名和密码并分配一个安全角色。用户只能使用这些凭证登录到 AMQ 管理控制台。

如需更多信息， 请参阅配置 AMQ Broker 中的基本用户和密码身份验证。

LDAP 身份验证

对存储在中央 X.500 目录服务器中的用户数据检查凭据来验证和授权用户。

4.4.3. 保护对 AMQ 管理控制台的网络访问

要在通过 WAN 或互联网访问控制台时保护 AMQ 管理控制台，请使用 SSL 指定网络访问使用 https 而不是 http。

先决条件

以下位于 < broker_instance_dir>/etc/ 目录中：

Java 关键存储
Java 信任存储（只在需要客户端身份验证时才需要）

流程

打开 & lt;broker_instance_dir> /etc/bootstrap.xml 文件。
在 & 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
信任存储密码。此密码可以加密。

其他资源

有关在代理配置文件中加密密码的更多信息，包括 bootstrap.xml，请参阅配置文件中的加密密码。

4.4.4. 配置 AMQ 管理控制台以使用基于证书的身份验证

您可以使用证书而不是密码配置 AMQ 管理控制台来验证用户。

流程

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

为代理生成自签名证书。

$ 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

从代理密钥存储导出证书，以便它与客户端共享。

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

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

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

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

$ 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

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

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

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

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

注意

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

在 & 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>
...
```
绑定 uri
指定启用 SSL 的 https 协议并添加主机名和端口。
keystorePath
安装代理证书的密钥存储的路径。
keystorePassword
安装代理证书的密钥存储的密码。
ClientAuth
设置为 true 以要求当客户端尝试连接到代理控制台时，每个客户端都提供证书。
trustStorePath
如果客户端使用自签名证书，请指定安装客户端证书的信任存储的路径。
trustStorePassword
如果客户端使用自签名证书，请指定安装客户端证书的信任存储中的密码。
注意：只有在客户端使用自签名证书时，才需要配置 trustStorePath 和 trustStorePassword 属性。

从每个客户端证书获取 Subject Disuish ed Names (DNs)，以便您可以在每个客户端证书和代理用户之间创建一个映射。

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

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

输出导出的证书的内容：

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`

为代理控制台启用基于证书的身份验证。
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/login.config 文件中的 -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 代理用户映射到具有对象区分名称 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 变量的默认值为 mq。例如：
```
amq=user1, user2
```
为 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
```

4.5. 使用 AMQ 管理控制台管理代理

您可以使用 AMQ Management Console 查看有关正在运行的代理和管理以下资源的信息：

传入网络连接（接收器）
地址
队列

4.5.1. 查看代理详情

要查看如何配置代理，请在左侧菜单中，单击 Automatically。在文件夹树中，默认选择本地代理。

在主窗格中，有以下标签页可用：

状态: 显示代理的当前状态信息，如正常运行时间和集群信息。另外，还显示代理当前使用的地址内存量。图显示这个值作为 global-max-size 配置参数的比例。
图 4.2. Status 选项卡
连接: 显示代理连接的信息，包括客户端、集群和网桥连接。
sessions: 显示有关当前在代理上打开的所有会话的信息。
消费者: 显示代理当前打开的所有消费者的信息。
producers: 显示代理当前打开的生产者信息。
地址: 显示代理中地址的信息。这包括内部地址，如 store-and-forward 地址。
队列: 显示代理上队列的信息。这包括内部队列，如 store-and-forward 队列。
属性: 显示代理上配置的属性的详细信息。
操作: 显示可以从控制台在代理上执行的 JMX 操作。当您点一个操作时，会打开对话框，供您为操作指定参数值。
chart: 显示代理上配置的属性的实时数据。您可以编辑 chart，以指定 chart 中包含的属性。
代理图: 显示集群拓扑图。这包括集群中的所有代理以及本地代理的任何地址和队列。

4.5.2. 查看代理图

您可以查看拓扑中的所有 AMQ Broker 资源图表，包括代理（live 和 backup 代理）、生产者和消费者、地址和队列。

流程

在左侧菜单中，单击 Artemis。
在主窗格中，点击 Broker diagram 选项卡。
控制台显示集群拓扑图。这包括集群中的所有代理以及本地代理上的地址和队列，如图所示。
图 4.3. 代理图表标签页
要更改图表中显示的项目，请使用图表顶部的复选框。点 Refresh。
要显示本地代理或连接的地址或队列的属性，请点击图表中的该节点。例如，下图显示了一个图表，其中还包含本地代理的属性。
图 4.4. 代理图标签页，包括属性

4.5.3. 查看接收器

您可以查看为代理配置的接收器详情。

流程

在左侧菜单中，单击 Artemis。
在文件夹树中，单击 接收器。
要查看有关如何配置接收器的详细信息，请单击 acceptor。
控制台在 Attributes 选项卡上显示对应的属性，如图中所示。
图 4.5. AMQP 接受器属性
要查看属性的完整详情，请点击属性。此时会打开一个额外的窗口来显示详情。

4.5.4. 管理地址和队列

地址代表消息传递端点。在配置中，为典型的地址提供一个唯一名称。

队列与地址相关联。每个地址可以有多个队列。传入的消息与地址匹配后，该消息将发送到一个或多个队列，具体取决于配置的路由类型。可以将队列配置为自动创建和删除队列。

4.5.4.1. 创建地址

典型的地址被授予唯一的名称、零个或多个队列，以及路由类型。

路由类型决定了如何将消息发送到与地址关联的队列。可以使用两个不同的路由类型配置地址。

如果您希望您的消息被路由到…	使用此路由类型…
匹配地址内的单个队列，以点对点的方式进行。	任播
匹配地址中的每个队列，以发布与订阅的方式进行发布。	多播

您可以创建和配置地址和队列，然后在不再使用它们时将其删除。

流程

在左侧菜单中，单击 Artemis。
在文件夹树中，点地址。
在主窗格中，单击 Create address 选项卡。
此时会出现一个页面供您创建一个地址，如下图所示。
图 4.6. 创建地址页面
完成以下字段：
地址名称
地址的路由名称。
路由类型
选择以下选项之一：
多播 ：发送到地址的消息将以发布与订阅方式分发给所有订阅者。
任播 ：发送到此地址的消息将以点对点的方式仅发给一个订阅者。
两者 ：使您能够为每个地址定义多个路由类型。这通常会产生一个反模式，我们不推荐这样做。
注意
如果地址同时使用路由类型，且客户端没有显示其首选，则代理会默认使用 anycast 路由类型。一个例外是，当客户端使用 [...] 协议时。在这种情况下，默认路由类型是 多播。
点 Create Address。

4.5.4.2. 发送消息到地址

以下流程演示了如何使用控制台向地址发送消息。

流程

在左侧菜单中，单击 Artemis。
在文件夹树中，选择一个地址。
在主窗格的导航栏中，单击 More → Send 消息。
此时会出现一个页面来创建一个信息，如下图所示。
图 4.7. 发送消息页
如果需要，点击 Add Header 按钮来添加消息标头信息。
输入邮件正文。
在 Format 下拉菜单中选择消息正文格式的选项，然后点 Format。邮件正文以人类可读样式格式化，用于您选择的格式。
单击 Send 消息。
邮件被发送。
要发送额外消息，请更改您输入的任何信息，然后单击 Send 消息。

4.5.4.3. 创建队列

队列提供制作者和消费者之间的频道。

先决条件

要绑定队列的地址必须存在。要了解如何使用控制台创建地址，请参阅第 4.5.4.1 节 “创建地址”。

流程

在左侧菜单中，单击 Artemis。
在文件夹树中，选择要绑定队列的地址。
在主窗格中，单击 Create queue 选项卡。
系统会显示一个页面，供您创建一个队列，如图所示。
图 4.8. 创建队列页面
完成以下字段：
队列名称
队列的唯一名称。
路由类型
选择以下选项之一：
多播 ：发送到父地址的消息将分发到所有绑定到地址的队列。
任播 ：只有一个绑定到父地址的队列将收到消息的副本。消息会在绑定到地址的所有队列中均匀分布。
durable
如果选择这个选项，则队列及其消息将具有持久性。
Filter
连接到代理时使用的用户名。
max Consumers
在给定时间可以访问队列的最大用户数量。
当没有消费者时清除
如果选中，则队列将在没有用户连接时清除。
单击 Create Queue。

4.5.4.4. 检查队列的状态

chart 为代理上的队列状态提供实时视图。

流程

在左侧菜单中，单击 Artemis。
在文件夹树中，导航到队列。
在主窗格中，单击 Chart 选项卡。
控制台会显示一个图表，显示所有队列属性的实时数据。
图 4.9. 队列的图表标签
注意
要查看地址上多个队列的图表，请选择包含队列的 任播 或 多播 文件夹。
如果需要，为 chart 选择不同的条件：
1. 在主窗格中，单击编辑。
2. 在 Attributes 列表中，选择要包含在图表中的一个或多个属性。要选择多个属性，请按并按住 Ctrl 键并选择每个属性。
3. 点 View Chart 按钮。根据您选择的属性更新图表。

4.5.4.5. 浏览队列

浏览队列可显示队列中的所有消息。您还可以过滤列表并排序列表来查找特定的消息。

流程

在左侧菜单中，单击 Artemis。
在文件夹树中，导航到队列。
队列位于其绑定到的地址中。
在主窗格的导航栏中，单击 More → Browse queue。
此时会显示队列中的消息。默认情况下会显示前 200 信息。
图 4.10. 浏览 Queue 页面

要浏览特定消息或一组信息，请执行以下操作之一：

to…	这些以下操作
过滤信息列表	在 `Filter…` 文本字段中，输入过滤器条件。点击搜索（即放大镜图标）。
对信息列表进行排序	在消息列表中，点击列标题。要以降序方式对消息进行排序，请再次单击标题一。

要查看邮件的内容，请单击 Show 按钮。
您可以查看邮件标头、属性和正文。

4.5.4.6. 将消息发送到队列

创建队列后，您可以向它发送消息。以下流程概述了向现有队列发送消息所需的步骤。

流程

在左侧菜单中，单击 Artemis。
在文件夹树中，导航到队列。
在主窗格中，单击 Send 消息 选项卡。
系统会显示一个页面，供您编写消息。
图 4.11. 发送队列的消息页
如果需要，点击 Add Header 按钮来添加消息标头信息。
输入邮件正文。
在 Format 下拉菜单中选择消息正文格式的选项，然后点 Format。邮件正文以人类可读样式格式化，用于您选择的格式。
单击 Send 消息。邮件被发送。
要发送附加消息，请更改您输入的任何信息，然后单击 Send 消息。

4.5.4.7. 将消息重新发送到队列

您可以重新发送的信息。

流程

浏览您要重新发送的消息。
点您要重新发送的消息旁边的复选框。
点 Resend 按钮。此时会显示这个信息。
根据需要更新邮件标题和正文，然后单击 Send 消息。

4.5.4.8. 将消息移动到不同的队列

您可以将队列中的一个或多个消息移动到不同的队列中。

流程

浏览您要移动的消息。
点您要移动的每个消息旁边的复选框。
在导航栏中，单击 Move Messages。
此时会出现确认对话框。
在下拉菜单中选择您要移动消息的队列名称。点 Move。

4.5.4.9. 删除消息或队列

您可以删除队列或清除队列中的所有消息。

流程

浏览要删除的队列或清除。

执行以下操作之一：

to…	这些以下操作
从队列中删除消息	点您要删除的每个消息旁边的复选框。点击 Delete 按钮。
清除队列中的所有消息	在主窗格的导航栏上，单击 Delete queue。点 Purge Queue 按钮。
删除队列	在主窗格的导航栏上，单击 Delete queue。单击 Delete Queue 按钮。

第 5 章监控代理运行时指标

安装 AMQ Broker 时，安装中包含 Prometheus metrics 插件。Prometheus 是为监控大型的可扩展系统而构建的软件，并在延长的时间段内存储历史运行时数据。您必须修改代理配置来启用插件。启用后，插件会为代理收集运行时指标，并将其导出到 Prometheus 格式。然后，您可以使用 Prometheus 查看指标。您还可以使用图形工具（如 Grafana）来配置更加高级数据的视觉化。

注意

Prometheus metrics 插件可让您以 Prometheus 格式收集和导出代理指标。但是，红帽不提供 安装或配置 Prometheus 本身以及 Grafana 等视觉化工具的支持。如果您需要安装、配置或运行 Prometheus 或 Grafana 的支持，请访问产品网站以获取社区支持和文档。

除了 Prometheus 插件收集的代理指标外，您还可以修改代理配置，以捕获与代理主机 Java 虚拟机(JVM)相关的标准指标集合。特别是，您可以捕获 Garbage Collection(GC)、内存和线程的 JVM 指标。

以下描述了以下部分：

Prometheus 插件导出的指标
如何启用 Prometheus 插件
如何配置代理以收集 JVM 指标

5.1. 指标概述

要监控代理实例的健康状态和性能，您可以使用 AMQ Broker 的 Prometheus 插件来监控和存储代理运行时指标。AMQ Broker Prometheus 插件将代理运行时指标导出到 Prometheus 格式，可让您使用 Prometheus 本身来视觉化并运行数据的查询。

您还可以使用图形工具（如 Grafana）为 Prometheus 插件收集的指标配置更高级的视觉化和仪表板。

插件导出到 Prometheus 格式的指标如下所述。

代理指标

artemis_address_memory_usage: 此代理上的所有地址用于内存消息的字节数。
artemis_address_memory_usage_percentage: 此代理上的所有地址使用的内存作为 global-max-size 参数的百分比。
artemis_connection_count: 连接到此代理的客户端数。
artemis_total_connection_count: 自从启动以来连接到此代理的客户端数。

地址指标

artemis_routed_message_count: 路由到一个或多个队列绑定的消息数。
artemis_unrouted_message_count: 不路由到任何队列绑定的消息数。

队列指标

artemis_consumer_count: 使用来自给定队列的消息的客户端数。
artemis_delivering_durable_message_count: 给定队列当前为消费者发送的持久消息的数量。
artemis_delivering_durable_persistent_size: 给定队列当前为消费者提供的持久消息大小。
artemis_delivering_message_count: 指定队列当前提供给消费者的消息数。
artemis_delivering_persistent_size: 给定队列当前为消费者传输的消息的持久性大小。
artemis_durable_message_count: 给定队列中当前具有持久性消息的数量。这包括调度、页面和发送中消息。
artemis_durable_persistent_size: 目前在给定队列中持久化消息的大小。这包括调度、页面和发送中消息。
artemis_messages_acknowledged: 从创建队列后确认来自给定队列的消息数。
artemis_messages_added: 自队列创建以来添加到给定队列的消息数。
artemis_message_count: 给定队列中当前的消息数。这包括调度、页面和发送中消息。
artemis_messages_killed: 从创建队列后，从给定队列中删除的消息数量。当消息超过配置的最大交付尝试次数时，代理会终止一条消息。
artemis_messages_expired: 自创建队列后，从给定队列已过期的消息数。
artemis_persistent_size: 当前处于给定队列中的所有消息的持久性大小（durable 和不可durable）。这包括调度、页面和发送中消息。
artemis_scheduled_durable_message_count: 给定队列中调度的消息数量。
artemis_scheduled_durable_persistent_size: 持久大小，在给定队列中调度的消息。
artemis_scheduled_message_count: 指定队列中调度的消息数。
artemis_scheduled_persistent_size: 在给定队列中调度的消息的持久性大小。

对于以上未列出的高级代理指标，您可以通过聚合较低级别指标来计算这些指标。例如，要计算总消息计数，您可以聚合代理部署中的所有队列的 artemis_message_count 指标。

对于 AMQ Broker 的内部部署，托管代理的 Java 虚拟机(JVM)的指标也会导出到 Prometheus 格式。这不适用于在 OpenShift Container Platform 上部署 AMQ Broker。

5.2. 为 AMQ Broker 启用 Prometheus 指标插件

安装 AMQ Broker 时，安装中包含 Prometheus metrics 插件。虽然已经配置了插件，但需要在代理配置中启用插件。启用后，插件会为代理收集运行时指标，并将其导出到 Prometheus 格式。

以下流程演示了如何为 AMQ Broker 启用 Prometheus 插件。

流程

将 Prometheus metrics 插件 .jar 从 AMQ Broker 7.10 提取存档复制到代理实例的 lib 目录中。

$ cp amq-broker-7.10.0/lib/artemis-prometheus-metrics-plugin-1.0.0.CR1-redhat-00010.jar <broker_instance_dir>/lib

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

在代理配置中启用 Prometheus 插件。添加带有 & lt; plugin> 子元素的 <metrics > 元素，如下所示。

<metrics>
    <plugin class-name="org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/>
</metrics>

保存 broker.xml 配置文件。metrics 插件开始以 Prometheus 格式收集代理运行时指标。

5.3. 配置代理以收集 JVM 指标

以下流程演示了如何配置代理来为 Garbage Collection(GC)、内存和线程收集 Java 虚拟机(JVM)指标。

先决条件

之前，您已在代理配置中启用了 Prometheus metrics 插件。更多信息请参阅第 5.2 节 “为 AMQ Broker 启用 Prometheus 指标插件”。

流程

打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。
在启用 Prometheus metrics 插件时 添加到配置的 <metrics> 元素中，指定代理是否收集 Garbage Collection(GC)、内存和线程的 JVM 指标。例如：
```
<metrics>
    <jvm-gc>true</jvm-gc>
    <jvm-memory>true</jvm-memory>
    <jvm-threads>true</jvm-threads>
    <plugin class-name="org.apache.activemq.artemis.core.server.metrics.plugins.ArtemisPrometheusMetricsPlugin"/>
</metrics>
```
注意
如果您没有在配置中添加 jvm-memory 参数并指定一个值，则代理将使用默认值 true。这意味着代理默认导出 JVM 内存指标。jvm-gc 和 jvm-threads 参数的默认值是 false。
保存 broker.xml 配置文件。代理开始收集您启用的 JVM 指标。这些指标也会导出到 Prometheus 格式。

5.4. 禁用特定地址的指标集合

当您为 AMQ Broker 配置指标插件时（例如，Prometheus 指标插件），指标收集会被默认启用。但是，在一个特定地址 或一组 地址的 address-setting 配置元素中，您可以明确禁用指标集合。

以下流程演示了如何为特定地址 或一组 地址禁用指标集合。

流程

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

在匹配地址 或一组 地址的 address-setting 元素中，添加 enable-metrics 参数，并将参数的值设置为 false。例如，以下配置会禁用名为 order 的地址的 指标集合。

<configuration>
  <core>
    ...
    <address-settings>
       <address-setting match="orders">
          ...
          <enable-metrics>false</enable-metrics>
          ...
       </address-setting>
    </address-settings>
    ...
  </core>
</configuration>

5.5. 使用 Prometheus 访问代理运行时数据

先决条件

要查询和视觉化由 Prometheus 插件收集的代理运行时数据，您需要安装 Prometheus。如需更多信息，请参阅 Prometheus 文档中的安装 Prometheus。

流程

在 Prometheus 安装目录中，打开 prometheus.yml 配置文件。
在配置文件的 static_configs 部分中，将 targets 元素更改为 localhost:8161。这个位置是代理运行其 Web 服务器的位置。默认情况下，/metrics 附加到此主机名，形成代理 Web 服务器上存储的指标的完整路径。
要查看 Prometheus 插件收集的代理运行时指标，请在 web 浏览器中打开 localhost:8161/metrics。
在生成的网页上，您会看到由插件收集的指标的当前值，具体取决于您在代理上配置的队列和地址。如果您的 JVM 中有多个正在运行的代理实例，您会看到每个代理的指标。
从 Prometheus 安装目录中，运行 Prometheus。
```
$ ./prometheus
```
当 Prometheus 启动时，shell 输出包括以下行：
```
component=web, msg=”Start listening for connections” address=0.0.0.0:9090
```
前面的一行表示 Prometheus 在端口 9090 上侦听 HTTP 流量。
要访问 Prometheus Web 控制台，在网页浏览器中打开 127.0.0.1:9090。
在 Prometheus web 控制台中，您可以使用 Expression 字段在代理数据中创建查询。您创建的查询基于 Prometheus 查询语言 PromQL。可用于在查询中插入的代理指标位于 Insert 指标 下拉列表中。
作为简单示例，假定您要随着时间的推移查询 DLQ 队列的消息数。在这种情况下，从 metrics 下拉列表中选择 artemis_message_count。通过指定 DLQ 队列名称和地址来完成查询。此示例查询如下所示：
```
artemis_message_count{address=“DLQ”, queue=“DLQ”}
```
如需更高级的视觉化，您可以使用正则表达式来创建覆盖多个指标的复杂查询，例如：或者，您可以在多个指标上执行数学操作，如聚合它们。有关创建 Prometheus 查询的更多信息，请参阅 Prometheus 文档中的查询 Prometheus。

第 6 章使用管理 API

AMQ Broker 有一个广泛的管理 API，可用于修改代理的配置，创建新的资源（如地址和队列）、检查这些资源（例如，当前在队列中保留多少消息），并与它们交互（例如，从队列中删除消息）。

另外，客户端可以使用管理 API 管理代理并订阅管理通知。

6.1. 使用管理 API 管理 AMQ Broker 的方法

使用管理 API 管理代理有两种方法：

使用 JMX是管理 Java 应用程序的标准方法
使用 JMS API>_<- themanagement 操作使用 JMS 消息和 AMQ JMS 客户端发送到代理

虽然管理代理的方法有两种，但每个 API 支持相同的功能。如果可以使用 JMX 管理资源，也可以通过使用 JMS 消息和 AMQ JMS 客户端来实现相同的结果。

这种选择取决于您的具体要求、应用程序设置和环境。无论您调用管理操作的方式，管理 API 也相同。

对于每个受管资源，都有 Java 接口描述可为这类资源调用什么。代理在 org.apache.activemq.artemis.api.core.management 软件包中公开其受管资源。调用管理操作的方式取决于 JMX 消息或 JMS 消息以及 AMQ JMS 客户端。

注意

有些管理操作需要 过滤器 参数来选择受操作影响的消息。传递 null 或空字符串表示将在 所有消息上执行管理操作。

6.2. 使用 JMX 管理 AMQ Broker

您可以使用 Java 管理扩展(JMX)管理代理。管理 API 由代理使用 MBeans 接口公开。代理将资源注册到域 org.apache.topic。

例如，管理名为 exampleQueue 的队列的 ObjectName 为：

org.apache.activemq.artemis:broker="__BROKER_NAME__",component=addresses,address="exampleQueue",subcomponent=queues,routingtype="anycast",queue="exampleQueue"

MBean 是：

org.apache.activemq.artemis.api.management.QueueControl

MBean 的 ObjectName 使用帮助程序类 org.apache.activemq.artemis.api.core.management.ObjectNameBuilder 来构建。您还可以使用 jconsole 查找您要管理的 MBeans 的 ObjectName。

使用 JMX 管理代理与使用 JMX 管理任何 Java 应用程序是一样的。这可以通过反映或创建 MBeans 的代理来完成。

6.2.1. 配置 JMX 管理

默认情况下，支持管理代理。您可以通过在 broker.xml 配置文件中设置 jmx-management-enabled 属性来启用或禁用 JMX 管理。

流程

打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。
设置 & lt;jmx-management-enabled>。
```
<jmx-management-enabled>true</jmx-management-enabled>
```
如果启用了 JMX，则可以使用 jconsole 在本地管理代理。
注意
出于安全考虑，不默认启用到 JMX 的远程连接。
如果要从同一 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 下。

其他资源

有关为远程管理配置代理的更多信息，请参阅 Oracle 的 Java 管理指南。

6.2.2. 配置 JMX 管理访问权限

默认情况下，出于安全原因，禁用远程 JMX 访问代理。但是，AMQ Broker 有一个 JMX 代理，它允许远程访问 JMX MBeans。您可以通过在代理 management.xml 配置文件中配置连接器元素来启用 JMX 访问。

注意

虽然也可以使用 com.sun.management.jmxremote ' JVM 系统属性启用 JMX 访问功能，但这种方法不受支持且不安全。修改 JVM 系统属性可以绕过代理上的 RBAC。为最大程度降低安全风险，请考虑对本地主机的有限访问权限。

重要

公开用于远程管理的代理的 JMX 代理具有安全隐患。

要保护您的配置，如此流程所述：

所有连接都使用 SSL。
明确定义连接器主机，即要在其上公开代理的主机和端口。
明确定义 RMI（远程方法调用） registry 绑定的端口。

先决条件

一个正常工作的代理实例
Java jconsole 工具

流程

打开 & lt;broker-instance-dir> /etc/management.xml 配置文件。
为 JMX 代理定义连接器。连接器端口设置建立一个 RMI 注册表，供客户端（如 jconsole 查询）用于 JMX 连接器服务器。例如，允许在端口 1099 上远程访问：
```
<connector connector-port="1099"/>
```

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

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

在连接器上定义其他属性，如下所述。
连接器主机
用于公开代理的代理服务器主机。要防止远程访问，将 连接器主机 设置为 127.0.0.1 (localhost)。
rmi-registry-port
JMX RMI 连接器服务器绑定到的端口。如果没有设置，则端口始终是随机的。设置此属性以避免通过防火墙传输的远程 JMX 连接出现问题。
jmx-realm
用于身份验证的 JMX 域。默认值为 activemq，以匹配 JAAS 配置。
object-name
要公开远程连接器的对象名称。默认值为 connector:name=rmi。
受保护
指定连接器是否使用 SSL 保护。默认值为 false。将值设为 true 以确保安全通信。
key-store-path
密钥存储的位置。如果您设置了 secured="true"，则需要此项。
key-store-password
密钥存储密码。如果您设置了 secured="true"，则需要此项。可以加密密码。
key-store-provider
密钥存储提供程序。如果您设置了 secured="true"，则需要此项。默认值为 JKS。
trust-store-path
信任存储的位置。如果您设置了 secured="true"，则需要此项。
trust-store-password
信任存储密码。如果您设置了 secured="true"，则需要此项。可以加密密码。
trust-store-provider
信任存储供应商。如果您设置了 secured="true"，则需要此项。默认值为 JKS
password-codec
要使用的密码 codec 的完全限定类名称。有关此工作原理的更多详细信息，请参阅下面的密码屏蔽文档。
使用 jdk.serialFilter，为端点序列化设置适当的值，如 Java Platform 文档中所述。

其他资源

有关配置文件中加密密码的更多信息，请参阅配置文件中的密码。

6.2.3. MBeanServer 配置

当代理以单机模式运行时，它使用 Java 虚拟机的平台 MBeanServer 注册其 MBeans。默认情况下，也部署了 Jolokia，以允许使用 REST 访问 MBean 服务器。

6.2.4. JMX 如何使用 Jolokia 进行公开

默认情况下，AMQ Broker 附带 Jolokia HTTP 代理作为 Web 应用程序部署。Jolokia 是一个通过 HTTP 网桥的远程 JMX，它公开 MBeans。

注意

要使用 Jolokia，用户必须从属于 < broker_instance_dir> /etc/artemis.profile 配置文件中的 hawtio. role 系统属性定义的角色。默认情况下，此角色是一个 mq。

例 6.1. 使用 Jolokia 查询代理的版本

本例使用 Jolokia REST URL 来查找代理的版本。Origin 标志应该为代理服务器指定域名或 DNS 主机名。另外，您为 Origin 指定的值必须与 Jolokia Cross -Origin Resource Sharing(CORS)规格中的 <allow-origin > 对应。

$ curl http://admin:admin@localhost:8161/console/jolokia/read/org.apache.activemq.artemis:broker=\"0.0.0.0\"/Version -H "Origin: mydomain.com"
{"request":{"mbean":"org.apache.activemq.artemis:broker=\"0.0.0.0\"","attribute":"Version","type":"read"},"value":"2.4.0.amq-710002-redhat-1","timestamp":1527105236,"status":200}

其他资源

有关使用 JMX-HTTP 网桥的更多信息，请参阅 Jolokia 文档。
有关为用户分配角色的更多信息，请参阅添加用户。
有关指定 Jolokia Cross-Origin Resource Sharing(CORS)的更多信息，请参阅安全 4.1.5 部分。

6.2.5. 订阅 JMX 管理通知

如果在您的环境中启用了 JMX，您可以订阅管理通知。

流程

订阅 ObjectName org.apache.activemq.artemis:broker=" <broker-name>".

其他资源

有关管理通知的详情，请参考第 6.5 节 “管理通知”。

6.3. 使用 JMS API 管理 AMQ Broker

通过 Java 消息服务(JMS)API，您可以创建、发送、接收和读取消息。您可以使用 JMS 和 AMQ JMS 客户端来管理代理。

6.3.1. 使用 JMS 消息和 AMQ JMS Client 配置代理管理

要使用 JMS 管理代理，您必须首先通过管理权限配置代理的管理地址。

流程

打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。
添加 & lt;management-address > 元素并指定管理地址。
默认情况下，管理地址为 activemq.management。如果您不想使用默认值，您只需指定不同的地址。
```
<management-address>my.management.address</management-address>
```
为管理地址提供 管理用户权限 类型。
这个权限类型可让管理地址接收和处理管理信息。
```
<security-setting-match="activemq.management">
    <permission-type="manage" roles="admin"/>
</security-setting>
```

6.3.2. 使用 JMS API 和 AMQ JMS Client 管理代理

若要使用 JMS 消息调用管理操作，AMQ JMS 客户端必须实例化特殊管理队列。

流程

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

例 6.2. 查看队列中的消息数

本例演示了如何使用 JMS API 查看 JMS 队列 exampleQueue 中的消息数量：

Queue managementQueue = ActiveMQJMSClient.createQueue("activemq.management");

QueueSession session = ...
QueueRequestor requestor = new QueueRequestor(session, managementQueue);
connection.start();
Message message = session.createMessage();
JMSManagementHelper.putAttribute(message, "queue.exampleQueue", "messageCount");
Message reply = requestor.request(message);
int count = (Integer)JMSManagementHelper.getResult(reply);
System.out.println("There are " + count + " messages in exampleQueue");

6.4. 管理操作

无论您是使用 JMX 或 JMS 消息来管理 AMQ Broker，您都可以使用相同的 API 管理操作。通过使用管理 API，您可以管理代理、地址和队列。

6.4.1. 代理管理操作

您可以使用管理 API 管理代理。

列出、创建、部署和销毁队列

可以使用 getQueueNames（） 方法来检索部署队列的列表。

可使用管理操作 createQueue（）、deployQueue（）或 destroyQueue（） 在 ActiveMQServerControl （通过 ObjectName org.apache. SLES.artemis:broker="BROKER_NAME" 或 resource name server）上创建或销毁队列。

如果队列已存在，则 createQueue 将失败，而 deployQueue 将不执行任何操作。

暂停和恢复队列

QueueControl 可以暂停和恢复底层队列。当队列暂停时，它将接收消息，但不会传送它们。恢复后，它将开始发送已排队的消息（若有）。

列出和关闭远程连接

使用 listRemoteAddresses（） 检索客户端的远程地址。也可以使用 closeConnectionsForAddress（） 方法关闭与远程地址关联的连接。

另外，也可使用 listConnectionIDs（） 列出连接 ID，并使用 listSessions（） 列出给定连接 ID 的所有会话。

管理事务

如果代理崩溃，在代理重启时，一些事务可能需要手动干预。使用以下方法帮助您解决问题。

使用 listPreparedTransactions（） 方法列表，列出处于准备状态（事务代表为 opaque Base64 Strings）的事务。

使用 commitPreparedTransaction（） 或 rollbackPreparedTransaction（） 提交或回滚给定事务，以解决 heuristic 事务。

使用 listHeuristicCommittedTransactions（） 和 listHeuristicRolledBackTransactions 方法列出 Heuristicly 完成交易。

启用和重置消息计数器

使用 enableMessageCounters（） 或 disableMessageCounters（） 方法启用和禁用消息计数器。

使用 resetAllMessageCounters（） 和 resetAllMessageCounterHistories（） 方法重置消息计数器。

检索代理配置和属性

ActiveMQServerControl 通过其所有属性公开代理的配置（例如，getVersion（） 方法以检索代理的版本等）。

列出、创建和销毁 Core Bridge 和parrts

列出部署的 Core Bridge，并分别使用 getBridgeNames（） 和 getDivertNames（） 方法。

使用网桥创建或销毁，并使用 createBridge（） 和 destroyBridge（） 或 createDivert（） 在 ActiveMQServerControl （通过 ObjectName org.apache.clusterNetwork.artemis:broker="BROKER_NAME" 或 resource name server）上的 createDivert（）和 destroyDivert（）。

停止代理并强制与任何当前附加的客户端进行故障切换

使用 ActiveMQServerControl 上的 forceFailover（） （使用 ObjectName org.apache.activemq.artemis:broker="BROKER_NAME" 或 resource name server）

注意

因为此方法实际停止代理，所以您可能会收到错误。确切的错误取决于您用于调用方法的管理服务。

6.4.2. 地址管理操作

您可以使用管理 API 管理地址。

使用 AddressControl 类及 ObjectName org.apache.activemq.artemis:broker=" <broker-name> ", component=addresses,address=" <address-name> " 或 resource name address. & lt;address-name>.

使用 addRole（） 或 removeRole（） 方法修改地址的角色和权限。您可以使用 getRoles（） 方法列出所有与队列关联的角色。

6.4.3. 队列管理操作

您可以使用管理 API 管理队列。

涉及队列的核心管理 API。QueueControl 类定义队列管理操作（使用 ObjectName,org.apache.activemq.artemis:broker=" <broker-name> ",component=addresses,address=" <bound-address> ",subcomponent=queues,routing-type=" <routing-type> ",queue=" <queue-name> " or resource name . <queue-name>））。

队列上的大多数管理操作都采用单一消息 ID（例如删除单个消息）或过滤器（例如，使用给定属性使所有消息过期）。

过期、发送到死信地址和移动消息

使用 expireMessages（） 方法使来自队列的消息过期。如果定义了到期地址，则会将消息发送到此地址，否则会被丢弃。您可以在 broker.xml 配置文件的 address-settings 元素中定义地址的到期地址（从而使队列绑定到这些地址）。例如，请参阅了解 default 代理配置中的 "默认消息地址设置"部分。

使用 sendMessagesToDeadLetterAddress（） 方法发送消息到死信地址。此方法返回发送到死信地址的消息数量。如果定义了死信地址，则会将消息发送到此地址，否则它们将从队列中删除并丢弃。您可以在 broker.xml 配置文件的 address-settings 元素中为地址 或一组 地址定义死信地址（因此绑定到这些地址的队列）。例如，请参阅了解 default 代理配置中的 "默认消息地址设置"部分。

使用 moveMessages（） 方法将消息从一个队列移到另一个队列。

列出和删除消息

使用 listMessages（） 方法列出来自队列的消息。它将返回一系列 映射，每个消息都有一个 映射。

使用 removeMessages（） 方法删除队列的消息，这将为单一消息 ID 变体或过滤器变体删除消息的数量返回 布尔值。这个方法采用 过滤器 参数来只删除过滤的消息。将过滤器设置为空字符串将影响所有消息。

计算信息

队列中的消息数量由 getMessageCount（） 方法返回。或者，countMessages（） 返回与给定过滤器匹配的队列中消息的数量。

更改消息优先级

可以使用 changeMessagesPriority（） 方法更改消息优先级，该方法为单一消息 ID 变体返回 布尔值，或者为过滤器变体返回更新消息的数量。

消息计数器

对于带有 listMessageCounter（） 和 listMessageCounterHistory（） 方法的队列，可以列出消息计数器（请参阅第 6.6 节 “使用消息计数器”。也可以使用 resetMessageCounter（） 方法为单个队列重置消息计数器。

检索队列属性

QueueControl 通过其属性公开队列设置（例如 getFilter（） ），以检索队列的过滤器（如果创建了队列，isDurable（） 则知道队列是否持久，等等）。

暂停和恢复队列

QueueControl 可以暂停和恢复底层队列。当队列暂停时，它将接收消息，但不会传送它们。恢复后，它将开始发送已排队的消息（若有）。

6.4.4. 远程资源管理操作

您可以使用管理 API 来启动和停止代理的远程资源（接受者、分离、网桥等），以便代理可以在不完全停止的情况下在给定时间段内离线。

acceptors: 使用 start（） 或.AcceptorControl 类（带有 ObjectName org.apache.activemq.artemis:broker=" <broker-name> ",component=acceptors,name=" <acceptor-name> " or the resource name acceptor. <address-name>）。acceptor 参数可以使用 AcceptorControl 属性检索。有关 Acceptors 的更多信息，请参阅网络连接： Acceptors 和 Connectors。
竞争: 在 DivertControl 类上使用 start（） 或 stop（） 方法（使用 ObjectName org.apache.activemq.artemis:broker=" <broker-name> ",component=diverts,name="<divert-name> " or the resource name is the）.可以使用 DivertControl 属性检索 Rart 参数。
网桥: 使用 start（） 启动或停止网桥（resp.BridgeControl 类上的 stop（）方法（使用 ObjectName org.apache.activemq.artemis:broker=" <broker-name> ",component=bridge,name=" <bridge-name> " 或 resource name bridge. <bridge-name>）。可以使用 BridgeControl 属性检索网桥参数。
广播组: 使用 BroadcastGroupControl 类上的 start（） 或 stop（） 方法（使用 ObjectName org.apache.clusterNetwork.artemis:broker=" <broker-name> ",component=broadcast-group,name=" <broadcast-group-name> " 或 resource name broadcastgroup. <broadcast-group-name >））。可使用 BroadcastGroupControl 属性检索广播组参数。如需更多信息，请参阅 Broker 发现方法。
发现组: 使用 DiscoveryGroupControl 类上的 start（） 或 stop（） 方法（使用 ObjectName org.apache.activemq.artemis:broker=" <broker-name> ",component=discovery-group,name=" <discovery-group-name> " 或 resourcename discovery. < discovery-group-name> ）来启动或停止一个发现 组。发现组参数可以使用 DiscoveryGroupControl 属性来检索。如需更多信息，请参阅 Broker 发现方法。
集群连接: 使用 ClusterConnectionControl 类上的 start（） 或 stop（） 方法（使用 ObjectName org.apache.clusterNetwork.artemis:broker=" <broker-name> ",component=cluster-connection,name=" <cluster-connection-name> " 或 resourcename clusterconnection. < cluster-connection-name> ）来启动或停止 cluster connection。可以使用 ClusterConnectionControl 属性检索集群连接参数。如需更多信息，请参阅创建代理集群。

6.5. 管理通知

以下是所有不同类型的通知列表，以及哪些标头位于消息中。每个通知都有一个 _AMQ_NotifType （在括号中记录的值）和 _AMQ_NotifTimestamp 标头。时间戳是调用 java.lang.System.currentTimeMillis（） 的未格式化结果。

通知类型	Headers
`BINDING_ADDED` (0)	`_AMQ_Binding_Type` `_AMQ_Address` `_AMQ_ClusterName` `_AMQ_RoutingName` `_AMQ_Binding_ID` `_AMQ_Distance` `_AMQ_FilterString`
`BINDING_REMOVED` (1)	`_AMQ_Address` `_AMQ_ClusterName` `_AMQ_RoutingName` `_AMQ_Binding_ID` `_AMQ_Distance` `_AMQ_FilterString`
`CONSUMER_CREATED` (2)	`_AMQ_Address` `_AMQ_ClusterName` `_AMQ_RoutingName` `_AMQ_Distance` `_AMQ_ConsumerCount` `_AMQ_User` `_AMQ_RemoteAddress` `_AMQ_SessionName` `_AMQ_FilterString`
`CONSUMER_CLOSED` (3)	`_AMQ_Address` `_AMQ_ClusterName` `_AMQ_RoutingName` `_AMQ_Distance` `_AMQ_ConsumerCount` `_AMQ_User` `_AMQ_RemoteAddress` `_AMQ_SessionName` `_AMQ_FilterString`
`SECURITY_AUTHENTICATION_VIOLATION` (6)	`_AMQ_User`
`SECURITY_PERMISSION_VIOLATION` (7)	`_AMQ_Address` `_AMQ_CheckType` `_AMQ_User`
`DISCOVERY_GROUP_STARTED` (8)	`name`
`DISCOVERY_GROUP_STOPPED` (9)	`name`
`BROADCAST_GROUP_STARTED` (10)	`name`
`BROADCAST_GROUP_STOPPED` (11)	`name`
`BRIDGE_STARTED` (12)	`name`
`BRIDGE_STOPPED` (13)	`name`
`CLUSTER_CONNECTION_STARTED` (14)	`name`
`CLUSTER_CONNECTION_STOPPED` (15)	`name`
`ACCEPTOR_STARTED` (16)	`factory` `id`
`ACCEPTOR_STOPPED` (17)	`factory` `id`
`PROPOSAL` (18)	`_JBM_ProposalGroupId` `_JBM_ProposalValue` `_AMQ_Binding_Type` `_AMQ_Address` `_AMQ_Distance`
`PROPOSAL_RESPONSE` (19)	`_JBM_ProposalGroupId` `_JBM_ProposalValue` `_JBM_ProposalAltValue` `_AMQ_Binding_Type` `_AMQ_Address` `_AMQ_Distance`
`CONSUMER_SLOW` (21)	`_AMQ_Address` `_AMQ_ConsumerCount` `_AMQ_RemoteAddress` `_AMQ_ConnectionName` `_AMQ_ConsumerName` `_AMQ_SessionName`

6.6. 使用消息计数器

您可以使用消息计数器来获取一段时间内队列的信息。这有助于识别其他难以看到的趋势。

例如，您可以使用消息计数器来确定如何随着时间的推移使用特定队列。您还可以使用管理 API 获取这些信息，以固定间隔查询队列中的消息数量，但不会显示队列实际使用方式。队列中的消息数量可能保持不变，因为没有客户端在它上发送或接收消息，或者因为发送到队列的消息数量等于从中消耗的消息数量。在这两个情形中，队列中的消息数量保持不变，尽管以非常不同的方式使用。

6.6.1. 消息计数器的类型

消息计数器提供有关代理上队列的额外信息。

数量: 从代理启动以来添加到队列中的消息总数。
countDelta: 从最近一次消息计数器更新以来添加到队列的消息数量。
lastAckTimestamp: 最后一次确认队列中消息的时间戳。
lastAddTimestamp: 最后一次向队列添加消息的时间戳。
messageCount: 队列中的当前消息数。
messageCountDelta: 从最后消息计数器更新以来添加/删除队列的消息总数。例如，如果 messageCountDelta 是 -10，则总体上删除了 10 个消息。
udpateTimestamp: 最后一次消息计数器更新的时间戳。

注意

您还可以组合消息计数器来确定其他有意义的数据。例如，要知道从上次更新以来队列使用多少消息，您可以从 countDelta 中减去 messageCountDelta。

6.6.2. 启用消息计数器

消息计数器对代理内存有小影响，因此默认禁用它们。要使用消息计数器，您必须首先启用它们。

流程

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

启用消息计数器。

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

设置消息计数器历史记录和抽样周期。
```
<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 毫秒。

6.6.3. 检索消息计数器

您可以使用管理 API 检索消息计数器。

先决条件

代理上必须启用消息计数器。
更多信息请参阅第 6.6.2 节 “启用消息计数器”。

流程

使用管理 API 检索消息计数器。

// Retrieve a connection to the broker's MBeanServer.
MBeanServerConnection mbsc = ...
JMSQueueControlMBean queueControl = (JMSQueueControl)MBeanServerInvocationHandler.newProxyInstance(mbsc,
   on,
   JMSQueueControl.class,
   false);

// Message counters are retrieved as a JSON string.
String counters = queueControl.listMessageCounter();

// Use the MessageCounterInfo helper class to manipulate message counters more easily.
MessageCounterInfo messageCounter = MessageCounterInfo.fromJSON(counters);
System.out.format("%s message(s) in the queue (since last sample: %s)\n",
messageCounter.getMessageCount(),
messageCounter.getMessageCountDelta());

其他资源

有关消息计数器的详情请参考第 6.4.3 节 “队列管理操作”。

第 7 章出现问题的监控代理

AMQ Broker 包括一个称为 Critical Analyzer 的内部工具，它可主动监控在死锁条件（如死锁）运行代理等问题。在生产环境中，死锁情况等问题可能是 IO 错误、磁盘缺陷、内存短缺或其他进程所导致的 CPU 用量。

Critical Analyzer 会定期测量关键操作的响应时间，如队列交付（即，将消息添加到代理上的队列）和日志操作。如果检查操作的响应时间超过可配置的超时值，则代理被视为不稳定。在这种情况下，您可以将 Critical Analyzer 配置为只记录一条消息，或采取措施来保护代理，如关闭代理或停止运行代理的虚拟机(VM)。

7.1. 配置 Critical Analyzer

以下流程演示了如何配置 Critical Analyzer 来监控代理问题。

流程

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

Critical Analyzer 的默认配置如下所示。

<critical-analyzer>true</critical-analyzer>
<critical-analyzer-timeout>120000</critical-analyzer-timeout>
<critical-analyzer-check-period>60000</critical-analyzer-check-period>
<critical-analyzer-policy>HALT</critical-analyzer-policy>

指定参数值，如下所述。

critical-analyzer: 指定是否启用或禁用 Critical Analyzer 工具。默认值为 true，这表示工具已经启用。
critical-analyzer-timeout: timeout（以毫秒为单位为单位）由 Critical Analyzer 运行检查。如果其中一个检查操作所花费的时间超过这个值，则代理被视为不稳定。
critical-analyzer-check-period: 每个操作都会连续一次检查关键分析周期（以毫秒为单位）。
critical-analyzer-policy: 如果代理的检查失败并被视为不稳定，这个参数指定代理是否记录消息(LOG)，停止托管代理的虚拟机(HALT)，或者关闭代理(SHUTDOWN)。

根据您配置的策略选项，如果关键操作的响应时间超过配置的超时值，您会看到类似如下的输出：

critical-analyzer-policy=LOG

[Artemis Critical Analyzer] 18:11:52,145 WARN [org.apache.activemq.artemis.core.server] AMQ224081: The component org.apache.activemq.artemis.tests.integration.critical.CriticalSimpleTest$2@5af97850 is not responsive

critical-analyzer-policy=HALT

[Artemis Critical Analyzer] 18:10:00,831 ERROR [org.apache.activemq.artemis.core.server] AMQ224079: The process for the virtual machine will be killed, as component org.apache.activemq.artemis.tests.integration.critical.CriticalSimpleTest$2@5af97850 is not responsive

critical-analyzer-policy=SHUTDOWN

[Artemis Critical Analyzer] 18:07:53,475 ERROR [org.apache.activemq.artemis.core.server] AMQ224080: The server process will now be stopped, as component org.apache.activemq.artemis.tests.integration.critical.CriticalSimpleTest$2@5af97850 is not responsive

您还会在类似以下内容的代理上看到线程转储：

[Artemis Critical Analyzer] 18:10:00,836 WARN  [org.apache.activemq.artemis.core.server] AMQ222199: Thread dump: AMQ119001: Generating thread dump
* =============================================================================== AMQ119002: Thread Thread[Thread-1 (ActiveMQ-scheduled-threads),5,main] name = Thread-1 (ActiveMQ-scheduled-threads) id = 19 group = java.lang.ThreadGroup[name=main,maxpri=10] sun.misc.Unsafe.park(Native Method) java.util.concurrent.locks.LockSupport.park(LockSupport.java:175) java.util.concurrent.locks.AbstractQueuedSynchronizer$ConditionObject.await(AbstractQueuedSynchronizer.java:2039) java.util.concurrent.ScheduledThreadPoolExecutor$DelayedWorkQueue.take(ScheduledThreadPoolExecutor.java:1088) java.util.concurrent.ScheduledThreadPoolExecutor$DelayedWorkQueue.take(ScheduledThreadPoolExecutor.java:809) java.util.concurrent.ThreadPoolExecutor.getTask(ThreadPoolExecutor.java:1067) java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1127) java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617) java.lang.Thread.run(Thread.java:745) =============================================================================== ..... .......... =============================================================================== AMQ119003: End Thread dump *

更新于 2024-06-11

法律通告

The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

管理 AMQ Broker

对于使用 AMQ Broker 7.10

使开源包含更多

第 1 章 概述

1.1. 支持的配置

1.2. 文档惯例

sudo 命令

关于在此文档中使用文件路径

可替换值

第 2 章 升级代理

2.1. 关于升级

2.2. 升级旧的 7.x 版本

2.2.1. 将代理实例从 7.0.x 升级到 7.0.y

2.2.1.1. 在 Linux 上从 7.0.x 升级到 7.0.y

2.2.1.2. 在 Windows 上从 7.0.x 升级到 7.0.y

2.2.2. 将代理实例从 7.0.x 升级到 7.1.0

2.2.2.1. 从 7.0.x 升级到 Linux 上的 7.1.0

2.2.2.2. 在 Windows 上从 7.0.x 升级到 7.1.0

2.2.3. 将代理实例从 7.1.x 升级到 7.2.0

2.2.3.1. 在 Linux 上从 7.1.x 升级到 7.2.0

2.2.3.2. 在 Windows 上从 7.1.x 升级到 7.2.0

2.2.4. 将代理实例从 7.2.x 升级到 7.3.0

2.2.4.1. 解决已弃用的分配控制台导致的异常

2.2.4.2. 从 7.2.x 升级到 Linux 上的 7.3.0

2.2.4.3. 在 Windows 上从 7.2.x 升级到 7.3.0

2.2.5. 将代理实例从 7.3.0 升级到 7.4.0

2.2.5.1. 从 7.3.0 升级到 Linux 上的 7.4.0

2.2.5.2. 在 Windows 上从 7.3.0 升级到 7.4.0

2.3. 将代理实例从 7.4.0 升级到 7.4.x

2.3.1. 从 7.4.0 升级到 Linux 上的 7.4.x

2.3.2. 在 Windows 上从 7.4.0 升级到 7.4.x

2.4. 将代理实例从 7.4.x 升级到 7.5.0

2.4.1. 在 Linux 上从 7.4.x 升级到 7.5.0

2.4.2. 在 Windows 上从 7.4.x 升级到 7.5.0

2.5. 将代理实例从 7.5.0 升级到 7.6.0

2.5.1. 从 7.5.0 升级到 Linux 上的 7.6.0

2.5.2. 在 Windows 上从 7.5.0 升级到 7.6.0

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

2.6.1. 从 7.6.0 升级到 Linux 上的 7.7.0

2.6.2. 从 7.6.0 升级到 Windows 上的 7.7.0

2.7. 将代理实例从 7.7.0 升级到 7.8.0

2.7.1. 从 7.7.0 升级到 Linux 上的 7.8.0

2.7.2. 从 7.7.0 升级到 Windows 上的 7.8.0

2.8. 将代理实例从 7.8.x 升级到 7.9.x

2.8.1. 从 7.8.x 升级到 Linux 上的 7.9.x

2.8.2. 在 Windows 上从 7.8.x 升级到 7.9.x

2.9. 将代理实例从 7.9.x 升级到 7.10.x

2.9.1. 在 Linux 上从 7.9.x 升级到 7.10.x

2.9.2. 在 Windows 上从 7.9.x 升级到 7.10.x

第 3 章 使用命令行界面

3.1. 启动代理实例

3.1.1. 启动代理实例

3.1.2. 将代理作为 Linux 服务启动

3.1.3. 将代理作为 Windows 服务启动

3.2. 停止代理实例

3.2.1. 停止 broker 实例

3.2.2. 正常停止代理实例

3.3. 通过截获数据包进行审核消息

3.3.1. 创建拦截器

3.3.2. 配置代理以使用拦截器

3.3.3. 客户端上的拦截器

3.4. 检查代理和队列的健康状况

3.5. 命令行工具

第 4 章 使用 AMQ 管理控制台

4.1. 概述

4.2. 配置本地和远程访问 AMQ 管理控制台

4.3. 访问 AMQ 管理控制台

4.4. 配置 AMQ 管理控制台

4.4.1. 使用红帽单点登录保护 AMQ 管理控制台

4.4.2. 设置用户对 AMQ 管理控制台的访问

4.4.3. 保护对 AMQ 管理控制台的网络访问

4.4.4. 配置 AMQ 管理控制台以使用基于证书的身份验证

4.5. 使用 AMQ 管理控制台管理代理

4.5.1. 查看代理详情

4.5.2. 查看代理图

4.5.3. 查看接收器

4.5.4. 管理地址和队列

4.5.4.1. 创建地址

4.5.4.2. 发送消息到地址

4.5.4.3. 创建队列

第 1 章概述

`sudo` 命令

第 2 章升级代理

第 3 章使用命令行界面

第 4 章使用 AMQ 管理控制台

第 5 章监控代理运行时指标

第 6 章使用管理 API

第 7 章出现问题的监控代理