迁移检查清单

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

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

请遵循以下清单来准备您的 Neo4j 部署迁移

如果您要迁移因果集群 (Causal Cluster)，请对集群中的每个成员执行此检查清单。

先决条件

  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 文件。

  • 所有用于加密的文件，例如私钥、公钥证书，以及 trusted 和 revoked 目录的内容（位于 <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

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

准备一个新的 neo4j.conf 文件，供新安装程序使用

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

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

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

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

（仅限顺序路径）从 3.5 到 4.0 的用户和角色迁移是自动完成的。因此，您无需将 data/dbms/ 目录及内容移动到新安装中。在首次启动 Neo4j 4.0 DBMS 时，3.5 中的文件将被解析，内容会被添加到 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

有关详细信息，请参阅《操作手册》→ 日志记录。

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