【已评审】IPMI新增查询、清除带内部件信息收集完成标志的参数

背景

生产装备阶段需要通过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 响应数据,详见整机信息参数表

评审结论

同意新增“查询带内部件信息收集状态”参数、“清除带内部件信息收集状态”参数,详细参数信息详见上方描述

遗留问题