将 EMQX 集群从版本 4.4 升级到 5.1
本页面提供了如何将您的 EMQX 集群升级到最新版本的说明。
由于 EMQX 5.1 在配置、管理 API 和集群 API 方面与 4.x 版本不兼容，不支持从早期版本进行滚动升级。为确保成功升级，请在开始升级过程之前仔细阅读开始前的注意事项。
如果在升级过程中遇到任何问题，请联系 EMQX 技术支持。
TIP
请注意，重新安装当前版本将不会保留您现有的集群配置。您可以参考安装指南进行全新安装。
适用读者
本指南适用于需要从早期版本的 EMQX 进行升级的用户，以及熟悉数据中心操作的有经验的 Linux 系统管理员。
开始前的注意事项
在开始升级之前，请了解本节中描述的要求、不兼容更改和潜在问题。
升级路径
要将现有的 EMQX 集群升级到 5.1 版本，您当前必须运行 4.4.x 版本。
如果您运行的是早于 4.4.x 版本的版本，您必须首先逐个升级到 4.4.x 版本。例如，如果您当前运行的是 4.3.x 版本，则必须先升级到 4.4 版本，然后再升级到 5.1 版本。请参考4.4 升级指南获取指导。
不兼容更改
在开始升级之前，您需要解决当前部署中的所有不兼容性或冲突。为了确定可能影响您的应用程序和部署的潜在兼容性问题和重大更改，请参考 从 EMQX 4.4 到 EMQX 5.1 的不兼容变更。
此外，建议在将升级部署到生产环境之前，在测试环境中充分测试您的应用程序。这将有助于确保平稳过渡并最小化潜在的中断。
客户端应用程序和数据桥接兼容性
使用不兼容的客户端和数据桥接版本运行升级部署可能会导致意外或未定义的行为。因此，务必确保您的客户端应用程序和数据桥接后端服务与 5.1 版本兼容。您可以参考客户端 SDK 来验证与 EMQX 5.1 的兼容性。
潜在问题
在升级过程中，要注意以下常见潜在问题：
- 升级后的 EMQX 版本与客户端应用程序之间的不兼容性。
- 可能需要进行的配置更改，以适应新版本。
- 对可能需要更新或重新配置的外部系统或服务的依赖。
为了避免这些问题，请仔细阅读 EMQX 5.1 文档，并在将升级应用于生产环境之前，在测试环境中进行全面测试。此外，考虑使用 EMQX 提供的支持服务，以确保平稳和成功的升级。
升级 EMQX 集群
前置准备
- 确保您正在运行 EMQX 集群版本 4.4.x。
- 您已阅读更新日志。
- 您的硬件和软件满足 EMQX 5.1 的最低要求。
- 您有足够的磁盘空间和可用内存进行升级。
- 您已查看了性能调优 (Linux) 中提到的任何特定前提条件。
下载 EMQX 5.1 软件包。
- 使用软件包管理器： 检查您的操作系统软件包管理器是否提供了 EMQX 5.1 二进制文件。如果可用，请使用软件包管理器下载和安装二进制文件。
- 手动下载二进制文件： 如果软件包管理器未提供 EMQX 5.1 二进制文件或服务器的网络受限，请从官方 EMQX 网站手动下载。
使用这些二进制文件部署一个新的 EMQX 集群。有关详细的安装步骤，请参考安装指南。这将确保最新版本的全新安装。
迁移 EMQX 集群。
- 使用 API 或 Dashboard 备份您的 EMQX 4.4 集群的配置和数据。
- 将配置文件格式从版本 4.4 转换为与 EMQX 5.1 兼容的新格式。
- 使用以下命令将迁移后的配置文件还原到 EMQX 5.1 集群：
emqx ctl data import <File>。
TIP
目前正在开发一个迁移工具，可将您的配置从现有的 EMQX 4.4 集群迁移到新的 EMQX 5.1 集群。该工具旨在自动化迁移过程，确保平稳过渡。
彻底验证新的 EMQX 集群，以确保其按预期运行。测试其连接性、消息传递功能以及其他相关功能，以确认升级成功。
:::
不支持降级到先前的版本，因此请确保在销毁旧集群之前完全验证新集群。
:::
将生产环境切换到升级后的集群。更新您的 DNS 记录、负载均衡器或任何其他相关配置，以将流量定向到新的集群。在切换后密切监控系统，确保运行平稳。