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 管理控制台。

在升级 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 所需的配置文件。在以下示例中，请注意实例是在目录 upgrade_tmp 中创建的：
```
$ <7.1.0_install_dir>/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
```

将临时 7.1.0 实例的 etc 目录中的配置文件复制到 7.0.x 代理的 <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/

其它资源

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