问
UIS-退出维护模式故障
9小时前提问
- 0关注
- 0收藏，28浏览
UIS/CAS：退出维护模式，报错【网络通信异常（错误码‑1）】
含义：Web 前端向后端节点下发退出维护模式 API 请求，HTTP 调用被中断，没有收到返回报文，并不是 ping 不通，是平台内部 API 通信失败知了社区。 现象：页面按钮操作报错，无法退出维护模式；主机已经 SSH 可以连通，基础网络 ping 通。
根因分类
- 管理节点与该主机之间管理网访问受限、防火墙 / 安全组拦截内部 API 端口（8080、8443）
- 故障主机上
cvknode-agent节点代理服务假死、异常 - CVM 管理平台内部
fsm_core流程服务异常 - Web 会话缓存问题，浏览器层面请求中断
排查步骤（按顺序执行）
步骤 1：先排除浏览器侧问题
- 清除浏览器缓存，用 Chrome 无痕模式登录 UIS 页面，再次点击退出维护模式。
- 不要用跨网段代理访问管理页面，优先在管理网同网段终端打开 Web。
步骤 2：网络连通性校验（管理网）
登录 CVM 管理节点 SSH，测试故障主机 API 端口连通：
bash
ping 故障主机管理IP
telnet 故障主机管理IP 8443
telnet 故障主机管理IP 8080
⚠️集群内部管理网不要加 ACL、防火墙拦截 8080/8443 端口；如果中间有防火墙，UIS 集群内部主机之间所有端口建议放行。
步骤 3：后台命令行强制退出维护模式（优先，绕过 web 页面）
登录 CVM 管理节点 SSH，执行命令，把参数替换为实际环境：
bash
cvhost -m 故障主机管理IP -u admin -p你的密码 --exit-maintain
- 如果这条命令执行成功，直接完成退出维护模式，刷新 web 页面状态恢复。
- 如果命令行同样报错，说明不是浏览器问题，是主机代理服务异常，继续往下操作知了社区。
步骤 4：登录故障主机 SSH，重启节点代理服务
bash
#查看agent状态
systemctl status cvknode-agent
#重启节点代理
systemctl restart cvknode-agent
#确认状态active
systemctl status cvknode-agent
重启 agent 后，再回到 CVM 执行上面
cvhost退出维护模式命令。步骤 5：若还失败，检查 CVM 管理平台服务
bash
#查看fsm_core服务状态
systemctl status fsm_core
#异常则重启管理流程服务
systemctl restart fsm_core
特殊场景风险提醒
- 集群只剩这一台节点处于维护模式，其他节点异常离线：不允许退出维护模式，UIS 会拒绝操作，需要先恢复其他节点。
- 存储池状态异常（OSD 告警、存储池非 active），也会拦截退出维护模式；先处理存储告警。
- 执行完退出维护模式之后，确认存储数据重平衡任务自动启动。
应急回退说明
禁止直接修改数据库强行抹掉维护模式标记，会造成集群状态不一致。优先使用cvhost命令行接口。
快速定位判断
- Web 报错‑1，但
cvhost命令成功：浏览器 / 会话问题。 - Web 报错‑1，
cvhost命令也报接口调用失败：主机 agent 服务、管理网端口拦截问题。
暂无评论
zhiliao_Gixe
八段
UIS退出维护模式故障排查步骤
1. 基础状态检查
登录UIS运维平台（CloudOS/Matrix），进入【主机管理】查看主机维护模式状态，同时检查主机是否存在未完成的任务（如迁移、升级、快照），有残留任务先手动取消或等待完成。
2. 后台命令排查（SSH登录主机）
查看主机维护模式状态：vim-cmd hostsvc/maintenance_mode
强制退出维护模式（前台无残留任务时）：vim-cmd hostsvc/maintenance_mode_exit
检查主机上是否有运行/异常虚拟机：vim-cmd vmsvc/getallvms，若有未迁移虚拟机需先迁移或关机。
查看系统任务残留：vim-cmd task/list，异常任务可通过vim-cmd task cancel <任务ID>取消。
3. 常见场景处理
存储异常导致无法退出：检查存储挂载状态esxcli storage nfs list/esxcli storage vmfs extent list，修复存储连接后重试。
平台与主机状态不同步：重启主机上的UIS代理服务service uis-agent restart，或在平台重新同步主机状态。
主机升级残留导致：确认升级包状态，执行uis upgrade status查看升级进度，异常则回滚或清理升级残留。
4. 兜底操作
以上无效可重启主机管理代理（不影响业务虚拟机）：services.sh restart，再尝试退出维护模式。
1. 基础状态检查
登录UIS运维平台（CloudOS/Matrix），进入【主机管理】查看主机维护模式状态，同时检查主机是否存在未完成的任务（如迁移、升级、快照），有残留任务先手动取消或等待完成。
2. 后台命令排查（SSH登录主机）
查看主机维护模式状态：vim-cmd hostsvc/maintenance_mode
强制退出维护模式（前台无残留任务时）：vim-cmd hostsvc/maintenance_mode_exit
检查主机上是否有运行/异常虚拟机：vim-cmd vmsvc/getallvms，若有未迁移虚拟机需先迁移或关机。
查看系统任务残留：vim-cmd task/list，异常任务可通过vim-cmd task cancel <任务ID>取消。
3. 常见场景处理
存储异常导致无法退出：检查存储挂载状态esxcli storage nfs list/esxcli storage vmfs extent list，修复存储连接后重试。
平台与主机状态不同步：重启主机上的UIS代理服务service uis-agent restart，或在平台重新同步主机状态。
主机升级残留导致：确认升级包状态，执行uis upgrade status查看升级进度，异常则回滚或清理升级残留。
4. 兜底操作
以上无效可重启主机管理代理（不影响业务虚拟机）：services.sh restart，再尝试退出维护模式。
暂无评论
编辑答案
➤
✖
亲~登录后才可以操作哦!
确定
✖
✖
你的邮箱还未认证，请认证邮箱或绑定手机后进行当前操作
✖
举报
×
侵犯我的权益
>
对根叔社区有害的内容
>
辱骂、歧视、挑衅等（不友善）
侵犯我的权益
×
侵犯了我企业的权益
>
抄袭了我的内容
>
诽谤我
>
辱骂、歧视、挑衅等（不友善）
骚扰我
侵犯了我企业的权益
×
您好，当您发现根叔知了上有关于您企业的造谣与诽谤、商业侵权等内容时，您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到 pub.zhiliao@h3c.com 邮箱，我们会在审核后尽快给您答复。
- 1. 您举报的内容是什么？（请在邮件中列出您举报的内容和链接地址）
- 2. 您是谁？（身份证明材料，可以是身份证或护照等证件）
- 3. 是哪家企业？（营业执照，单位登记证明等证件）
- 4. 您与该企业的关系是？（您是企业法人或被授权人，需提供企业委托授权书）
我们认为知名企业应该坦然接受公众讨论，对于答案中不准确的部分，我们欢迎您以正式或非正式身份在根叔知了上进行澄清。
抄袭了我的内容
×
原文链接或出处
诽谤我
×
您好，当您发现根叔知了上有诽谤您的内容时，您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到pub.zhiliao@h3c.com 邮箱，我们会尽快处理。
- 1. 您举报的内容以及侵犯了您什么权益？（请在邮件中列出您举报的内容、链接地址，并给出简短的说明）
- 2. 您是谁？（身份证明材料，可以是身份证或护照等证件）
我们认为知名企业应该坦然接受公众讨论，对于答案中不准确的部分，我们欢迎您以正式或非正式身份在根叔知了上进行澄清。
对根叔社区有害的内容
×
垃圾广告信息
色情、暴力、血腥等违反法律法规的内容
政治敏感
不规范转载
>
辱骂、歧视、挑衅等（不友善）
骚扰我
诱导投票
不规范转载
×
举报说明
暂无评论