将单个实例升级到 4.2

本节介绍如何升级单个 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_upgrade 默认情况下为 true。

  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.2 → 过程。

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

    bin/neo4j restart

  3. 升级后立即进行完整备份是一个好习惯。

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