【已评审】支持双网口场景资源协作接口评审

Interface SIG Interface评审
1

背景介绍：
BMC多外出网口场景，支持NCSI口和专用口有独立IP。该场景要求NCSI口和专用口分别作为一个IPMI的LAN通道，且板载网卡的NCSI口需要支持CSR配置以及定制会对应LAN通道的channel nunmber。目前新增网口对象通过EthGroup对象管理，有以下两个信息需要在资源协作接口承载：

  1. 网口类型为NCSI口还是专用口；
  2. 网口channel number号支持定制，需要通过资源协作接口承载各自的channel number号；
  3. 网口支持独立设置IP版本，需要承载IP协议的版本；

基于以上背景，需要新增资源协作接口：

评审点：新增资源协作接口用于承载网口的端口类型和channel number

资源path：/bmc/kepler/Managers/${ManagerId}/EthernetInterfaces/EthGroup/${Id}

资源interface：bmc.kepler.Managers.EthernetInterfaces.EthGroup

变化类型：新增资源协作接口属性

应用场景：

  • 业务处理标识当前网口连接的网卡类型，当前网口对应lan通道的channel number，当前网口IP版本

详细描述：

属性名称 变化类型 签名 访问权限 持久化 变化通知 属性值来源 说明 约束
AssociatedPortType 新增属性 y 读：ReadOnly
写：不支持		 不持久化 false PSR 网口组关联的网口类型 取值：
1：NCSI port
2：DEDICATED port
Channel 新增属性 y 读：ReadOnly
写：BasicSetting		 掉电 false PSR 网口对应lan通道的channel number 取值范围 [1, 11]
IpVersion 新增属性 s 读：ReadOnly
写：BasicSetting		 掉电 false 默认值 IP版本，默认为IPv4AndIPv6 取值范围 IPv4,IPv6,IPv4AndIPv6

评审结论

通过，同意资源协作接口 bmc.kepler.Managers.EthernetInterfaces.EthGroup 下新增属性 AssociatedPortType,Channel,IpVersion。属性具体信息如下：

  • AssociatedPortType，签名为 y，只读属性，读权限为 ReadOnly，不需要持久化，不发送变更通知事件，表示网口组关联的网口类型，取值有1：NCSI port；2：DEDICATED port
  • Channel，签名为 y，读写属性，读权限为 ReadOnly，写权限为 BasicSetting，需要掉电持久化，不发送变更通知事件，表示当前网口对应LAN通道的通道编号, 取值范围限定为 [1, 11]
  • IpVersion，签名为 s，读写属性，读权限为 ReadOnly，写权限为 BasicSetting，需要掉电持久化，不发送变更通知事件，表示当前网口对应的IP版本号，默认值为 IPv4AndIPv6，有效取值范围为 [IPv4,IPv6,IPv4AndIPv6]
2

【预审意见】

  1. 背景介绍中“BMC双网口场景…”，这里没有限定说双网口场景，以及对应的ethX口是限定的；BMC在这个场景下是 多外出网口
  2. 对于BMC来说，一个服务器既可以支持单网口模式，也可以支持多网口模式，当前 EthGroup 类的配置是如何处理差异化内容的
  3. Channel 是私有属性的原因是啥，迁移资源协作接口是什么意思？对于当前的 EthGroup 来说是不是就是新增属性（如果是的话就是新增属性）？
3
  1. 已修改背景介绍；
  2. 多网口场景会配置多个EthGroup对象，如果切换为单网口模式，会设置EthGroup的Status属性为false，表征当前网口不启用；
  3. Channel是历史已有属性，之前是私有属性，现在需要又ipmi_core组件来设置channel number，所以需要上到资源协作接口；