将单个实例升级到 4.1

本节介绍如何升级单个 Neo4j 实例。

先决条件

  1. 确保您已完成 升级检查清单 上的所有任务。

准备升级

  1. 安装您要升级到的 Neo4j 版本。有关如何安装您正在使用的发行版的更多信息,请参阅 操作手册→安装

  2. neo4j.conf 文件替换为您在 准备一个新的 neo4j.conf 文件以供新安装使用 部分中准备的文件。

  3. 设置 dbms.allow_upgrade=true 以允许自动存储升级。

  4. 设置 dbms.mode=SINGLE。这将启用 system 数据库模式的自动升级,因为当 dbms.mode=SINGLE 时,默认情况下设置 dbms.allow_single_automatic_upgradetrue

  5. 复制用于加密的所有文件,例如私钥、公钥证书以及受信任和已吊销目录的内容(位于 <neo4j-home>/certificates/ 中)。

  6. 使用 neo4j-admin restore(联机)或 neo4j-admin load(脱机)在新的安装中还原每个数据库和事务,包括 system 数据库,具体取决于您的备份方法。如果您正在运行 Debian/RPM 发行版,则可以跳过此步骤。

    如果您的旧安装修改了以 dbms.directories.* 或设置 dbms.default_database 开头的配置,请验证新的 neo4j.conf 文件是否已正确配置以查找这些目录。

  7. 如果您使用自定义插件,请确保它们已更新且与新版本兼容,并将它们放在 /plugins 目录中。

升级您的实例

  1. <neo4j-home> 运行以下命令启动实例

    bin/neo4j start

    升级在启动期间进行。

  2. 监视 neo4j.log 文件以获取有关升级涉及多少步骤以及已完成多少步骤的信息。

升级后任务

  1. 升级完成后,打开 neo4j.conf 文件并设置 dbms.allow_upgrade=false。如果由于某种原因您忘记启用 system 数据库模式的自动升级,请使用以下命令手动升级它

    • CALL dbms.upgradeStatus() 以确定是否需要升级。

    • system 数据库上 CALL dbms.upgrade() 以执行系统模式的升级。有关更多详细信息,请参阅 操作手册 4.1→过程

  2. <neo4j-home> 运行以下命令重新启动实例

    bin/neo4j restart
  3. 建议在升级后立即进行完整备份。