管理 AMQ Broker

流程

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

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

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

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

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

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

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

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

   <broker_instance_dir>/bin/artemis stop

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

   cp -r <broker_instance_dir> ~/

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

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

9. 启动升级的代理。

   <broker_instance_dir>/bin/artemis run

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

   ARTEMIS_HOME=<install_dir>

8. 启动升级的代理。

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
   ...
   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

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

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

   <broker_instance_dir>/bin/artemis stop

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

   cp -r <broker_instance_dir> ~/

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

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

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

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

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

9. 启动升级的代理。

   <broker_instance_dir>/bin/artemis run

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.7.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

   ARTEMIS_HOME=<install_dir>

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

   JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00001.jar

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

   <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00001.jar</startargument>

10. 启动升级的代理。

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

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

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

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

   <broker_instance_dir>/bin/artemis stop

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

   cp -r <broker_instance_dir> ~/

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00054 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

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

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

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

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

9. 启动升级的代理。

   <broker_instance_dir>/bin/artemis run

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.9.0.redhat-00054 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

   ARTEMIS_HOME=<install_dir>

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

   JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar

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

   <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>

10. 启动升级的代理。

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

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

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

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

   <broker_instance_dir>/bin/artemis stop

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

   cp -r <broker_instance_dir> ~/

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.11.0.redhat-00001 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

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

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

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

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

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

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

      loggers=org.eclipse.jetty,org.jboss.logging,org.apache.activemq.artemis.core.server,org.apache.activemq.artemis.utils,org.apache.activemq.artemis.journal,org.apache.activemq.artemis.jms.server,org.apache.activemq.artemis.integration.bootstrap,org.apache.activemq.audit.base,org.apache.activemq.audit.message,org.apache.activemq.audit.resource

   2. 在 Console handler configuration 部分前，为资源日志记录器添加默认配置。

      ..
      
      logger.org.apache.activemq.audit.resource.level=ERROR
      logger.org.apache.activemq.audit.resource.handlers=AUDIT_FILE
      logger.org.apache.activemq.audit.resource.useParentHandlers=false
      
      # Console handler configuration
      ..

10. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mesq.audit.resource.handlers=AUDIT_FILE
    logger.org.apache.activemq.audit.resource.useParentHandlers=false
    sage Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.11.0.redhat-00001 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

   ARTEMIS_HOME=<install_dir>

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

   JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar

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

   <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>

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

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

       loggers=org.eclipse.jetty,org.jboss.logging,org.apache.activemq.artemis.core.server,org.apache.activemq.artemis.utils,org.apache.activemq.artemis.journal,org.apache.activemq.artemis.jms.server,org.apache.activemq.artemis.integration.bootstrap,org.apache.activemq.audit.base,org.apache.activemq.audit.message,org.apache.activemq.audit.resource

    2. 在 Console handler configuration 部分前，为资源日志记录器添加默认配置。

       ..
       
       logger.org.apache.activemq.audit.resource.level=ERROR
       logger.org.apache.activemq.audit.resource.handlers=AUDIT_FILE
       logger.org.apache.activemq.audit.resource.useParentHandlers=false
       
       # Console handler configuration
       ..

11. 启动升级的代理。

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

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

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

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

   <broker_instance_dir>/bin/artemis stop

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

   cp -r <broker_instance_dir> ~/

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

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

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

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

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

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

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

10. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mesq.audit.resource.handlers=AUDIT_FILE
    logger.org.apache.activemq.audit.resource.useParentHandlers=false
    sage Broker version 2.16.0.redhat-00007 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

   ARTEMIS_HOME=<install_dir>

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

   JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar

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

   <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>

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

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

11. 启动升级的代理。

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

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.16.0.redhat-00007 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

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

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

   <broker_instance_dir>/bin/artemis stop

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

   cp -r <broker_instance_dir> ~/

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

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

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-bin'

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

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

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

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

10. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

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

    INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mes
    INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    sage Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

   ARTEMIS_HOME=<install_dir>

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

   JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar

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

   <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>

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

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

11. 启动升级的代理。

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

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

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

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

   <broker_instance_dir>/bin/artemis stop

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

   cp -r <broker_instance_dir> ~/

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

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

      ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-bin'

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

   在 web 元素中，更新 AMQ 管理控制台中 7.10.x 中 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">

10. 编辑 & 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">

11. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

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

    INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mes
    INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    sage Broker version 2.21.0.redhat-00025 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

   ARTEMIS_HOME=<install_dir>

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

   JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar

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

   <startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>

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

    在 web 元素中，更新 AMQ 管理控制台中 7.10.x 中 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">

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

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

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

12. 启动升级的代理。

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

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

    INFO  [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live
    ...
    INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.21.0.redhat-00025 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

流程

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

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

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

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

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

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

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

   注意

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

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

   <broker_instance_dir>/bin/artemis stop

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

   cp -r <broker_instance_dir> ~/

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

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

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

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

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

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

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

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

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

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

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

11. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

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

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

流程

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

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

   注意

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

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

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

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

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

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

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

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

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

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

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

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

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

10. 启动升级的代理。

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

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

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

流程

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

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

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

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

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

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

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

   注意

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

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

   <broker_instance_dir>/bin/artemis stop

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.28.0.redhat-00019 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]

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

   cp -r <broker_instance_dir> ~/

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

   cd /opt/redhat/apache-artemis-2.33.0.redhat-00013/bin

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

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

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

   • 备份了您要升级的代理实例目录中的 old-config-bkp.<n > 子目录。
   • 将 < broker_instance_dir> /etc/artemis.profile 文件中的 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。

10. 启动升级的代理。

    <broker_instance_dir>/bin/artemis run

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

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

流程

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

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

   注意

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

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

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

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

   INFO  [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.28.0.redhat-00019[4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes

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

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

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

   cd \redhat\amq-broker\apache-artemis-2.33.0.redhat-00013\bin

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

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

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

   • 备份了您要升级的代理实例目录中的 old-config-bkp.<n > 子目录。
   • 将 < broker_instance_dir> \etc\artemis.cmd.profile 文件中的 ARTEMIS_HOME 属性设置为提取存档时创建的新目录。

9. 启动升级的代理。

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

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

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

流程

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

   $ su - amq-broker

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

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

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

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

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

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

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

流程

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

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

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

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

3. 打开终端。

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

   sudo systemctl enable amq-broker

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

   sudo systemctl start amq-broker

流程

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

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

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

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

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

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

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

流程

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

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

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

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

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

流程

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

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

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

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

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

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

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

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

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

流程

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

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

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

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

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

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

流程

1. 配置 Red Hat Single Sign-On：

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

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

      • 对 AMQ 管理控制台 URL 的有效 Redirect URI 后跟 *，例如：

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

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

2. 配置 AMQ Broker 实例：

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

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

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

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

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

      <realm-name>

      Red Hat Single Sign-On 中的域名称

      <client-name>

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

      <RHSSO-URL>

      Red Hat Single Sign-On 的 URL

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

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

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

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

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

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

流程

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

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

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

   bind

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

   keyStorePath

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

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

   keyStorePassword

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

   clientAuth

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

   trustStorePath

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

   trustStorePassword

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

流程

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

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

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

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

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

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

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

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

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

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

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

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

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

      注意

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

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

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

   binding uri

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

   keystorePath

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

   keystorePassword

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

   ClientAuth

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

   trustStorePath

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

   trustStorePassword

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

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

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

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

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

   2. 输出导出的证书的内容：

      keytool -printcert -file <file_name>

      输出结果类似如下：

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

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

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

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

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

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

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

      实施类。

      org.apache.activemq.jaas.textfiledn.user

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

      org.apache.activemq.jaas.textfiledn.role

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

      注意

      如果您在 < broker_instance_dir>/etc/login.config 文件中更改了证书登录模块配置的默认名称，您必须更新 < broker_instance_dir>/etc/artemis.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 代理用户映射到客户端证书，其 Subject Distinguished Name 为 CN=user1,O=Progress,C=US Subject DN。在客户端证书和代理用户之间创建映射后，代理可以使用证书验证用户。

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

      amq=user1, user2

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

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

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

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

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

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

流程

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

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

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

3. 保存 bootstrap.xml 文件。

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

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

流程

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

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

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

   图 4.3. 代理图 标签页

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

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

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

   

流程

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

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

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

   图 4.5. AMQP acceptor 属性

   
4. 要查看属性的完整详情，请点属性。系统将打开一个新窗口，以显示详细信息。

流程

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

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

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

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

   注意

   出于安全原因，默认不启用远程连接到 JMX。

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

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

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

   注意

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

流程

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

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

   <connector connector-port="1099"/>

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

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

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

   connector-host

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

   rmi-registry-port

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

   jmx-realm

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

   object-name

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

   secured

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

   key-store-path

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

   key-store-password

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

   key-store-provider

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

   trust-store-path

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

   trust-store-password

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

   trust-store-provider

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

   password-codec

   要使用的密码 codec 的完全限定类名称。如需了解如何工作的更多详细信息，请参见以下链接密码屏蔽文档。

   注意

   RMI registry 选择要绑定到的 IP 地址。如果系统上有多个 IP 地址/NIC，您可以通过将以下内容添加到 artemis.profile 文件中来选择要使用的 IP 地址： -Djava.rmi.server.hostname=localhost

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

流程

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

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

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

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

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

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

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

流程

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