问题说明
本文用于排查“插件化 / 密码资源和加密表”类问题。
适用环境
- 产品：ZCF
- 组件：Cloud
- 涉及对象：数据库/管理节点
- 版本：4.x、5.x
- 场景：插件化 / 密码资源和加密表
问题现象
- 管理节点数据库、binlog、审计表或元数据相关操作出现异常。
- 升级、插件、服务重装或资源清理过程中涉及数据库连接、模式、表数据或引用关系。
- UI/API 展示与底层状态不一致，怀疑存在数据库或元数据残留。
可能原因
- 数据库空间、binlog、审计表或历史数据增长异常。
- 主备复制、数据库密码、升级脚本或服务重装流程未完全匹配当前环境。
- 底层资源变更后平台数据库中的引用关系未同步清理。
排查步骤
- 确认当前版本、管理节点数量、数据库主备角色、操作时间和失败任务。
- 检查管理节点磁盘空间、数据库目录、mysql-bin、审计表和相关服务状态。
- 检索 management-server 日志、升级日志或插件日志，定位数据库连接、SQL、表结构、uuid 或 AK/SK 相关错误。
- 如果涉及元数据清理或数据库修改，先完成数据库备份，并由 ZStack 官方技术支持确认 SQL 和回滚路径。
关键命令
df -h
du -sh /var/lib/zstack /var/lib/mysql /usr/local/zstack 2>/dev/null
zsha2 status
grep -a -nE "mysql|mariadb|database|SQLException|binlog|relay|uuid|AK|SK" /usr/local/zstack/apache-tomcat/logs/management-server.log*解决方案
- 按案例定位结果处理数据库空间、主备复制、升级参数、插件配置或元数据残留。
- 涉及删除、修改数据库或清理底层残留时，必须先备份并确认影响面。
验证方法
- 复核本文所述现象是否消失。
- 平台 UI、API、管理节点日志和底层命令输出能够相互印证。
- 至少观察一个相关任务周期或告警周期，确认问题不再复现。
风险与回滚
- 禁止在未备份、未确认引用关系时直接修改数据库。
- binlog、审计表和元数据清理可能影响审计、回滚、同步和资源状态。
注意事项
- 涉及管理服务、数据库、证书、权限、审计和安全配置调整时，应先确认 HA 状态、业务窗口、回退方案和合规保留要求。
- 若需要数据库修改、底层文件处理、锁释放、服务重启、驱动/固件升级或批量资源变更，应联系 ZStack 官方技术支持确认后再执行。