【已评审】支持自研RAID卡一致性校验适配不同RAID固件

背景

自研 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

整体方案

资源协作接口:

  1. 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 个属性

评审点

资源协作接口

  1. 变更 bmc.kepler.Systems.Storage.Controller.ConsistencyCheck:新增 2 个按级别修复属性与 2 个 V2 方法(EnableV2/SetParametersV2)

Redfish接口

  1. Storage 资源 OEM VolumeConsistencyCheckConfig 新增 2 个按级别自动修复属性

Web接口

  1. 一致性校验配置 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. 评审点1(资源协作接口):通过。 资源:/bmc/kepler/Systems/:SystemId/Storage/Controllers/:Id 下的一致性校验资源协作对象;接口:bmc.kepler.Systems.Storage.Controller.ConsistencyCheck。新增 2 个只读属性 AutoRepairMirrorRaidEnabled、AutoRepairParityRaidEnabled;新增 2 个 V2 方法 EnableV2/SetParametersV2。属性与方法的详细定义见评审点1。

  2. 评审点2(Redfish接口):通过。 资源 URI:/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}(含 Storages 变体);OEM 资源:VolumeConsistencyCheckConfig(Schema openubmcstorage.v1_0_0),GET/PATCH。新增 2 个 属性 AutoRepairMirrorRaidEnabled、AutoRepairParityRaidEnabled。属性取值约束与 Schema 定义见评审点2。

  3. 评审点3(Web接口):通过。 资源 URI:/UI/Rest/System/Storage/:id;资源:GET 响应体/PATCH 请求体中 ConsisCheckInfo 对象,操作权限 BasicSetting。新增 2 个属性 AutoRepairMirrorRaidEnabled、AutoRepairParityRaidEnabled;页面按固件能力渲染自动修复开关个数。属性定义与渲染规则见评审点3。

遗留问题

  1. EnableV2/SetParametersV2 是否可以不用“独立方法+多参数”的形式,改用“属性变可写 + 监听属性变更”实现,使用场景、功能稳定性、未来扩展性如何保障。

分析结论:

a. 使用场景是多个参数一起设置。一致性校验下发天然是多参数联动:使能开关、Period、Rate、DelayToStart、镜像组/校验组自动修复开关,需要一次请求整体生效。

b. 属性监听方案不可行,理由有三:

  • 多次 RAID 卡通信:逐属性监听逐个下发,每个属性变更都触发一次 BMC 到 RAID 卡的带外通信。一次完整配置(使能+周期+速率+两组自动修复开关)要拆成 5 次以上 IPMI/带外交互,既拉长总时延,也放大了中间任意一次失败导致配置半途而废的风险;字典方法一次调用即完成一次带外交互,全部参数同步落到 RAID 卡。
  • 非法中间状态与时序问题:会出现“Enable 开关还是关、用户却要开启自动修复”的非法状态——只有使能了一致性校验,才允许使能自动修复;且北向各属性到达顺序不确定,逐属性监听回调各自独立下发,无法原子生效,后端可能按不完整中间态执行。
  • 扩展性:一致性校验是客户容易提特殊要求的特性,属性方案每加一个参数都要新增属性、变更北向 Schema 和渲染逻辑;字典方案扩展只需增加 key,方法签名不变化。

c. 最终结论:放弃“属性可写+监听变更”方案,把 EnableV2 和 SetParametersV2 的入参改为字典(Dictionary)实现:多个参数一次下发、一次带外通信、原子生效,后端统一校验前置依赖,规避时序问题和非法中间状态,并为后续扩展预留空间。