安装和配置 Neo4j 5

Neo4j 的配置方式发生了变化。本节讨论如何以与 Neo4j 4.4 数据库管理系统相同的方式配置 Neo4j 5。

安装 Neo4j 5

对于初始安装，请参阅 Neo4j 5 操作手册，了解有关安装 Neo4j的方法。

如果您有一个或多个使用早期版本的 Neo4j 创建的现有数据库，则必须在安装 5 **之前**备份这些数据库。有关更多信息，请参阅备份数据库。如果您通过 Debian 或 RPM 包安装 Neo4j，则这一点**尤其**重要。

另请注意

  • 如果您要迁移名称相同的数据库，则必须删除默认数据库。

  • Neo4j 5.x 运行在 Java 17 上，从 Neo4j 5.14 开始，它也支持 Java 21。如果使用 Oracle Java 17，则需要进行一些小的设置才能与 Oracle Java 17 兼容，因为 Oracle 和 OpenJDK 为 Java 17 提供了不兼容的 RPM 包。有关更多信息，请参阅操作手册 → Oracle Java 17。

    如果您的机器上还有其他 Java 应用程序正在运行 Neo4j，请确保这些应用程序与您的 Neo4j 正在运行的 Java 版本兼容。或者，您应该将其配置为在同一台机器上运行多个 JDK。

使用 Debian 或 RPM 包

如果您通过 Debian 或 RPM 包安装 Neo4j 5，则 Neo4j 二进制文件将“就地”升级。这意味着您的 5 安装将覆盖您的 4.4 安装。
在升级过程中，包管理器将警告您在继续之前进行备份。此外，升级会创建一个文件夹 ${NEO4J_HOME}/data-unmigrated-from-4.4，其中包含所有 4.4 数据库和元数据（以原始格式，而不是备份或转储）。

如果您已经对要迁移到 Neo4j 5 的每个数据库进行了有效的转储或备份，则应删除此生成的文件夹及其内容，以确保您有足够的磁盘空间用于在升级过程中稍后生成的已还原和迁移的副本（请参阅迁移数据库）。

由于 Neo4j 和 Cypher® Shell 之间存在严格的依赖关系，因此必须同时升级这两个包。

要同时升级这两个包，您必须在脱机机器上提供 Cypher Shell RPM 和 Neo4j RPM 文件。

  1. 从部署中心下载 Neo4j 和 Cypher Shell RPM 安装程序，或运行以下命令以获取所需的包。您必须将 neo4j-version-exact 替换为您要升级到的 Neo4j 的确切版本。

    • Cypher Shell

      curl -O https://dist.neo4j.org/cypher-shell/cypher-shell-neo4j-version-exact-1.noarch.rpm

    • Neo4j 社区版

      curl -O https://dist.neo4j.org/rpm/neo4j-neo4j-version-exact-1.noarch.rpm

    • Neo4j 企业版

      curl -O https://dist.neo4j.org/rpm/neo4j-enterprise-neo4j-version-exact-1.noarch.rpm

  2. 手动将下载的 RPM 包移动到脱机机器。

  3. 在脱机机器上以 root 身份运行以下命令，以同时安装 Neo4j Cypher Shell 和 Neo4j

    rpm -U <Cypher Shell RPM file name> <Neo4j RPM file name>

    这必须是一个命令，并且 Neo4j Cypher Shell 必须是命令中的第一个包。Debian 包也适用相同规则。

如果您**没有**此类转储或备份，则必须执行以下步骤

  1. 恢复您以前的 Neo4j 4.4 安装：操作手册 → Linux 安装。

  2. 重命名之前生成的未迁移数据文件夹

    mv ${NEO4J_HOME}/data-unmigrated-from-4.4 ${NEO4j_HOME}/data

  3. 启动此早期版本的 Neo4j

    $NEO4J_HOME/bin/neo4j start

  4. 使用备份数据库中提供的说明备份要迁移到 Neo4j 5 的所有数据库。

  5. 停止 Neo4j 并重新尝试升级到 Neo4j 5。

迁移配置

Neo4j 5 更改了许多配置设置。有关更改的完整列表，请参阅Neo4j 5 中配置设置的更改。

Neo4j Admin 有一个实用程序可以将大多数 4.4 设置转换为 5 的等效设置。有关更多信息，请参阅操作手册 → 迁移 Neo4j 配置文件。集群的更改建议从头开始配置。

如准备迁移中所述，Neo4j 集群在 v5 中发生了**重大**变化，引入了自主集群。虽然从技术上讲，可以自动迁移 Neo4j 集群成员的配置文件，但并非所有集群设置都可以直接转换。鉴于更改的范围，建议您从头开始配置新的集群。

迁移 4.4 配置文件的步骤

  1. 如果您要迁移现有配置，并且拥有并发的 Neo4j 4.4 和 5 安装（例如，如果使用 tarball 可执行文件安装），则将 Neo4j 4.4 配置文件复制到新的 Neo4j 5 配置目录。

    Neo4j 搜索配置文件的默认位置取决于 Neo4j 的安装方式

  2. 使用 Neo4j 5 中的neo4j-admin server migrate-configuration命令将配置文件迁移到 5.x 兼容的格式

    $NEO4J_5_HOME/bin/neo4j-admin server migrate-configuration

  3. 检查写入控制台的报告中与无法转换的设置相关的消息。

性能指标

  • 所有指标名称现在都包含 dbms 或 database 命名空间，并且已删除设置 metrics.namespaces.enabled。

    完整的指标列表可在操作手册 → 指标参考中找到。

  • 所有启用和禁用指标类型（metrics.*.enabled）的设置已被移除。它们被server.metrics.filter替换，该设置接受要启用的指标的正则表达式。

证书

将所有用于加密的文件（如私钥、公钥证书以及受信任和吊销目录的内容）复制到 Neo4j 5 中。

插件

如果您使用自定义插件，请确保它们与 Neo4j 5 和 Java 17 兼容，并将它们放置在/plugins目录中。

企业版包含 APOC Core、Bloom 和 Graph Data Science。这些插件的最新版本也可在Neo4j 部署中心找到。