使用版本热升级功能,用户可以快速、安全地升级生产环境的 EMQ X Broker,并避免了因重启服务导致的系统可用性降低。
目前 EMQ X Broker 仅支持 Patch 版本(Patch 版本是版本号的第三位)的热升级。 即,目前支持 4.2.0 -> 4.2.1,4.2.0 -> 4.2.2,… 等的热升级,但 4.2.x 无法热升级到 4.3.0 或者 5.0。
- 查看当前已安装的 EMQ X Broker 的版本列表。
- 从 EMQ X 官网下载要升级的软件包。
访问 选择对应的版本和操作系统类型,然后选择 “zip” 包类型。
- 找到 EMQ X 的安装目录:
$ EMQX_ROOT_DIR=$(emqx root_dir)
$ echo ${EMQX_ROOT_DIR}
"/usr/lib/emqx"
- 将下载的 zip 包放到 EMQ X 安装目录下的
releases
目录下:
$ cp emqx-4.2.1.zip ${EMQX_ROOT_DIR}/releases/
- 升级到指定版本:
- 再次查看版本列表,之前的版本的状态将会变成
old
:
$ emqx versions
Installed versions:
* 4.2.0 old
上面的 emqx upgrade 4.2.1
命令其实执行了三个动作:
- 解压 zip 包 (
unpack
) - 安装 (
install
) - 持久化 (
permanent
)
Release 4.2.1 not found, attempting to unpack releases/emqx-4.2.1.tar.gz
Unpacked successfully: "4.2.1"
Installed Release: 4.2.1
这时版本已经成功升级到了 4.2.1,但如果重启 emqx,将会还原到旧版本 4.2.0。 现在如果查看版本列表,会发现 4.2.1 的状态为 “当前版本”(),而不是持久化版本:
在系统稳定运行一段时间后,若决定持久化新版本,可以再次执行 install
命令:
$ emqx install 4.2.1
Release 4.2.1 is already installed and current, making permanent.
Made release permanent: "4.2.1"
$ emqx downgrade 4.2.0
Release 4.2.0 is marked old, switching to it.
Made release permanent: "4.2.0"
在系统稳定运行一段时间后,若决定删除一个旧版本,可以执行版本卸载命令。 比如下面的例子将会卸载旧版本的 4.2.0: