【已评审】支持北向接口扩展多网口能力评审

Interface SIG Interface评审
1

背景

  • BMC新增支持多网口多IP网络配置，当前CLI接口、web接口、SNMP接口只支持查询/设置单个网口的模式等网络配置，需要对北向接口能力扩展；

整体方案

  1. CLI接口支持针对不同网络配置设置网口模式、IP、MAC等网络配置；
  2. WEB界面支持针对不同网络配置设置网口模式；
  3. SNMP接口支持针对不同网络配置的属性；

评审点一

  • 支持多网口CLI接口适配

场景1：支持CLI接口查询多网口IP信息

  • 详细描述
    1. 返回信息增加LAN Channel Number字段标识当前LAN通道对应的Channel号；
    2. 多网口网络配置信息扩展，新增网口组信息向下平铺，不同网口组信息间添加空行分隔，VLAN信息作为公共信息置于末尾，通过空行分隔；
  • 样例参考：
    • 修改前
    # ipmcget -d ipinfo
 EthGroup ID               :  1
 Net Mode                  :  Manual
 Net Type                  :  Dedicated
 Active Port               :  eth2
 IP Version                :  IPv4AndIPv6
 IPv4 Information
 IP Mode                   :  static
 IP Address                :  76.76.19.97
 Subnet Mask               :  255.255.0.0
 Default Gateway           :  76.76.19.1
 Backup IP Address         :  192.168.2.100 (Deactivated)
 Backup Subnet Mask        :  255.255.255.0 (Deactivated)
 MAC Address               :  20:22:01:02:05:b2
 IPv6 Information
 IPv6 Mode                 :  dhcp
 IPv6 Address 1            :  fec0:75:1001:2fff::dfb4/64
 Default Gateway IPv6      :  fe80::f6e5:f2ff:fe49:a1c7
 Link-Local Address        :  fe80::2222:1ff:fe02:5b2/64
 IPv6 Address 2            :  7676:1954:3::2222:1ff:fe02:5b2/64
 IPv6 Address 3            :  7676:1954:a::2222:1ff:fe02:5b2/64
 IPv6 Address 4            :  7676:1954:4::2222:1ff:fe02:5b2/64
 IPv6 Address 5            :  7676:1954:b::2222:1ff:fe02:5b2/64
 IPv6 Address 6            :  7676:1954:5::2222:1ff:fe02:5b2/64
 IPv6 Address 7            :  7676:1954:c::2222:1ff:fe02:5b2/64
 IPv6 Address 8            :  7676:1954:1::2222:1ff:fe02:5b2/64
 IPv6 Address 9            :  7676:1954:8::2222:1ff:fe02:5b2/64
 IPv6 Address 10           :  7676:1954:6::2222:1ff:fe02:5b2/64
 IPv6 Address 11           :  7676:1954:d::2222:1ff:fe02:5b2/64
 IPv6 Address 12           :  7676:1954:2::2222:1ff:fe02:5b2/64
 IPv6 Address 13           :  7676:1954:9::2222:1ff:fe02:5b2/64
 IPv6 Address 14           :  7676:1954:7::2222:1ff:fe02:5b2/64
 VLAN Information
 NCSI Port VLAN State      :  enabled
 NCSI Port VLAN ID         :  1024
 Dedicated Port VLAN State :  disabled
    • 修改后
      # ipmcget -d ipinfo
EthGroup ID               :  1
LAN Channel Number        :  1 // 新增属性
Net Mode                  :  Manual
Net Type                  :  Dedicated
Active Port               :  eth2
IP Version                :  IPv4AndIPv6
IPv4 Information
IP Mode                   :  static
IP Address                :  76.76.19.97
Subnet Mask               :  255.255.0.0
Default Gateway           :  76.76.19.1
Backup IP Address         :  192.168.2.100 (Deactivated)
Backup Subnet Mask        :  255.255.255.0 (Deactivated)
MAC Address               :  20:22:01:02:05:b2
IPv6 Information
IPv6 Mode                 :  dhcp
IPv6 Address 1            :  fec0:75:1001:2fff::dfb4/64
Default Gateway IPv6      :  fe80::f6e5:f2ff:fe49:a1c7
Link-Local Address        :  fe80::2222:1ff:fe02:5b2/64
IPv6 Address 2            :  7676:1954:3::2222:1ff:fe02:5b2/64
IPv6 Address 3            :  7676:1954:a::2222:1ff:fe02:5b2/64
IPv6 Address 4            :  7676:1954:4::2222:1ff:fe02:5b2/64
IPv6 Address 5            :  7676:1954:b::2222:1ff:fe02:5b2/64
IPv6 Address 6            :  7676:1954:5::2222:1ff:fe02:5b2/64
IPv6 Address 7            :  7676:1954:c::2222:1ff:fe02:5b2/64
IPv6 Address 8            :  7676:1954:1::2222:1ff:fe02:5b2/64
IPv6 Address 9            :  7676:1954:8::2222:1ff:fe02:5b2/64
IPv6 Address 10           :  7676:1954:6::2222:1ff:fe02:5b2/64
IPv6 Address 11           :  7676:1954:d::2222:1ff:fe02:5b2/64
IPv6 Address 12           :  7676:1954:2::2222:1ff:fe02:5b2/64
IPv6 Address 13           :  7676:1954:9::2222:1ff:fe02:5b2/64
IPv6 Address 14           :  7676:1954:7::2222:1ff:fe02:5b2/64

EthGroup ID               :  2
LAN Channel Number        :  2 // 新增属性
Net Mode                  :  Manual
Net Type                  :  Dedicated
Active Port               :  eth0
IP Version                :  IPv4AndIPv6
IPv4 Information
IP Mode                   :  static
IP Address                :  76.76.16.97
Subnet Mask               :  255.255.0.0
Default Gateway           :  76.76.16.1
Backup IP Address         :  192.168.2.100 (Deactivated)
Backup Subnet Mask        :  255.255.255.0 (Deactivated)
MAC Address               :  20:22:01:02:05:b2
IPv6 Information
IPv6 Mode                 :  dhcp
IPv6 Address 1            :  fec0:75:1001:2fff::dfb4/64
Default Gateway IPv6      :  fe80::f6e5:f2ff:fe49:a1c7
Link-Local Address        :  fe80::2222:1ff:fe02:5b2/64
IPv6 Address 2            :  7676:1954:3::2222:1ff:fe02:5b2/64
IPv6 Address 3            :  7676:1954:a::2222:1ff:fe02:5b2/64
IPv6 Address 4            :  7676:1954:4::2222:1ff:fe02:5b2/64
IPv6 Address 5            :  7676:1954:b::2222:1ff:fe02:5b2/64
IPv6 Address 6            :  7676:1954:5::2222:1ff:fe02:5b2/64
IPv6 Address 7            :  7676:1954:c::2222:1ff:fe02:5b2/64
IPv6 Address 8            :  7676:1954:1::2222:1ff:fe02:5b2/64
IPv6 Address 9            :  7676:1954:8::2222:1ff:fe02:5b2/64
IPv6 Address 10           :  7676:1954:6::2222:1ff:fe02:5b2/64
IPv6 Address 11           :  7676:1954:d::2222:1ff:fe02:5b2/64
IPv6 Address 12           :  7676:1954:2::2222:1ff:fe02:5b2/64
IPv6 Address 13           :  7676:1954:9::2222:1ff:fe02:5b2/64
IPv6 Address 14           :  7676:1954:7::2222:1ff:fe02:5b2/64

VLAN Information
NCSI Port VLAN State      :  enabled
NCSI Port VLAN ID         :  1024
Dedicated Port VLAN State :  disabled

场景2：支持CLI设置网络配置信息扩展多网口

  • 详细描述：新增可选参数[groupid]用于选择设置哪个网口组的信息；
  • 具体涉及的接口如下：
# 1. Set EthGroup active port
~ ~ # ipmcset -d active
Usage: ipmcset -d activeport -v <option> [portid]
# 修改为
~ ~ # ipmcset -d active
Usage: ipmcset -d activeport -v <option> [portid] [groupid]

# 2. Set gateway
~ ~ # ipmcset -d gateway
Usage: ipmcset -d gateway -v <gateway>
# 修改为
~ ~ # ipmcset -d gateway
Usage: ipmcset -d gateway -v <gateway> [groupid]

# 3. Set ipv6 gateway
~ ~ # ipmcset -d gateway6
Usage: ipmcset -d gateway6 -v <gateway>
# 修改为
~ ~ # ipmcset -d gateway6
Usage: ipmcset -d gateway6 -v <gateway> [groupid]

# 4. Set ip address
~ ~ # ipmcset -d ipaddr
Usage: ipmcset -d ipaddr -v <ipaddr> <mask> [gateway]
# 修改为
~ ~ # ipmcset -d ipaddr
Usage: ipmcset -d ipaddr -v <ipaddr> <mask> [gateway] [groupid]

# 5. Set ipv6 address
~ ~ # ipmcset -d ipaddr6
Usage: ipmcset -d ipaddr6 -v <ipaddr6/prefixlen(0~128)> [gateway6]
# 修改为
~ ~ # ipmcset -d ipaddr6
Usage: ipmcset -d ipaddr6 -v <ipaddr6/prefixlen(0~128)> [gateway6] [groupid]

# 6. Set ip mode
~ ~ # ipmcset -d ipmode
Usage: ipmcset -d ipmode -v <dhcp|static>
# 修改为
~ ~ # ipmcset -d ipmode
Usage: ipmcset -d ipmode -v <dhcp|static> [groupid]

#  7. Set ipv6 mode
~ ~ # ipmcset -d ipmode6
Usage: ipmcset -d ipmode6 -v <dhcp|static>
# 修改为
~ ~ # ipmcset -d ipmode6
Usage: ipmcset -d ipmode6 -v <dhcp|static> [groupid]

# 8. Set ip version
~ ~ # ipmcset -d ipversion
Usage: ipmcset -d ipversion -v <ipversion>
# 修改为
~ ~ # ipmcset -d ipversion
Usage: ipmcset -d ipversion -v <ipversion> [groupid]

# 9. Set net mode
~ ~ # ipmcset -d netmode
Usage: ipmcset -d netmode -v <option>
# 修改为
~ ~ # ipmcset -d netmode
Usage: ipmcset -d netmode -v <option> [groupid]

评审点二

  • 支持多网口Web界面适配

详细描述

  1. web界面支持多网口组页签扩展；
  2. web界面网口组配置支持网口选择；
    具体样式在评审议题中呈现；

评审点三

  • 支持多网口SNMP接口扩展
    原节点列表：
节点名称 节点OID实例 描述 类型 权限
ethNum 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.1.1		 Information about Ethernet number. INTEGER not-accessible
ethIPAddress 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.2.1		 Information about Ethernet IPv4 address. IpAddress read-write
ethNetmask 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.3.1		 Information about netmask. IpAddress read-write
ethDefaultGateway 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.4.1		 Information about default gateway. IpAddress read-write
ethIPSource 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.5.1		 Information about IP source.
static(1), dhcp(2)		 INTEGER read-write
ethMACAddress 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.6.1		 Information about MAC address. DisplayString read-only
ethType 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.7.1		 Information about ethernet port type. mgmt(1) share(2) INTEGER read-only
ethHostPort 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.8.1		 Information about share ethernet binded host port. none(1) port1(2), port2(3), port3(4), port4(5) INTEGER read-write
ethEnable 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.9.1		 STATUS obsolete 该节点已不可用,设置后对系统无影响,不记录日志 INTEGER read-write
ethMode 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.10.1		 Information about network mode INTEGER read-write
vlanID 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.11.1		 Disable or enable VLAN and set ID. DisplayString read-write
ethInfo 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.12.1		 Set IPAddr,Netmask,Gateway.eg: 192.168.2.100, 255.255.255.0, 192.168.2.1 DisplayString read-write
ethIPv4Enable 1.3.6.1.4.1.201
1.2.235.1.1.12.50.1.13.1		 Information about eth IPv4 enabled. disable(1),enable(2) INTEGER read-write

详细描述

场景1：SNMP接口networkProperty支持多网口新增实例；

  • 历史SNMP接口networkProperty只支持一组实例，多网口场景下，新增的网口组无法查询/设置对应属性，支持将新增网口组信息扩展为新的实例；

评审结论

评审点一：

  1. 同意CLI接口响应扩展多网口组信息，新增网口组信息向下平铺，通过空行分隔；
  2. 同意响应信息中增加LAN Channel Number属性标识LAN通道的通道号；

评审点二：

  1. 同意web界面增加网口组页签，承载多个网口组的网络配置信息；
  2. 同意web界面新增网口选择面板，用以网口组选择网口资源；

评审点三：

  1. 同意SNMP接口networkProperty/networkDescriptionTable（OID：1.3.6.1.4.1.2011.2.235.1.1.12.50）增加实例，用以查询/设置多个网口组的网络配置信息；