问题说明
本文用于排查“ZSphere change_ip 后管理服务启动异常且数据库用户登录失败”类问题。
现象
- 执行 change_ip 修改管理节点 IP 后管理服务启动失败。
- 错误指向 zstack 用户登录数据库失败,手工更新密码后仍无法登录。
适用环境
- 产品:ZVF
- 版本:4.10.26
- 组件:ZSphere
- 涉及对象:管理节点
- 场景:管理面与升级类问题,需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- 管理节点 IP 变更后数据库连接地址、授权主机或配置未同步。
- 数据库用户授权、密码或配置文件中的连接信息不一致。
- change_ip 过程中部分服务或配置更新失败。
排查步骤
按顺序执行以下检查,并记录受影响对象、发生时间、完整报错和当前状态。
- 确认 change_ip 前后管理 IP、VIP、数据库地址和主机名变化。
- 检查管理服务配置中的数据库连接地址和 zstack 用户授权范围。
- 查看 change_ip 执行日志和 management-server.log 中数据库连接错误。
- 修复数据库连接信息前先备份数据库和配置文件,避免反复手工改密码扩大影响。
处理方法
- 依据变更前备份,核对并恢复管理服务配置中的管理 IP、VIP、数据库地址和主机名对应关系。
- 确认数据库中
zstack用户授权范围与当前管理节点地址匹配后,重启管理服务。
验证方法
- 数据库连接与管理服务可以正常启动,日志中不再出现
zstack用户登录失败。 - 管理平台可正常登录并执行基础管理操作。
