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

其它资源

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