迁移清单

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

按照清单准备迁移 Neo4j 部署

完成迁移的所有先决条件。
预留足够的磁盘空间用于迁移前的备份和迁移。
关闭要迁移的 Neo4j DBMS。
备份当前部署以避免在发生故障时丢失数据。
下载Neo4j 的新版本。确保迁移路径受支持。
准备一个新的neo4j.conf文件，供新安装使用。
根据您的 Neo4j 版本和部署类型执行测试迁移(迁移单个实例（脱机）或迁移因果集群（脱机）)。
监控日志。
执行迁移。

如果您要迁移因果集群，请完成每个集群成员的清单。

先决条件

验证您是否已安装 Java 11。
查看新版本中已执行的新功能和改进，以及 3 和 4 个主要版本之间的重大更改。

预留足够的磁盘空间

迁移需要大量的可用磁盘空间，因为它会创建数据库的完整副本。因此，必须提供额外 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

结果是一个名为<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/目录及其内容移动到新安装中。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

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