文档目录

问题说明

本文用于排查“ZSphere change_ip 后管理服务启动异常且数据库用户登录失败”类问题。

现象

  • 执行 change_ip 修改管理节点 IP 后管理服务启动失败。
  • 错误指向 zstack 用户登录数据库失败,手工更新密码后仍无法登录。

适用环境

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

可能原因

  • 管理节点 IP 变更后数据库连接地址、授权主机或配置未同步。
  • 数据库用户授权、密码或配置文件中的连接信息不一致。
  • change_ip 过程中部分服务或配置更新失败。

排查步骤

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

  1. 确认 change_ip 前后管理 IP、VIP、数据库地址和主机名变化。
  2. 检查管理服务配置中的数据库连接地址和 zstack 用户授权范围。
  3. 查看 change_ip 执行日志和 management-server.log 中数据库连接错误。
  4. 修复数据库连接信息前先备份数据库和配置文件,避免反复手工改密码扩大影响。

处理方法

  1. 依据变更前备份,核对并恢复管理服务配置中的管理 IP、VIP、数据库地址和主机名对应关系。
  2. 确认数据库中 zstack 用户授权范围与当前管理节点地址匹配后,重启管理服务。

验证方法

  • 数据库连接与管理服务可以正常启动,日志中不再出现 zstack 用户登录失败。
  • 管理平台可正常登录并执行基础管理操作。
ZSphere change_ip 后管理服务启动异常且数据库用户登录失败 | 故障排查 · KB | ZStack 资源中心