注意事项和计划

由于涉及大量活动部件（例如但不限于），因此无法预先了解升级或迁移需要多长时间。

因此，建议准备一个可以进行背靠背测试升级或迁移过程的环境。这将为您提供比您估计更准确的时间，以及对流程持续时间方面预期内容的了解。根据经验法则，升级或迁移过程中的数据迁移部分（而非整个过程）对于 600GB 的存储大约需要 50~55 分钟。

在PATCH 和MINOR 升级中，您无需更改配置设置。如果您保持neo4j.conf 文件不变，则所有内容都应与旧版本一样工作。但是，某些版本可能包含新功能，因此始终建议查看对配置设置和过程的更改，并在需要时更新设置。

新的MAJOR 版本会引入对配置设置的更改，例如新的配置名称、已弃用和已删除的功能。建议检查对配置设置的更改，以了解所有必需的更改。

在此阶段，良好的做法是浏览您当前的neo4j.conf 并捕获您可能拥有的任何非默认配置。您需要将这些配置添加到 Neo4j 4.x 的neo4j.conf 文件中。

所有日志格式/布局在 Neo4j 4.x 中都发生了更改。有些是次要的，有些则更为重要，因此请花时间熟悉新的格式以及它们包含的信息。如果您正在使用这些日志并根据它们生成警报，则值得检查日志格式更改的影响。

有关可用日志以及如何配置日志（包括日志轮换和保留）的更多信息，请参阅您要升级到的版本的操作手册→日志记录。

在指标方面，有三个重要事项需要注意

对于使用嵌入式部署的用户（当您将 Neo4j 包含在您的项目中时），从 4.2 版本开始，Neo4j 支持在嵌入模式下运行因果集群。但是，从 Neo4j HA 嵌入迁移而来，需要进行少量更改。有关更多信息，请参阅Java 参考→在 Java 应用程序中使用 Neo4j 嵌入和操作手册→嵌入式用法。

迁移到较新的 Neo4j MAJOR 版本时，仅支持脱机迁移。因此，需要计划一些停机时间。相应地计划此操作。由于每个案例都是独一无二的，因此建议运行一个或多个测试迁移以了解流程需要多长时间才能背靠背完成。这些信息将使您能够更好地计划所需的停机时间窗口。

迁移需要大量的可用磁盘空间，因为它会创建数据库的完整副本并创建临时文件。还建议在出现问题时备份生产存储。由于上述原因，最好为迁移目的保留数据库目录的两倍大小（如果事先进行备份，则为三倍）。

Neo4j 4.x 运行在 Java 11 上。下表显示了运行 Neo4j 实例的兼容 Java 虚拟机 (JVM)。

随着多个数据库的引入，数据库的命名规则已发生变化。例如，现在无法在数据库名称中使用下划线。有关命名规则的完整列表，请参阅操作手册→管理命令。

根据您的应用程序如何与 Neo4j 交互，您应该准备好查看您的应用程序代码。Neo4j 4.x 有一些更改可能会影响您的应用程序，例如（但不限于）

所有可能影响您的应用程序和 Neo4j 的重大更改都可以在Neo4j 3.5 和 Neo4j 4.x 之间的重大更改中找到。

Neo4j 的官方驱动程序有一些重大的且破坏性的更改，您需要注意。在 Neo4j 1.7 驱动程序和 Neo4j 4.x 驱动程序之间的重大更改 部分包含所有信息并列出了所有重大更改。

以下是一些可能导致混淆的关键更改

请注意您正在使用的插件，并确保它们与 Neo4j 4.x 兼容。

以下是最常用的插件/插件类型

请注意您与 Neo4j 一起使用的任何其他第三方软件和工具。也许您已经利用操作脚本来安装、管理、备份或监控您的 Neo4j 部署。您可能还设置了警报并构建了完整的监控仪表板。您需要修改这些内容，因为指标已经发生了变化（如 指标 部分所述），并且 Neo4j 操作工具现在考虑了多个数据库。因此，建议您审查所有脚本/工具/第三方软件，并确保它们已准备好并与 Neo4j 4.x 兼容。