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

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

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

对于关键系统，建议

先决条件

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

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

升级步骤

  1. 停止 Neo4j 5.26 或 2025.x。

    /neo4j-enterprise-5.26/bin/neo4j stop

  2. 从Neo4j 部署中心下载最新版本 2025.y TAR 或 ZIP，并解压。

  3. 如果您安装了任何默认插件，请检查它们是否与新版本兼容，并通过将新版本的插件复制到 plugins 目录来根据需要进行更新。

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

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

  4. 启动 Neo4j 2025.y

    /neo4j-enterprise-2025.y/bin/neo4j start

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

监控日志

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

© . All rights reserved.