将单个实例升级到 4.3

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

先决条件

确保您已完成 升级清单 中的所有任务。

准备升级

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

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

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

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

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

  6. 在新的安装中还原每个数据库和事务，包括 system 数据库，方法是使用 neo4j-admin restore（联机）或 neo4j-admin load（脱机），具体取决于您的备份方法。如果您正在运行 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.3 → 过程。

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

    bin/neo4j restart

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

  4. 检查所有指标的默认设置。您希望启用的任何特定指标**必须**在 metrics.filter 中指定。有关更多信息，请参阅 运维手册 → 启用指标日志记录。