背景
(必选)从最终用户视角阐述当前有什么问题,包含问题的场景、影响点,以及当前系统的差距。(提交议题时删除此引导说明)
关联ISSUE
(可选)此议题关联的代码仓的issue链接。(提交议题时删除此引导说明)
整体方案
(可选)简要描述此议题关联的整体方案,包括但不限于逻辑架构、组件依赖关系、交互上下文。(提交议题时删除此引导说明)
评审点
(必选)一句话概括描述待评审的内容。(提交议题时删除此引导说明)
详细描述
评审点1:IPMI 新增 XXX 命令
【必填】文字描述评审点的命令详细信息,对于 蓝色斜体 部分字体自行根据评审的诉求进行替换(替换时连同格式一起替换,替换之后保持正文格式,不需要保留样式)
命令名称: XXX
命令说明: 命令的主要功能以及使用约束(如仅带内BT通道访问等)
命令权限: ReadOnly
是否锁定之后可以访问: 是/否
是否有敏感数据: 是/否
命令样式: 使用 ipmitool 说明命令的请求样式,参数使用大驼峰。举例如下(正式评审中按需替换示例):
- 请求:
ipmitool raw 0x30 0x90 <ManufacturerID> <SubCmd> <Length> <Data> - 响应:
<ManufacturerID> <Result>
命令请求参数: 按照命令样式(请求)中的参数和顺序依次说明参数。举例如下(正式评审中按需替换示例):
| 字节顺序 | 域取值说明 |
|---|---|
| NetFn | 30 h |
| Cmd | 9 0h |
| 1:3 | Manufacturer ID,LB Byte first。长度固定 3 个字节,例如,某厂家ID时 2011,对应十六进制为0x0007DB,则字节序为第1个字节为 DBh,第二个字节为 07h,第三个字节为 00h。 |
| 4 | SubCmd ,固定为 7 8h |
| 5 | Le ngth, 命令 长度 |
| 6:N | Data,测试配置数据 |
命令响应参数: 按照命令样式(响应)中的参数和顺序依次说明参数。举例如下( 正式评审中按需替换示例):
| 字节顺序 | 域取值说明 |
|---|---|
| 1 | Completion Code,所有的完成码则需要单独和详细说明,比如: 00h = 【标准完成码】命令响应成功 CCh = 【标准完成码】命令入参超过支持范围 80h = 【非标完成码】命令的长度和参数不匹配 81h = 【非 标完成码】命令的 参数无法支持 |
| 2:4 | Manufacturer ID,LB Byte first。长度固定 3 个字节,例如,某厂家ID时 2011,对应十六进制为0x0007DB,则字节序为第1个字节为 DBh,第二个字节为 07h,第 三个字节为 00h。 |
| 5 | Result ,下发结果,取值如下: 00h = 命令下 发成功 01h = 命令下发失败 |
命令示例: 使用 ipmitool 说明命令的示例,示例需要明确命令的参数和使用方法(注意敏感数据进行脱敏处理)。举例如下(正式评审中按需替换示例):
样例1: 设置 DDR 的测试配置为 [255 255 255 255]
- 请求:
ipmitool raw 0x30 0x90 0xdb 0x07 0x00 0x78 0x04 0xff 0xff 0xff 0xff - 响应:
db 07 00 00
评审点2:新增 XX Oem资源 (XX举例:hwBootCertificates)
资源URI:该OEM资源的完整访问路径,必须位于OEM扩展路径下,示例:/redfish/v1/Systems/{ComputerSystemId}/Bios/Oem/openUBMC/BootCertificates
资源版本:自定义资源定义版本,必须与实现的属性和行为严格对应,示例:hwBootCertificates.v1_0_0
嵌套资源:明确声明该资源在数据模型中直接被包含于哪个父资源之下,示例: 本资源(hwBootCertificates )嵌套于 Bios 资源的 Oem/openUBMC/BootCertificates 属性中
Link资源: 确定并声明与此资源存在逻辑关联、需要通过 Links 对象进行链接的其他资源。可从以下维度分析确定:
功能管理归属: 分析谁在功能上 “拥有”、“管理”或“控制” 此资源。通常需链接到其管理主体(如 ComputerSystem , Manager )。若标准链接不满足需求,可考虑通过Links下的 Oem 属性扩展。逻辑引用依赖: 分析哪些其他资源在逻辑上需要知晓或引用 此资源的存在以完成其自身功能(如 Volume 引用其所属的 StoragePool )。若标准链接不满足需求,可考虑通过Links下的 Oem 属性扩展。鼓励在OEM资源内部提供标准 Links 属性,指向其关联的标准资源,以增强可发现性。
属性列表:
注1 :下表隐去Redfish规范强制要求的通用基础属性(如@odata.id 、@odata.type 、Id 、Name ,集合资源还包括:Members、Members@odata.count),默认均需实现。
注2 :列表内属性默认均支持GET 操作。
注3 :OEM资源下的所有属性均视为该厂商的扩展属性,其定义应直接位于资源下,避免 再额外增加一层 Oem 对象嵌套。
| 属性名 | 类型 | 示例/取值约束 | readonly | 易变属性 | 实现PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
Certificates |
object |
{"@odata.id": " /redfish/v1/Systems/{ComputerSystemId}/Bios/Oem/openUBMC/BootCertificates/Certificates"} |
/ |
/ |
/ |
/ |
此属性包含指向 CertificateCollection 资源集合的链接 |
Schema定义: 所有OEM资源必须提供其独立的Schema定义文件,该文件在格式、语法和结构上须与官方Redfish Schema文件保持一致。
是否准备好AI预审
(必选)是/否
评审结论
(必选)针对决策点,详细描述最终结论,不能是简单的同意或不同意,通过或不通过。(提交议题时删除此引导说明)
正面示例:
同意redfish接口/redfish/v1/XXXXX的GET操作响应体增加如下属性
(详细描述属性名称、属性取值类型、取值范围、约束等)
或
不同意新增资源协作接口XXXXX
或
不同意资源协作接口XXX新增XX属性/方法
反面示例:
通过,同意新增接口
遗留问题
(可选)列出评审会议现场无法直接给出明确结论的事务,会后确认清楚之后要在此处录入明确的结论,如不涉及,则可以写无或删除此部分。参考格式如下:(提交议题时删除此引导说明)
1、需要确认XXX
结论: