【已评审】新增资源协作接口属性及redfish接口标准属性，支持BMC网口MTU修改能力

Interface SIG Interface评审
1

背景

BMC的网络设备MTU默认值为1500，当前现网存在BMC的MTU超过客户机房交换机设定导致丢包的情况，需要支持BMC网口MTU的修改能力。

关联ISSUE

暂无

整体方案

  1. 新增资源协作接口属性；
  2. 实现对应的redfish接口支持BMC以太网MTU修改能力；
  3. 新增导入导出及定制化项支持BMC以太网MTU修改能力。

评审点一：资源协作接口新增属性MTUSize

  • 场景1：资源协作接口bmc.kepler.Managers.EthernetInterfaces下新增属性MTUSize，用以保存以太网MTU大小
    详细描述：
    资源path：/bmc/kepler/Managers/${ManagerId}/EthernetInterfaces
    资源interface：bmc.kepler.Managers.EthernetInterfaces
    变化类型： 新增资源协作接口属性
    应用场景：
属性名称 取值类型 变化类型 默认 读写&权限 持久化 属性说明
MTUSize U16 新增属性 1500 R：ReadOnly W：BasicSetting PoweroffPer 以太网MTU大小
  • 场景2：资源协作接口bmc.kepler.Managers.EthernetInterfaces.EthGroup下新增属性MTUSize，用以保存以太网MTU大小
    详细描述：
    资源path：/bmc/kepler/Managers/${ManagerId}/EthernetInterfaces/EthGroup/${Id}
    资源interface：bmc.kepler.Managers.EthernetInterfaces.EthGroup
    变化类型： 新增资源协作接口属性
    应用场景：
属性名称 取值类型 变化类型 默认 读写&权限 持久化 属性说明
MTUSize U16 新增属性 1500 R：ReadOnly W：BasicSetting PoweroffPer 以太网MTU大小

评审点二：新增redfish接口

redfish接口/redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId}下新增标准属性MTUSize
详细描述：
资源URI：/redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId}
资源版本：EthernetInterface.v1_12_0
操作类型：GET/PATCH
新增属性：MTUSize，类型为integer，用以指定以太网MTU大小
操作权限：Readonly/BasicSetting

属性详细说明：

属性 类型 属性说明
MTUSize integer 指定以太网MTU大小

评审点三：新增MTUSize的出厂定制化项

项目 值
定制化项名称 BMCSet_NetWorkMTUSize
归属组件 bmc_network
类型 U16
默认值 1500
处理逻辑 if (BMCSet_MTUSize)
  修改网口MTUSize为BMCSet_NetWorkMTUSize的值
else
  设置为1500
end
说明 以太网MTU定制值

评审点四：新增MTUSize配置导入导出项

项目 值
导出项 EthGroup/EthGroups
导出子项 MTUSize
取值类型 U16
属性类型 ImportandExport
取值范围 576~9000
默认值 1500
含义说明 以太网MTU大小
导出后是否可以直接导入 是

评审结论

通过，具体结论如下：

  1. 同意资源协作接口 bmc.kepler.Managers.EthernetInterfaces 和 bmc.kepler.Managers.EthernetInterfaces.EthGroup 新增属性 MTUSize，表征以太网口的 MTU 大小；属性签名为 q，默认值为1500，取值范围为 [576, 9000]；属性为读写属性，读权限为 ReadOnly，写权限为 BasicSetting，掉电持久化
  2. 同意 Redfish 接口 /redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId} 新增标准属性MTUSize，用于展示和设置当前网口的 MTU 大小；属性类型为 integer，支持 GET 和 PATCH，PATCH 权限为BasicSetting；对应资源版本为 EthernetInterface.v1_12_0
  3. 同意新增定制化项 BMCSet_NetWorkMTUSize，用以设置以太网MTU大小；定制化项类型为U16， 取值范围为 [576, 9000]，空定制化时恢复到默认值 1500
  4. 同意配置项 EthGroup/EthGroups 下新增导入导出子项 MTUSize，取值类型为 U16， 取值范围为 [576, 9000]，导入导出类型为 ImportandExport，导出后可以直接导入