故障排除
故障排除信息,可帮助您诊断和纠正问题。
您可以查阅操作手册 → Neo4j 日志文件,以监控升级过程并验证其进行过程中没有问题发生。如果出现问题,以下已知的故障排除信息可以帮助您诊断和纠正问题。
常见问题解决方案
调用 dbms.upgrade
导致失败
upgradeResult
字段描述了哪些组件未能升级。
- 解决方案
-
要排除根本原因,可以尝试两件事
-
调用命令的更详细版本——
dbms.upgradeDetails
,它将返回包含底层抛出的异常的消息。这可能不是根本原因,但可以帮助缩小范围。 -
在 security.log 和 debug.log 中查找描述性警告和错误。堆栈跟踪应有助于追溯问题的根本原因。
-
尝试在不兼容的版本之间升级,例如从 Neo4j 3.5 迁移到 Neo4j 4.1
当检测到的 system
数据库版本过旧时,状态码为以下之一
-
UNSUPPORTED_BUT_CAN_UPGRADE
- 服务器关闭。- 解决方案
-
配置
dbms.mode=SINGLE
。这会启用system
数据库模式的自动升级,因为当dbms.mode=SINGLE
时,设置dbms.allow_single_automatic_upgrade
默认为true
。
-
UNSUPPORTED
- 服务器关闭。- 解决方案
-
无法直接升级,请先升级到支持的中间版本。
当并非所有实例都已升级到新版本的 Neo4j 时调用 dbms.upgrade
-
在仍运行旧版本的任何实例上调用
dbms.upgradeStatus
将返回UNSUPPORTED_FUTURE
。 -
这些旧实例不再能够授权用户。
-
对这些实例的所有查询都会导致错误。
- 解决方案
-
关闭、升级并重启实例以恢复服务。