【待评审】新增超节点配置信息及北向接口

背景

超节点配置信息新增了机框对外端口最大通道数,需要新增一个资源协作接口用于承载该属性,同时提供北向接口用于查询与设置。

前置【待评审】新增NPU超平面&参数面 GroupId属性 - Interface SIG / Interface评审 - openUBMC 论坛 新增的超平面&参数面 GroupId属性补充WebRest接口、IPMI接口。

关联ISSUE

整体方案

新增资源协作接口、Redfish接口、WebRest接口、IPMI接口和配置导入导出项,用于承载和下发超节点配置:OutboundPortMaxLanes 机框对外端口最大通道数。

超平面&参数面 GroupId属性 NPUScaleUpGroupId、NPUScaleOutGroupId 补充WebRest接口、IPMI接口。

评审点

是否同意新增相关接口

详细描述

评审点1、新增资源协作接口

已有接口:bmc.kepler.Chassis.SuperPodLabel下新增属性OutboundPortMaxLanes 机框对外端口最大通道数

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
OutboundPortMaxLanes y true false 机框对外端口最大通道数 Read: ReadOnly CSR 掉电持久化 false

评审点2、新增Redfish接口属性

/redfish/v1/Chassis/{ChassisId}接口,Oem/Huawei下新增属性NPUScaleUpGroupId、NPUScaleOutGroupId

示例:

"Oem": {
    "Huawei": {
        "SuperPodLabel": {
            …
            "ScaleUpPortMaxLanes": 2,   
            "ScaleUpExtendPortMaxLanes": 2,
            "ScaleOutPortMaxLanes": 2
        }
    }
}

资源URI:/redfish/v1/Chassis/{ChassisId} (已有)

资源版本:#Chassis.v1_26_0.Chassis

变化类型:新增属性

操作类型:GET、PATCH

属性列表:

属性名 类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
ScaleUpPortMaxLanes [integer,null] 1、2、4 false / 是 BasicSetting ScaleUp端口最大通道数,取值范围:1、2、4,null表示不使用
ScaleUpExtendPortMaxLanes [integer,null] 1、2、4 false / 是 BasicSetting ScaleUp扩展端口最大通道数,取值范围:1、2、4,null表示不使用
ScaleOutPortMaxLanes [integer,null] 1、2、4 false / 是 BasicSetting ScaleOut端口最大通道数,取值范围:1、2、4,null表示不使用

Schema定义:

“ScaleUpPortMaxLanes”: {

"type": [

    "integer",

    "null"

],

"readonly": false,

"description": "Indicates the maximum lanes of ScaleUp ports"

},

“ScaleUpExtendPortMaxLanes”: {

"type": [

    "integer",

    "null"

],

"readonly": false,

"description": "Indicates the maximum lanes of ScaleUp extend ports"

},

“ScaleOutPortMaxLanes”: {

"type": [

    "integer",

    "null"

],

"readonly": false,

"description": "Indicates the maximum lanes of ScaleOut ports"

}

评审点3、新增WebRest接口用于展示、设置新增的超节点属性

/UI/Rest/System/SuperPodOptions接口,SuperPodLabel下新增属性ScaleUpPortMaxLanes、ScaleUpExtendPortMaxLanes、ScaleOutPortMaxLanes、ScaleUpPortMaxLanesSupported、ScaleUpExtendPortMaxLanesSupported、ScaleOutPortMaxLanesSupported、ScaleUpPortMaxLanesAllowedNumbers、ScaleUpExtendPortMaxLanesAllowedNumbers、ScaleOutPortMaxLanesAllowedNumbers、NPUScaleUpGroupId、NPUScaleOutGroupId、NPUScaleUpGroupIdSupported、NPUScaleOutGroupIdSupported

示例:

"SuperPodLabel": {
    "SuperPodId": 1,
    …
    "ScaleUpPortMaxLanes": 2,    
    "ScaleUpExtendPortMaxLanes": 2,
    "ScaleOutPortMaxLanes": 2,
    "ScaleUpPortMaxLanesSupported": true,
    "ScaleUpExtendPortMaxLanesSupported": true,
    "ScaleOutPortMaxLanesSupported": true,
    "ScaleUpPortMaxLanesAllowedNumbers": [1,2,4],
    "ScaleUpExtendPortMaxLanesAllowedNumbers": [1,2,4],
    "ScaleOutPortMaxLanesAllowedNumbers": [1,2,4],
    "NPUScaleUpGroupId": 1,    
    "NPUScaleOutGroupId": 1,
    "NPUScaleUpGroupIdSupported": true,
    "NPUScaleOutGroupIdSupported": true                                  

}

变化类型:新增属性

操作类型:GET、PATCH

属性名 类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
ScaleUpPortMaxLanes [integer,null] 1、2、4 false / 是 BasicSetting ScaleUp端口最大通道数,取值范围:1、2、4,null表示不使用
ScaleUpExtendPortMaxLanes [integer,null] 1、2、4 false / 是 BasicSetting ScaleUp扩展端口最大通道数,取值范围:1、2、4,null表示不使用
ScaleOutPortMaxLanes [integer,null] 1、2、4 false / 是 BasicSetting ScaleOut端口最大通道数,取值范围:1、2、4,null表示不使用
ScaleUpPortMaxLanesSupported bool true、false true / 否 ReadOnly 只读,表示WEB是否支持展示ScaleUp端口最大通道数
ScaleUpExtendPortMaxLanesSupported bool true、false true / 否 ReadOnly 只读,表示WEB是否支持展示ScaleUp扩展端口最大通道数
ScaleOutPortMaxLanesSupported bool true、false true / 否 ReadOnly 只读,表示WEB是否支持展示ScaleOut端口最大通道数
ScaleUpPortMaxLanesAllowedNumbers array 例如:[1,2,4] true / 否 ReadOnly 只读,表示ScaleUp端口最大通道数属性的取值范围
ScaleUpExtendPortMaxLanesAllowedNumbers array 例如:[1,2,4] true / 否 ReadOnly 只读,表示ScaleUp扩展端口最大通道数属性的取值范围
ScaleOutPortMaxLanesAllowedNumbers array 例如:[1,2,4] true / 否 ReadOnly 只读,表示ScaleOut端口最大通道数属性的取值范围
NPUScaleUpGroupId integer 0-65535 false / 是 BasicSetting ScaleUp网络平面(如超平面网络)分组标识,默认值65535表示无分组,取值范围:0-65535
NPUScaleOutGroupId integer 0-65535 false / 是 BasicSetting ScaleOut网络平面(如参数面网络)分组标识,默认值65535表示无分组,取值范围:0-65535
NPUScaleUpGroupIdSupported bool true、false true / 否 ReadOnly 只读,表示WEB是否支持展示ScaleUp网络平面分组标识
NPUScaleOutGroupIdSupported bool true、false true / 否 ReadOnly 只读,表示WEB是否支持展示ScaleOut网络平面分组标识

评审点4、IPMI接口文档,超节点信息配置属性列表新增属性

IPMI接口文档中表15.2 超节点信息配置属性列表

属性名称 Type Length
NPUScaleUpGroupId 0x09 2
NPUScaleOutGroupId 0x0a 2
ScaleUpPortMaxLanes 0x0b 1
ScaleUpExtendPortMaxLanes 0x0c 1
ScaleOutPortMaxLanes 0x0d 1

评审点5、配置导入导出新增超节点属性

配置项名称 配置项类别 配置项 归属组件 取值类型 取值说明 导入导出类型 说明
超节点配置 SuperPodLabel NPUScaleUpGroupId chassis U16 取值范围:0-65535 ImportAndExport ScaleUp网络平面(如超平面网络)分组标识,默认值65535表示无分组
超节点配置 SuperPodLabel NPUScaleOutGroupId chassis U16 取值范围:0-65535 ImportAndExport ScaleOut网络平面(如参数面网络)分组标识,默认值65535表示无分组
超节点配置 SuperPodLabel ScaleUpPortMaxLanes chassis U8 取值范围:[0, 1, 2, 4] ImportAndExport ScaleUp端口最大通道数,取值范围:0、1、2、4,0表示不使用
超节点配置 SuperPodLabel ScaleUpExtendPortMaxLanes chassis U8 取值范围:[0, 1, 2, 4] ImportAndExport ScaleUp扩展端口最大通道数,取值范围:0、1、2、4,0表示不使用
超节点配置 SuperPodLabel ScaleOutPortMaxLanes chassis U8 取值范围:[0, 1, 2, 4] ImportAndExport ScaleOut端口最大通道数,取值范围:0、1、2、4,0表示不使用

是否准备好AI预审

是

评审结论

遗留问题

(可选)列出评审会议现场无法直接给出明确结论的事务,会后确认清楚之后要在此处录入明确的结论,如不涉及,则可以写无或删除此部分。参考格式如下:(提交议题时删除此引导说明)
1、需要确认XXX
结论:

预审答案内容由AI生成,仅供参考:

帖子评审结论:【待评审】新增超节点配置信息及北向接口

帖子相关性:相关(MDB 相关: 内容含强特征: 资源协作)

  • 总评审点数:2
  • MDB 资源协作接口评审点:1
  • Redfish 相关评审点:1
  • 其他评审点:0

总体结果:不通过(1/2 个评审点通过)

评审点 1:评审点1、新增资源协作接口【MDB】

结果:通过

  • 规则合规性检查:通过(29 项检查全部通过)

评审点 2:评审点2、新增Redfish接口属性【Redfish】

结果:不通过

  • URI 示例生成:通过
  • Schema 验证:通过(1 项通过,5 项警告)
    • Schema 来源:DMTF ✓,OEM ✗(实际参与校验:DMTF)
    • 入口 schema 文件:dmtf/Chassis.v1_26_0.json(DMTF 官方 schema(SchemaFiles/dmtf))
    • Schema 依据:静态校验直接依据:DMTF 官方 schema(SchemaFiles/dmtf)(dmtf/Chassis.v1_26_0.json)
  • 规则合规性检查:不通过(1/18 项失败)
    • 规则合规性失败项(必须项):
      规则ID:RULE-007
      级别:必须项
      问题描述:自定义属性未通过 Oem 通道扩展,而是直接放在标准资源级别,不符合 OEM 扩展通道规则。
      处理建议:将 NPUScaleUpGroupId 和 NPUScaleOutGroupId 放入 Oem.openUBMC 对象,或通过标准 Links/Actions 的 Oem 扩展结构表达,避免直接污染 Chassis 顶层属性。
    • 警告项(建议性):
      规则ID:RULE-002
      级别:建议性
      问题描述:发现自定义属性 NPUScaleUpGroupId 和 NPUScaleOutGroupId 直接添加在标准 Chassis 资源顶层,未放入 Oem 扩展对象,不符合标准化属性要求。
      处理建议:这是一个 severity=‘should’ 的建议性规则,建议修改以提升规范符合性