问题说明
本文用于排查“ZSphere 添加主机失败且提示管理 VLAN 与集群默认 VLAN 不一致”类问题。
现象
- 添加主机失败，错误包含 default port group、managementIp vlanId 与 cluster default vlanId 不一致。
- 目标主机网络可达，但初始化默认端口组失败。
适用环境
- 产品：ZVF
- 版本：4.x
- 组件：ZSphere
- 涉及对象：主机添加
- 场景：主机与硬件类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- 集群默认 VLAN 与主机管理网口所在 VLAN 规划不一致。
- 安装或初始化阶段选择了错误的管理网卡、bond 或 VLAN 参数。
- 主机底层残留网桥或端口组配置与集群当前配置冲突。
排查步骤
按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。
- 核对集群默认 VLAN、管理网络 VLAN、主机管理 IP 所在交换机端口 VLAN。
- 确认添加主机时选择的管理网卡/bond 与实际管理网络一致。
- 检查主机底层 bridge、bond、VLAN 子接口是否存在历史残留。
- 修正网络规划或清理残留后重新添加主机。
处理方法
- 统一集群默认 VLAN、管理网络 VLAN 和待添加主机的管理网络配置。
- 清理确认无引用的历史 bridge、bond 或 VLAN 子接口配置后，重新添加主机。
验证方法
- 管理 VLAN 与集群默认 VLAN 配置一致，主机可以成功添加。
- 添加后，主机管理网络和集群内既有业务网络均正常连通。