将单实例升级至 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() 以确定是否需要升级。

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

  2. 通过从 <NEO4J_HOME> 运行以下命令来重启实例

    bin/neo4j restart
  3. 升级后立即进行完整备份是一种良好的做法。

  4. 检查所有度量的默认设置。任何您希望启用的特定度量必须在 metrics.filter 中指定。更多信息,请参阅 操作手册 → 启用度量记录

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