文档目录

问题说明

本文用于排查“ZSphere 单管理未配置 NTP 导致数据库启动失败”类问题。

现象

  • 管理界面无法登录,zstack-ctl status 显示 MN 停止。
  • 重启服务时报 Can't connect to MySQL server。
  • 排查发现系统时间异常或未配置 NTP。

适用环境

  • 产品:ZVF
  • 版本:4.10.17.8
  • 组件:ZSphere
  • 涉及对象:管理节点
  • 场景:管理面与升级类问题,需结合当前版本、部署形态、存储类型和操作时间线确认。

可能原因

  • 单管理节点时间漂移导致数据库服务或证书/认证流程异常。
  • NTP/chrony 未配置或无法访问时间源。
  • 系统时间跳变影响数据库启动和管理服务连接。

排查步骤

按顺序执行以下检查,并记录受影响对象、发生时间、完整报错和当前状态。

  1. 检查 date、timedatectl、chronyc tracking 或 ntpq 状态。
  2. 确认管理节点能访问可靠 NTP 源,修正时间后重启数据库和管理服务。
  3. 检查 management-server.log 和数据库日志中的时间相关异常。
  4. 后续将 NTP 配置纳入实施检查,避免单管理环境时间漂移。

处理方法

  1. 配置管理节点使用可靠 NTP 时间源并完成时间同步。
  2. 时间校准后,按依赖顺序重启数据库和管理服务。

验证方法

  • timedatectl、chronyc tracking 或 ntpq 显示时间同步正常。
  • 数据库和管理服务可正常启动,日志中不再出现时间相关异常。
ZSphere 单管理未配置 NTP 导致数据库启动失败 | 故障排查 · KB | ZStack 资源中心