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

本示例展示了如何在 Linux、macOS 或 Windows 上通过 TAR/ZIP 分发包升级 Neo4j 独立服务器。

如果您是从 5.26 LTS 版本迁移到任何 2025-2026 版本，建议在继续之前阅读以下页面

对于关键系统，建议：

先决条件

以下示例假设 Neo4j 5.26 LTS 或 2025-2026 版本的 TAR/ZIP 包已解压至 <NEO4J_HOME>，且 Neo4j 二进制文件位于其默认位置。conf、data、certificates、licenses 和 plugins（如果您使用自定义插件）目录是使用 server.directories.* 配置设置和环境变量 NEO4J_CONF 进行配置的，具体参考《操作手册》中的 安装说明 (Installation instructions)。这意味着您可以替换 DBMS 二进制文件，而不会影响配置和状态。

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

升级步骤

  1. 通过运行以下命令停止旧的 Neo4j 服务器

    bin/neo4j stop

  2. 从 Neo4j 部署中心 (Neo4j Deployment Center) 下载最新版本的 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 服务器

    bin/neo4j start

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

监控日志

neo4j.log 文件包含了升级所涉及的步骤数量以及进度信息。建议监控此日志。

© . This site is unofficial and not affiliated with Neo4j, Inc.