注意事项与规划

由于涉及的变动环节较多（包括但不限于以下内容），预先了解升级或迁移所需的时间是不可能的：

因此，建议准备一个环境，以便您可以进行完整的升级或迁移过程测试。这将为您提供比预估更准确的时间，并让您对整个过程的预期耗时有大致了解。根据经验，升级或迁移过程中的数据迁移部分（非整个过程）对于 600GB 的存储而言，大约需要 50~55 分钟。

在 PATCH 和 MINOR（补丁和次要版本）升级中，您无需更改配置设置。如果您保持 neo4j.conf 文件不变，一切应该都能像旧版本一样工作。但是，由于某些版本可能包含新功能，因此查看 Configuration settings（配置设置） 和 Procedures（过程） 的更改并根据需要更新设置总是一个好习惯。

MAJOR（主要）版本会引入配置设置的变更，例如新的配置名称、已弃用或已移除的功能。建议检查 configuration settings（配置设置） 的更改，以了解所有必需的调整。

在此阶段，一个好的做法是检查您当前的 neo4j.conf 并记录下您可能拥有的任何非默认配置。您需要将这些配置添加到您的 Neo4j 4.x 的 neo4j.conf 文件中。

所有的日志格式/布局在 Neo4j 4.x 中都有所变化。有些是微小的，有些则影响重大，因此请花点时间熟悉新的格式及其包含的信息。如果您正在使用这些日志并基于它们生成警报，那么检查日志格式更改的影响非常必要。

有关可用日志及其配置方法（包括日志轮转和保留）的更多信息，请参阅您要升级到的版本的 Operations Manual → Logging（操作手册 → 日志记录）。

关于指标，有三点需要注意：

对于使用嵌入式部署（将 Neo4j 包含在您的项目中）的用户，从 4.2 版本开始，Neo4j 支持以嵌入模式运行因果集群 (Causal Cluster)。但是，从 Neo4j HA 嵌入模式迁移过来时，需要进行少量更改。有关详细信息，请参阅 Java Reference → Using Neo4j embedded in Java applications（Java 参考 → 在 Java 应用程序中使用嵌入式 Neo4j） 和 Operations Manual → Embedded usage（操作手册 → 嵌入式使用）。

迁移到较新的 Neo4j MAJOR 版本时，仅支持离线迁移。因此，这需要规划停机时间。请据此做好相应安排。由于每个案例都是独一无二的，建议进行一次或多次测试迁移，以准确了解该过程需要多长时间。这些信息将使您能够更好地规划所需的停机窗口。

迁移需要大量的空闲磁盘空间，因为它会创建整个数据库的副本并生成临时文件。同时建议对生产存储进行备份，以防出现问题。基于上述原因，迁移时建议预留两倍于数据库目录大小的空间（如果事先进行了备份，则为三倍）。

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

随着多数据库功能的引入，数据库命名规则已更改。例如，数据库名称中不再允许使用下划线。有关命名规则的完整列表，请参阅 Operations Manual → Administrative commands（操作手册 → 管理命令）。

根据您的应用程序与 Neo4j 的交互方式，您应准备好审查您的应用程序代码。Neo4j 4.x 中的更改可能会影响您的应用程序，例如（但不限于）：

所有可能影响您的应用程序与 Neo4j 的破坏性更改均可在 Breaking changes between Neo4j 3.5 and Neo4j 4.x（Neo4j 3.5 与 Neo4j 4.x 之间的破坏性更改） 中找到。

Neo4j 官方驱动程序有一些重大且具有破坏性的更改，您需要注意。Breaking changes between Neo4j 1.7 drivers and Neo4j 4.x drivers（Neo4j 1.7 驱动程序与 Neo4j 4.x 驱动程序之间的破坏性更改） 一节包含了所有相关信息并列出了所有的破坏性更改。

以下是一些可能导致困惑的关键更改：

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

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

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