背景
带内的硬盘管理需要通过 IPMI 接口对慢盘检测功能进行配置和查询，需要 BMC 侧支持 SSD 慢盘检测开关及参数配置和查询 IPMI 接口
关联ISSUE
暂无
整体方案
扩展获取存储配置(3Dh)和设置存储配置(3Eh)的IPMI接口
评审点
对已有IPMI命令扩展命令字，获取和设置SSD慢盘检测相关配置，Parameter Selector新增0x19
详细描述
获取存储配置(NetFn：30h，CMD：93h，Sub Command：3Dh)
privilege：ReadOnly
role：User
priority：Default
①. 请求参数说明
| 字节顺序 | 域内容 |
|---|---|
| NetFn | 30h |
| CMD | 93h |
| 1:3 | Manufacturer ID |
| 4 | Sub Command，子命令=3Dh |
| 5 | NA，预留 |
| 6 | Parameter Selector，新增操作类型：获取SSD慢盘检测相关属性(19h) |
| 7 | Set Selector： 0- 获取NVME SSD慢盘检测参数配置 1- 获取SAS SSD慢盘检测参数配置 |
| 8 | Block Selector，不涉及，填0xFF |
| 9 | Extern Selector，不涉及，填0xFF |
| 10: 11 | Reading offset，获取参数的偏移 |
| 12 | Reading length，获取参数的长度 |
②. 响应参数说明：
| 字节顺序 | 域内容 |
|---|---|
| 1 | Completion Code |
| 2：4 | Manufacturer ID |
| 5 | Frame type，不涉及，默认返回0 |
| 6：N | Data： 请求参数 Set Selector 为0时， data1：NVME慢盘检测使能开关状态, 0-不使能，1-使能 data2:3：NVME平均响应时延阈值，单位为ms，小端字节序 data4：NVME平均时延超过门限的次数 data5：NVME准慢盘的平均响应时延同硬盘域内的倍数 data6:7：NVME准慢盘的标准平均响应时延，单位ms，小端字节序 请求参数 Set Selector 为1时， data1：SAS慢盘检测使能开关状态, 0-不使能，1-使能 data2:3：SAS平均响应时延阈值，单位为ms，小端字节序 data4：SAS平均时延超过门限的次数 data5：SAS准慢盘的平均响应时延同硬盘域内的倍数 data6:7：SAS准慢盘的标准平均响应时延，单位ms，小端字节序 |
③. 示例：
| 请求样例 | 描述 | 命令 |
|---|---|---|
| 1 | 查询NVME SSD硬盘慢盘检测相关配置 | ipmitool raw -C 17 0x30 0x93 0xdb 0x07 0x00 0x3D 0x00 0x19 0x00 0xFF 0xFF 0X00 0X00 0XFF |
| 2 | 查询SAS SSD硬盘慢盘检测相关配置 | ipmitool raw -C 17 0x30 0x93 0xdb 0x07 0x00 0x3D 0x00 0x19 0x01 0xFF 0xFF 0X00 0X00 0XFF |
设置存储配置(NetFn：30h，CMD：93h，Sub Command：3Eh)
privilege：BasicSetting
role：Operator
priority：Default
持久化类型：掉电持久化
①. 请求参数说明
| 字节顺序 | 域内容 |
|---|---|
| NetFn | 30h |
| CMD | 93h |
| 1:3 | Manufacturer ID |
| 4 | Sub Command，子命令=3Eh |
| 5 | NA |
| 6 | Parameter Selector， 新增操作类型：设置SSD慢盘检测相关参数(19h) |
| 7 | Set Selector： 0- NVME慢盘检测使能开关 1- SAS慢盘检测使能开关 2- NVME的慢盘检测参数配置 3- SAS的慢盘检测参数配置 |
| 8 | Block Selector，不涉及，填0xFF |
| 9 | Extern Selector，不涉及，填0xFF |
| 10 | Frame type，不涉及，默认填0 |
| 11: 12 | Writing Offset，不涉及，默认填0 |
| 13 | Writing Length， Parameter Data的长度 |
| 14:N | Parameter Data： 请求参数 Set Selector 为0时， data1：0-不使能；1-使能 请求参数 Set Selector 为1时， data1：0-不使能；1-使能 请求参数 Set Selector 为2时， data1:2：平均响应时延阈值，单位为ms，小端字节序 data3：平均时延超过门限的次数 data4：准慢盘的平均响应时延同硬盘域内的倍数 data5:6：准慢盘的标准平均响应时延，单位毫秒，小端字节序 请求参数 Set Selector 为3时， data1:2：平均响应时延阈值，单位为ms，小端字节 data3：平均时延超过门限的次数 data4：准慢盘的平均响应时延同硬盘域内的倍数 data5:6：准慢盘的标准平均响应时延，单位毫秒，小端字节序 |
②. 响应参数说明：
| 字节顺序 | 域内容 |
|---|---|
| 1 | Completion Code |
| 2:4 | Manufacturer ID |
| 5:8 | Reserved，默认返回0 |
③. 示例：
| 请求样例 | 描述 | 命令 |
|---|---|---|
| 1 | 设置SSD NVME硬盘慢盘检测特性功能开启 | ipmitool raw -C 17 0x30 0x93 0xdb 0x07 0x00 0x3E 0x00 0x19 0x00 0xFF 0xFF 0x00 0x00 0x00 0x01 0x01 |
| 2 | 设置SSD SAS硬盘慢盘检测特性功能开启 | ipmitool raw -C 17 0x30 0x93 0xdb 0x07 0x00 0x3E 0x00 0x19 0x01 0xFF 0xFF 0x00 0x00 0x00 0x01 0x01 |
| 3 | 设置SSD NVME硬盘慢盘检测参数配置 | ipmitool raw -C 17 0x30 0x93 0xdb 0x07 0x00 0x3E 0x00 0x19 0x02 0xFF 0xFF 0x00 0x00 0x00 0x06 0x05 0x00 0x01 0x0A 0x01 0x00 |
| 4 | 设置SSD SAS硬盘慢盘检测参数配置 | ipmitool raw -C 17 0x30 0x93 0xdb 0x07 0x00 0x3E 0x00 0x19 0x03 0xFF 0xFF 0x00 0x00 0x00 0x06 0x0A 0x00 0x01 0x0A 0x01 0x00 |
评审结论
1、同意在获取存储配置(NetFn：30h，CMD：93h，Sub Command：3Dh)的IPMI命令的Parameter Selector参数中新增参数取值25，表示获取SSD慢盘检测相关参数
2、同意在设置存储配置(NetFn：30h，CMD：93h，Sub Command：3Eh)的IPMI命令的Parameter Selector参数中新增参数取值25，表示设置SSD慢盘检测相关参数
遗留问题
1、获取SSD慢盘检测相关配置，使用Set Selector区分介质接口类型，获取参数
结论：已按照建议修改
2、设置SSD慢盘检测相关配置，在文档中说明参数配置取值范围
结论：命令实现后在接口文档中说明