升级到 5.x 或 5.26 LTS

本页面概述了为确保升级顺利按计划进行所需检查和完成的事项。

重要提示

建议在继续之前先阅读简介。

查看变更

请查阅发行说明，了解新版本中引入或更改的内容。

独立服务器 (Standalone)

升级独立服务器（非集群组成部分）的步骤如下：

停止旧的 Neo4j 服务器。
安装新版本的 Neo4j。
启动新的 Neo4j 服务器。
您可以监控日志以查看升级进展。neo4j.log 文件中包含了有关升级的信息。

在适用的情况下，建议使用包管理器来安装 Neo4j。这不仅简化了流程，还确保了配置和状态得以保留。

请点击链接查看有关升级 Neo4j 独立服务器的演练指南：

集群 (Clusters)

根据您所使用的集群类型，升级 Neo4j 集群有不同的策略。

基础集群

升级基础集群有两种策略：

新服务器滚动升级 —— 在现有服务器下线之前添加一台新服务器。这种方法使集群在整个升级过程中保持可用且具备容错能力。此方法适用于使用可替换云资源或容器资源的部署。
原地滚动升级 —— 逐台下线并升级服务器。在下一台服务器下线前，先将升级后的服务器重新连接到集群。这种方法使集群在整个升级过程中保持可用。然而，当每台服务器下线时，它会降低集群的容错能力。

如果在此过程中数据存储不同步，您可能需要重新引导 (re-seed) 集群。有关更多信息，请参阅《操作手册》→引导集群。

如果您希望从 [5.0-5.6] 范围内的版本升级到 [5.10-5.15] 范围内的版本，请先升级到 5.9 版本，然后再升级到目标版本。例如，要将集群从 5.4 升级到 5.13，必须先升级到 5.9 版本，然后再升级到 5.13 版本。升级到 5.16 版本不需要任何中间步骤。例如，5.4 集群可以直接升级到最新版本。

分析集群 (Analytics cluster)

要升级分析集群（即拥有一个用于 system 的主节点和一个或多个 system 从节点的集群，使用 server.cluster.system_database_mode 设置），必须在升级主节点之前先升级从节点。否则，主节点会自动更新 system 数据库，导致从节点不再兼容。与原地滚动升级类似，单个服务器的升级步骤与升级独立服务器的步骤相同。