升级独立服务器 (TAR/ZIP)

本示例展示了如何从 TAR/ZIP 分发包在 Linux、macOS 或 Windows 上升级或修补 5.x 独立服务器。

建议在继续之前阅读以下页面：

对于关键系统，建议：

备份您的服务器（包括数据库、配置和加密密钥），以避免在发生故障时丢失数据。有关详细信息，请参阅操作手册备份和恢复或Docker → 转储和加载 Neo4j 数据库（离线）。
在测试环境中执行升级。

先决条件

以下示例假设 Neo4j 5.x TAR/ZIP 已解压到 <NEO4J_HOME>，并且 Neo4j 二进制文件位于其默认位置。conf、data、certificates、licenses 和 plugins（如果您使用自定义插件）目录是根据操作手册中的安装说明，使用 server.directories.* 配置设置和环境变量 NEO4J_CONF 进行配置的。这意味着您可以在不影响配置和状态的情况下替换 DBMS 二进制文件。

安装新版本时，您必须小心不要覆盖您的 conf、data、certificates、licenses 和 plugins（如果您使用自定义插件）目录。如果您使用默认目录（在 <NEO4J_HOME> 下），请务必在升级前使用 neo4j-admin database dump 命令备份数据库，并将所有这些目录的内容存储在安全位置。有关更多信息，请参阅操作手册 → 备份离线数据库和操作手册 → 默认文件位置。

升级步骤

停止 Neo4j 5.x。
```
/neo4j-enterprise-5.x/bin/neo4j stop
```
从Neo4j 部署中心下载最新版本 5.y TAR 或 ZIP，并将其解压。

如果您安装了任何默认插件，请检查它们是否与新版本兼容，如有必要，将新版本的插件复制到 plugins 目录进行更新。

在企业版中，最新版 APOC 位于 labs 下，而 GDS、Bloom、GenAI 和 NOM 位于 products 下。目前，不兼容的 GDS 或 APOC 版本会阻止 Neo4j 启动。

如果您的旧安装使用默认目录（不是本示例在先决条件部分中假设的目录），那么，您必须在使用 neo4j-admin server migrate-configuration 命令将配置文件从旧版本迁移到新版本，将证书和自定义插件文件复制到新安装位置，并使用 neo4j-admin database load 命令加载数据库转储，然后才能启动新版本。

启动 Neo4j 5.y

/neo4j-enterprise-5.Y/bin/neo4j start

请记住，不同的操作系统有不同的启动 Neo4j 的方式。有关更多信息，请参阅：

监控日志

neo4j.log 文件包含有关升级将涉及多少步骤以及已进行到何种程度的信息。建议监控此日志。