将单实例升级至 4.2
本节介绍如何升级单个 Neo4j 实例。
先决条件
-
确保您已经完成 升级检查清单 中的所有任务。
准备升级
-
安装您想要升级到的 Neo4j 版本。有关如何安装您所使用的发行版的更多信息,请参阅 操作手册 → 安装。
-
将 neo4j.conf 文件替换为您在章节 准备一个新的 neo4j.conf 文件以供新安装使用 中准备的文件。
-
设置
dbms.allow_upgrade=true以允许自动存储升级。 -
设置
dbms.mode=SINGLE。这会启用system数据库模式的自动升级,因为当dbms.mode=SINGLE时,设置dbms.allow_single_automatic_upgrade默认为true。 -
复制所有用于加密的文件,例如私钥、公有证书,以及受信任和已吊销目录的内容(位于 <NEO4J_HOME>/certificates/ 中)。
-
使用
neo4j-admin restore(在线)或neo4j-admin load(离线)根据您的备份方式,在新安装中恢复每个数据库和事务(包括system数据库)。如果您使用的是 Debian/RPM 发行版,可以跳过此步骤。如果您的旧安装修改了以
dbms.directories.*开头的配置或dbms.default_database设置,请验证新的neo4j.conf文件配置是否正确,以确保能够找到这些目录。 -
如果您使用自定义插件,请确保它们已更新并兼容新版本,并将它们放置在 /plugins 目录下。
升级您的实例
-
通过从
<NEO4J_HOME>运行以下命令来启动实例bin/neo4j start升级在启动过程中进行。
-
监控 neo4j.log 文件,以获取升级涉及的步骤数量和进度信息。
升级后任务
-
升级完成后,打开 neo4j.conf 文件并设置
dbms.allow_upgrade=false。如果因某些原因忘记启用system数据库模式的自动升级,请使用以下命令手动升级它-
CALL dbms.upgradeStatus()以确定是否需要升级。 -
CALL dbms.upgrade()在system数据库上执行,以升级系统模式。更多细节,请参阅 操作手册 4.2 → 过程。
-
-
通过从
<NEO4J_HOME>运行以下命令来重启实例bin/neo4j restart -
升级后立即进行完整备份是一种良好的做法。
-
检查所有度量的默认设置。任何您希望启用的特定度量必须在
metrics.filter中指定。更多信息,请参阅 操作手册 → 启用度量记录。