升级独立服务器 (TAR/ZIP)
本示例展示了如何在 Linux、macOS 或 Windows 上通过 TAR/ZIP 分发包升级或修补 5.x 独立服务器。
|
建议在继续之前阅读以下页面: 对于关键系统,建议:
|
先决条件
以下示例假设 Neo4j 5.x TAR/ZIP 已解压至 <NEO4J_HOME>,且 Neo4j 二进制文件位于其默认位置。conf、data、certificates、licenses 和 plugins(如果您使用自定义插件)目录是按照《操作手册》中的安装说明,使用 server.directories.* 配置设置和环境变量 NEO4J_CONF 进行配置的。这意味着您可以替换 DBMS 二进制文件,而不会影响配置和状态。
升级步骤
-
停止 Neo4j 5.x。
/neo4j-enterprise-5.x/bin/neo4j stop -
从 Neo4j 部署中心下载最新版本的 5.y TAR 或 ZIP 包,并进行解压。
-
如果您安装了任何默认插件,请检查它们是否与新版本兼容;如果需要更新,请将新版本的插件复制到 plugins 目录中。
在企业版 (Enterprise Edition) 中,最新版本的 APOC 可在 labs 下获取,而 GDS、Bloom、GenAI 和 NOM 则可在 products 下获取。目前,不兼容的 GDS 或 APOC 版本会导致 Neo4j 无法启动。
如果您的旧安装使用的是默认目录(而非本示例在先决条件部分所假设的目录),那么您必须先使用
neo4j-admin server migrate-configuration命令将旧版本的配置文件迁移到新版本,复制证书和自定义插件文件,并在启动新版本之前使用neo4j-admin database load命令加载数据库转储。 -
启动 Neo4j 5.y
/neo4j-enterprise-5.Y/bin/neo4j start请记住,不同的操作系统有不同的启动 Neo4j 的方式。有关更多信息,请参阅:
监控日志
neo4j.log 文件包含了升级所涉及的步骤数量以及进度信息。建议监控此日志。