背景
生产装备阶段需要通过IPMI命令启动、停止整机部件信息收集,或查询整机部件信息收集状态信息。部分用户受自身装备流程限制,提出当带内完成部件收集后,记录收集完成标志,从而避免重复触发SP收集。
因此需要在带内部件信息采集成功后,在BMC侧设置复位持久化的带内部件信息完成标志。并提供ipmi命令进行查询、清除该标志。
评审点
评审点1:IPMI 收集整机信息命令扩展参数(新增带内部件信息收集状态查询、清除参数)
命令名称: Collect Server Information(已有命令)
命令说明: 收集整机信息
命令权限: ReadWrite
是否锁定之后可以访问: 是
是否有敏感数据: 否
命令样式:
- 请求:
ipmitool raw 0x30 0x93 <ManufacturerID> <SubCmd> <ParameterSelector> <Offset> <Length> <Data> - 响应:
<ManufacturerID> <EndOfList> <Data>
| 字节顺序 | 域取值说明 |
|---|---|
| NetFn | 30h |
| Cmd | 93h |
| 1:3 | Manufacturer ID,LB Byte first。长度固定 3 个字节 例如,某厂家ID时 2011,对应十六进制为0x0007DB,则字节序为: 第一个字节为 DBh 第二个字节为 07h 第三个字节为 00h |
| 4 | SubCmd,固定为 8Ah |
| 5 | Parameter Selector,详见整机信息参数表 |
| 6 | Offset, 数据偏移 |
| 7 | Length,读取或写入数据长度 |
| 8:N | Data,写入数据 |
整机信息参数表:
| 功能描述 | Parameter Data | #(10进制) |
|---|---|---|
| 启动或停止收集整机部件信息(write-only) | 请求: Offset: 0x00 Length: 1 Data: 0(停止),1(启动) 响应: End of List:0 Data:无 |
0 |
| 查询整机部件信息收集状态(read-only) | 请求: Offset: 0x00 Length: 0 Data:无 响应: End of List:0 Data: 0:未启动收集、1:正在收集、2:收集完成、3:收集失败 |
1 |
| (本次新增)查询带内部件信息收集状态(read-only) | 请求: Offset: 0x00 Length: 0 Data:无 响应: End of List:0 Data: 0:未收集带内部件信息、1:已收集带内部件信息 |
2 |
| (本次新增)清除带内部件信息收集状态(write-only) | 请求: Offset: 0x00 Length: 0 Data:无 响应: End of List:0 Data:无 |
3 |
说明:带内部件信息收集状态标志会复位持久化
命令响应参数:
| 字节顺序 | 域取值说明 |
|---|---|
| 1 | Completion Code,命令完成码 |
| 2:4 | Manufacturer ID,LB Byte first。长度固定 3 个字节 例如,某厂家ID时 2011,对应十六进制为0x0007DB,则字节序为: 第一个字节为 DBh 第二个字节为 07h 第三个字节为 00h |
| 5 | End of List 表示当前数据是否结束。当参数数据比较长的时候,可能需要分多次读取,通过此字段可以判断数据是否读完。 [7:1]:reserved. [0]:End of list 0=last data. 1=middle data |
| 6:N | Data 响应数据,详见整机信息参数表 |
评审结论
同意新增“查询带内部件信息收集状态”参数、“清除带内部件信息收集状态”参数,详细参数信息详见上方描述
遗留问题
无