# 版本热升级

自 4.2.0 版本之后,EMQ X Broker 支持版本热升级。

使用版本热升级功能,用户可以快速、安全地升级生产环境的 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 for Windows 暂不支持热升级功能。

# 热升级步骤

  1. 查看当前已安装的 EMQ X Broker 的版本列表。

$ emqx versions

Installed versions:
* 4.2.0	permanent
  1. 从 EMQ X 官网下载要升级的软件包。

访问 https://www.emqx.io/downloads#broker (opens new window) 选择对应的版本和操作系统类型,然后选择 "zip" 包类型。

  1. 找到 EMQ X 的安装目录:

$ EMQX_ROOT_DIR=$(emqx root_dir)

$ echo ${EMQX_ROOT_DIR}
"/usr/lib/emqx"

  1. 将下载的 zip 包放到 EMQ X 安装目录下的 releases 目录下:

$ cp emqx-4.2.1.zip ${EMQX_ROOT_DIR}/releases/

  1. 升级到指定版本:

$ emqx upgrade 4.2.1

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
Made release permanent: "4.2.1"
  1. 再次查看版本列表,之前的版本的状态将会变成 old:

$ emqx versions

Installed versions:
* 4.2.1	permanent
* 4.2.0	old

# 升级后手动持久化

上面的 emqx upgrade 4.2.1 命令其实执行了三个动作:

  • 解压 zip 包 (unpack)
  • 安装 (install)
  • 持久化 (permanent)

持久化之后,这次版本升级将会被固定下来,这意味着热升级后,如果 emqx 发生重启,使用的将是升级之后的新版本。 如果不想在升级的同时持久化,可以使用 --no-permanent 参数:


$ emqx upgrade --no-permanent 4.2.1

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 的状态为 "当前版本"(current),而不是持久化版本:


$ emqx versions

Installed versions:
* 4.2.1	current
* 4.2.0	permanent

在系统稳定运行一段时间后,若决定持久化新版本,可以再次执行 install 命令:


$ emqx install 4.2.1

Release 4.2.1 is already installed and current, making permanent.
Made release permanent: "4.2.1"

# 版本降级

如果升级后发现问题想要回退,可以执行版本降级命令。 比如下面的例子会将 emqx 回退到 4.2.0 版本:


$ emqx downgrade 4.2.0

Release 4.2.0 is marked old, switching to it.
Installed Release: 4.2.0
Made release permanent: "4.2.0"

# 删除版本

在系统稳定运行一段时间后,若决定删除一个旧版本,可以执行版本卸载命令。 比如下面的例子将会卸载旧版本的 4.2.0:


$ emqx uninstall 4.2.0

Release 4.2.0 is marked old, uninstalling it.
Uninstalled Release: 4.2.0