安装和配置 Neo4j 5

Neo4j 的配置方式有所变更。本节讨论如何像配置 Neo4j 4.4 DBMS 一样配置 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。

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

Neo4j Database 5.26 LTS 是最后一个将使用 Java SE 17 平台的版本。建议迁移到 Java SE 21，Neo4j Database 5.14 及更高版本均支持 Java SE 21。

使用 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 集群在版本 5 中发生了显著变化。虽然技术上可以自动迁移 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 部署中心获取。

© . All rights reserved.