迁移清单

本主题介绍了将 Neo4j 3.5 DBMS 迁移到 Neo4j 4.0 DBMS 的准备步骤。

在开始准备迁移之前，请务必阅读理解升级和迁移以及支持的升级和迁移路径中的信息。

按照清单准备迁移您的 Neo4j 部署

如果您正在迁移因果集群，请为每个集群成员完成清单。

先决条件

  1. 验证您已安装 Java 11。

  2. 审查新版本中已实现的新功能和改进，以及 3 和 4 MAJOR 版本之间的重大变更。

预留足够的磁盘空间

迁移需要大量的可用磁盘空间，因为它会完整复制数据库。因此，务必额外提供数据库目录大小的 50% 空间。在默认配置中，数据库目录 是 databases/neo4j，它位于 data 目录中。迁移后的数据库总体上可能需要稍大的数据文件。
您还必须为迁移前备份预留所需的磁盘空间。

关闭 Neo4j DBMS

因为迁移要求数据库处于离线状态，所以第一步是，如果 Neo4j DBMS 仍在运行，请将其干净地关闭

bin/neo4j stop

或

systemctl stop neo4j

务必验证数据库关闭过程已成功完成，并且数据库已干净地关闭。您可以检查 neo4j.log 以获取这些日志消息进行确认

日志示例
2022-02-25 13:44:45.826+0000 INFO  Neo4j Server shutdown initiated by request
2022-02-25 13:44:45.830+0000 INFO  Stopped.

备份您当前的部署

您需要备份

  • neo4j.conf 文件。

  • 所有用于加密的文件，例如私钥、公共证书，以及受信任和已撤销目录的内容（位于 <NEO4J_HOME>/certificates/ 中）。

  • <NEO4J_HOME>/data/dbms 的内容（如果有任何本地用户）。

  • Neo4j 数据存储。如果您正在运行 Debian/RPM 发行版，则可以跳过此步骤。

对于集群部署，您只需要从 一个 实例备份 /dbms 文件夹的内容和 Neo4j 数据存储，该实例将是您选定的实例。

（仅限直接路径）备份现有 3.5.x 存储是可选的。直接路径不会替换当前存储，而是同时复制并迁移它。因此，在发生灾难时，您将始终有一个可用的备份。

由于数据库现在处于离线状态，您可以使用 neo4j-admin dump 命令创建数据存储的离线备份（.dump 文件）

$NEO4J_HOME/bin/neo4j-admin dump --to=$BACKUP_DESTINATION

结果是您定义的 $BACKUP_DESTINATION 中名为 <db_name>.dump 的文件。这是您将用于迁移的备份。有关 neo4j-admin dump 命令的更多信息，请参阅操作手册 → 备份离线数据库。

准备一个用于新安装的 neo4j.conf 文件

Neo4j 迁移需要更改配置。因此，您必须准备一个用于新部署的 neo4j.conf 文件。如果您正在迁移因果集群，请为每个集群成员执行此操作。

  • 使用旧安装中的任何非默认设置更新新的 neo4j.conf 文件。

  • 记下设置 dbms.directories.* 和 dbms.active_database 的任何自定义值。

  • 在集群安装中，请注意集群特定的配置设置，这些设置对于不同的集群成员可能会有所不同。

（仅限顺序路径）用户和角色从 3.5 到 4.0 的迁移是自动完成的。因此，您无需将 data/dbms/ 目录及其内容移动到新安装中。3.5 中的文件将被解析，并在 Neo4j 4.0 DBMS 首次启动时将其内容添加到 system 数据库中。

执行测试迁移

根据本章的发现，为迁移分配一个暂存测试环境，并执行测试迁移。测试迁移将为您提供有关生产迁移所需时间的宝贵信息。按照您的 Neo4j 版本和部署类型执行步骤，请参阅（迁移单个实例（离线）或迁移因果集群（离线））。

监控日志

neo4j.log 文件包含有关迁移涉及的步骤数以及进展情况的信息。对于大型迁移，持续监控此日志是个好主意。

日志示例
2018-09-18 13:24:23.243+0000 INFO  Starting...
2018-09-18 13:24:24.262+0000 INFO  Initiating metrics...
2018-09-18 13:24:24.488+0000 INFO  Starting upgrade of database
2018-09-18 13:24:24.538+0000 INFO  Migrating Indexes (1/5):
2018-09-18 13:24:24.542+0000 INFO    10% completed
2018-09-18 13:24:24.543+0000 INFO    20% completed
2018-09-18 13:24:24.543+0000 INFO    30% completed
...
...
...
2018-09-18 13:24:24.574+0000 INFO  Migrating Counts store (5/5):
2018-09-18 13:24:24.574+0000 INFO    10% completed
2018-09-18 13:24:24.574+0000 INFO    20% completed
2018-09-18 13:24:24.575+0000 INFO    30% completed
...
...
...
2018-09-18 13:24:24.576+0000 INFO    100% completed
2018-09-18 13:24:24.584+0000 INFO  Successfully finished upgrade of database

有关更多信息，请参阅操作手册 → 日志记录。

© . All rights reserved.