适用场景

• 产品：ZCF
• 组件：ZCE-X
• 涉及对象：无块存储、对象服务平台、网关网络、host gateway_ips
• 版本：5.2.115.6
• 触发条件： 在线集群需要增加 OSP gateway 网段，以便从不同的网关网络访问对象服务平台。

问题现象

• 当前对象服务平台仅支持现有网关网段访问。
• 由于访问需求变化，需要为对象服务平台新增一段网关网络。
• 新增网关网段后，还需同步更新 host 表中的 gateway_ips 字段。

判断方法

1. 确认当前环境属于本文适用范围，并记录当前版本、目标版本、系统架构、操作系统、部署形态和存储类型等关键信息。
2. 使用 xms-cli 查看对象服务平台或 host ID。
3. 检查新增网关网段与当前网关网络之间是否具备互通条件。

原因说明

需要从不同的网关网络访问对象服务平台，因此在线集群必须新增 OSP gateway 网段，并同步更新平台与 host 的网关网络配置。

解决方案

1. 执行前准备

• 风险等级：中风险
• 变更前确认新增网关网段与当前网关网段互通。
• 如涉及跨网段三层互通，需要提前规划静态路由。
• 确认具备 xms-cli、zs-vlan 和 zs-network-setting 执行权限。

2. 处理步骤

1. 查看对象服务平台的 ID，为后续 xms-cli 修改网络做准备。

• 预期结果：获取后续变更所需平台或主机 ID。

2. 在对象服务平台节点上新增 VLAN 网络网卡。

• 以 ZS05s01 服务器为例，其余存储服务器依次修改。

   zs-vlan -c bond0 61
   zs-network-setting -i bond0.61 192.168.61.13 255.255.255.0

• 预期结果：新增 VLAN 网卡创建成功。

3. 如需跨网段三层互通，配置静态路由。

• 预期结果：新增网关网段可达。

4. 修改对象服务平台网关网络。

   xms-cli --user admin --password Zstack@123 cluster set network --gateway 192.168.63.0/24,192.168.61.0/24

• 预期结果：对象服务平台网关网络更新完成。

5. 查看 host ID。

   xms-cli --user admin --password admin host list

• 预期结果：确认每个节点的 host ID。

6. 为每个节点添加新的 gateway_ips 字段。

   xms-cli --user admin --password admin host set --gateway-ips 192.168.63.13,192.168.61.13 1

• 其中 1 为 hostID，其余节点需分别执行。
• 预期结果：host 表中的 gateway_ips 字段更新成功。

7. 在界面或平台中检查新增网关网络是否显示正确。

• 预期结果：新增网关网络可见并生效。

验证方法

• 使用 xms-cli 再次检查 cluster network 和 host gateway_ips 配置。
• 确认新增网关网段与当前网关网段可互通。
• 确认对象服务平台可以从新增网关网络正常访问。

风险与回滚

• 风险：若网关网络或静态路由配置错误，可能导致对象服务平台访问异常。
• 风险：若 gateway_ips 更新不完整，不同节点访问行为可能不一致。
• 回滚：未单独提供回退命令；异常时应删除新增网关配置、恢复原 cluster set network 与 host set --gateway-ips 配置，并重新验证网络可达性。