安装并配置 Neo4j 5

Neo4j 的配置方式有所变更。本节将讨论如何以与 Neo4j 4.4 DBMS 相同的方式配置 Neo4j 5。

安装 Neo4j 5

关于初始安装，请参阅《Neo4j 5 操作手册》中关于安装 Neo4j 的方法。

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

另请注意：

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

  • Neo4j 5.x 运行于 Java 17 之上，自 Neo4j 5.14 起也支持 Java 21。如果使用 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 开始提供支持。

使用 Debian 或 RPM 包

如果您通过 Debian 或 RPM 包安装 Neo4j 5，Neo4j 二进制文件将进行“原地（in-place）”升级。这意味着您的 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 版本中发生了显著变化，引入了自治集群（Autonomous Clusters）。虽然在技术上可以自动迁移 Neo4j 集群成员的配置文件，但并非所有集群设置都能直接转换。考虑到变更的范围，建议您从零开始配置新集群。

迁移 4.4 配置文件的步骤

  1. 如果您想迁移现有配置并同时保留 Neo4j 4.4 和 5 的安装（例如使用 tarball 可执行文件安装），请将 Neo4j 4.4 配置文件复制到新的 Neo4j 5 配置目录。

    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。

插件（Plugins）

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

企业版（Enterprise Edition）包含 APOC Core、Bloom 和 Graph Data Science。这些插件的最新版本也可以在 Neo4j 部署中心获取。

© . This site is unofficial and not affiliated with Neo4j, Inc.