背景
自研 RAID 卡一致性校验(Consistency Check)在固件 1.0 与 2.0 上能力不同:
| 能力项 | 固件1.0 | 固件2.0 |
|---|---|---|
| 自动修复开关 | 全局 1 个 | 按 RAID 级别两组:镜像组 RAID(1/10)、校验组 RAID(5/6/50/60) |
问题场景与影响点 :客户通过 Web/Redfish 配置 自研 RAID 卡一致性校验策略。在固件 2.0 上:自动修复按 RAID 级别分为镜像组与校验组两个开关,而北向只有全局 1 个开关,用户无法对两组分别控制。
当前系统差距 :后端未识别固件能力差异,资源协作接口无按级别修复属性与对应下发方法,Redfish/Web 北向零感知,全部按固件 1.0 全局模型工作。
现有 VolumeConsistencyCheckConfig 本为 OEM 扩展,故新增能力继续走 OEM 扩展。
兼容性约束 :存量属性/方法签名一律不动;北向仅新增 2 个按级别修复字段。
关联ISSUE
- 【openUBMC】自研 RAID 卡一致性校验适配固件类型1.0和2.0 — 资源协作接口/Redfish/Web 三口适配按 RAID 级别自动修复与周期差异
整体方案
资源协作接口:
bmc.kepler.Systems.Storage.Controller.ConsistencyCheck新增 2 个按级别修复属性 + 2 个 V2 方法(EnableV2/SetParametersV2,字典入参 a{ss};存量 Enable/SetParameters 签名不改动);
北向接口:
2. Redfish Storage 资源 OEM VolumeConsistencyCheckConfig 扩展 2 个属性增量透传
3. Web rest 接口一致性校验配置 GET/PATCH ConsisCheckInfo 对象新增 2 个属性
评审点
资源协作接口
- 变更
bmc.kepler.Systems.Storage.Controller.ConsistencyCheck:新增 2 个按级别修复属性与 2 个 V2 方法(EnableV2/SetParametersV2)
Redfish接口
- Storage 资源 OEM
VolumeConsistencyCheckConfig新增 2 个按级别自动修复属性
Web接口
- 一致性校验配置 GET/PATCH
ConsisCheckInfo对象新增 2 个按级别自动修复属性
详细描述
评审点1:变更资源协作接口 bmc.kepler.Systems.Storage.Controller.ConsistencyCheck
变更描述 :该接口承载一致性校验全部配置能力,新增的按级别自动修复同属一致性校验功能的一部分。仅新增,不变更/废弃任何存量属性与方法。
接口链接 :bmc.kepler.Systems.Storage.Controller.ConsistencyCheck 接口定义(storage mds/model.json)、接口定义(mdb_interface json/intf)
变更属性
| 变更类型 | 属性名称 | 签名 | 只读 | 变化通知 | 属性描述 | 访问权限 | 属性来源 | 持久化类型 | 变更影响 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | AutoRepairMirrorRaidEnabled | y | True | false | RAID(1/10) 组自动修复开关:0-关闭 1-开启;默认值 0xFF 表示无效;去使能后当出现条带不一致时不会自动触发修复 | Read: ReadOnly | 带外获取 | 无需持久化 | 新增属性,无影响 |
| 新增 | AutoRepairParityRaidEnabled | y | True | false | RAID(5/6/50/60) 组自动修复开关:0-关闭 1-开启,默认值 0xFF 表示无效;使能后当出现条带不一致时自动触发修复 | Read: ReadOnly | 带外获取 | 无需持久化 | 新增属性,无影响 |
存量属性语义约定(不变更定义,仅明确固件 2.0 行为)
| 属性 | 固件1.0 | 固件2.0 |
|---|---|---|
| AutoRepairEnabled(全局) | 固件实际值 | 读 = 两组 AND |
变更方法
| 变更类型 | 方法名称 | 请求签名 | 请求参数描述 | 响应签名 | 响应参数描述 | 方法描述 | 访问权限 | 变更影响 |
|---|---|---|---|---|---|---|---|---|
| 新增 | EnableV2 | a{ss} | Parameters(字典,key-参数名/value-参数值,缺省 key 表示不修改):Period:0xFFFF-不修改;Rate:0xFF-不修改;DelayToStart:0xFFFFFFFF-不修改;AutoRepairMirrorRaidEnabled:0-关闭 1-开启 0xFF-不修改;AutoRepairParityRaidEnabled:0-关闭 1-开启 0xFF-不修改 | 无 | 无 | 使能一致性校验并下发参数;字典入参,多参数一次下发、一次带外通信、原子生效 | BasicSetting | 新增方法,无影响;存量方法行为不变 |
| 新增 | SetParametersV2 | a{ss} | Parameters(字典,key-参数名/value-参数值,缺省 key 表示不修改):Period:0xFFFF-不修改;Rate:0xFF-不修改;AutoRepairMirrorRaidEnabled:0-关闭 1-开启 0xFF-不修改;AutoRepairParityRaidEnabled:0-关闭 1-开启 0xFF-不修改 | 无 | 无 | 仅设置参数不改变使能状态;字典入参,多参数一次下发、一次带外通信、原子生效 | BasicSetting | 新增方法,无影响;存量方法行为不变 |
变更接口影响
| 路径 | 变更接口影响 | CSR配置影响 | 持久化影响 | 其他影响 |
|---|---|---|---|---|
| /bmc/kepler/Systems/:SystemId/Storage/Controllers/:Id | 新增 2 个属性和 2 个方法(EnableV2/SetParametersV2),提供固件2.0 一致性校验差异能力 | 不涉及重名属性,无影响 | 不涉及持久化,无影响 | 新增属性仅 自研 固件2.0 返回有效值;存量属性/方法行为不变 |
本次变更不涉及信号与错误消息的新增/变更/废弃。
评审点2:Storage 资源 OEM VolumeConsistencyCheckConfig 新增属性
资源URI :/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}(包括/redfish/v1/Systems/{ComputerSystemId}/Storages/{StorageId})
资源版本 :OEM Schema openUBMCStorage.v1_0_0
方法 :GET/PATCH
属性列表 (仅列新增):
注1:列表内属性默认均支持 GET 操作。
注2:若属性在 Schema 中未显式定义 readonly 关键字,则默认为只读。
| 属性名 | 类型 | 示例/取值约束 | readonly | 易变属性 | 实现PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
| AutoRepairMirrorRaidEnabled | [boolean,null] | true;null 表示不支持 | false | 否 | 是 | BasicSetting | 镜像 RAID(1/10) 组自动修复开关 |
| AutoRepairParityRaidEnabled | [boolean,null] | true;null 表示不支持 | false | 否 | 是 | BasicSetting | 校验 RAID(5/6/50/60) 组自动修复开关;使能后当出现条带不一致时自动触发修复 |
Schema定义 :新增 OEM 属性在 openubmcstorage.v1_0_0.json ,参考原有AutoRepairEnabled属性
评审点3:Web rest 接口一致性校验配置 GET/PATCH 新增属性
资源URI :/UI/Rest/System/Storage/:id
资源版本 :/
变化类型 :已有接口 GET 响应体/PATCH 请求体中 ConsisCheckInfo 对象新增 2 个属性
操作类型 :Get、Patch
操作权限 :BasicSetting
应用场景 :Web 页面按固件能力渲染自动修复开关个数
Web 页面渲染规则 :
- 若
AutoRepairMirrorRaidEnabled/AutoRepairParityRaidEnabled有效:页面不显示原「自动修复」开关,改为显示两个按 RAID 级别的开关(镜像 RAID(1/10) 组 / 校验 RAID(5/6/50/60) 组) - 若两个新增开关均无效:页面仅显示原「自动修复功能」开关
GET 响应体 ConsisCheckInfo 新增属性 :
注1:列表内属性默认均支持 GET 操作。
注2:新增属性支持 PATCH,操作权限与存量一致性校验配置一致(BasicSetting)。
| 属性名 | 类型 | 示例/取值约束 | readonly | 易变属性 | 实现PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
| AutoRepairMirrorRaidEnabled | [integer,null] | 1(0-关闭 1-开启);null 表示不支持 | false | 否 | 是 | BasicSetting | 镜像 RAID(1/10) 组自动修复开关 |
| AutoRepairParityRaidEnabled | [integer,null] | 1(0-关闭 1-开启);null 表示不支持 | false | 否 | 是 | BasicSetting | 校验 RAID(5/6/50/60) 组自动修复开关;使能后当出现条带不一致时自动触发修复 |
Get响应示例(固件2.0,节选)
{
"ConsisCheckInfo": {
"Enabled": true,
"Period": 168,
"AutoRepairEnabled": 1,
"AutoRepairMirrorRaidEnabled": 1,
"AutoRepairParityRaidEnabled": 1,
"DelayForStart": 0
}
}
PATCH 请求体 ConsisCheckInfo 新增属性 :同上 2 个属性(Integer:0-关闭 1-开启;缺省表示不修改)
是否准备好AI预审
是
评审结论
-
评审点1(资源协作接口):通过。 资源:
/bmc/kepler/Systems/:SystemId/Storage/Controllers/:Id下的一致性校验资源协作对象;接口:bmc.kepler.Systems.Storage.Controller.ConsistencyCheck。新增 2 个只读属性AutoRepairMirrorRaidEnabled、AutoRepairParityRaidEnabled;新增 2 个 V2 方法EnableV2/SetParametersV2。属性与方法的详细定义见评审点1。 -
评审点2(Redfish接口):通过。 资源 URI:
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}(含 Storages 变体);OEM 资源:VolumeConsistencyCheckConfig(Schemaopenubmcstorage.v1_0_0),GET/PATCH。新增 2 个 属性AutoRepairMirrorRaidEnabled、AutoRepairParityRaidEnabled。属性取值约束与 Schema 定义见评审点2。 -
评审点3(Web接口):通过。 资源 URI:
/UI/Rest/System/Storage/:id;资源:GET 响应体/PATCH 请求体中ConsisCheckInfo对象,操作权限 BasicSetting。新增 2 个属性AutoRepairMirrorRaidEnabled、AutoRepairParityRaidEnabled;页面按固件能力渲染自动修复开关个数。属性定义与渲染规则见评审点3。
遗留问题
- EnableV2/SetParametersV2 是否可以不用“独立方法+多参数”的形式,改用“属性变可写 + 监听属性变更”实现,使用场景、功能稳定性、未来扩展性如何保障。
分析结论:
a. 使用场景是多个参数一起设置。一致性校验下发天然是多参数联动:使能开关、Period、Rate、DelayToStart、镜像组/校验组自动修复开关,需要一次请求整体生效。
b. 属性监听方案不可行,理由有三:
- 多次 RAID 卡通信:逐属性监听逐个下发,每个属性变更都触发一次 BMC 到 RAID 卡的带外通信。一次完整配置(使能+周期+速率+两组自动修复开关)要拆成 5 次以上 IPMI/带外交互,既拉长总时延,也放大了中间任意一次失败导致配置半途而废的风险;字典方法一次调用即完成一次带外交互,全部参数同步落到 RAID 卡。
- 非法中间状态与时序问题:会出现“Enable 开关还是关、用户却要开启自动修复”的非法状态——只有使能了一致性校验,才允许使能自动修复;且北向各属性到达顺序不确定,逐属性监听回调各自独立下发,无法原子生效,后端可能按不完整中间态执行。
- 扩展性:一致性校验是客户容易提特殊要求的特性,属性方案每加一个参数都要新增属性、变更北向 Schema 和渲染逻辑;字典方案扩展只需增加 key,方法签名不变化。
c. 最终结论:放弃“属性可写+监听变更”方案,把 EnableV2 和 SetParametersV2 的入参改为字典(Dictionary)实现:多个参数一次下发、一次带外通信、原子生效,后端统一校验前置依赖,规避时序问题和非法中间状态,并为后续扩展预留空间。