评审背景
支持storage组件打印硬盘私有信息
支持日志记录网卡的基本信息
背景
通过获取运行时关键信息可以提升问题快速定位的能力，需要新增资源协作接口实现
决策点
决策点1
新增资源协作接口支持debug版本中触发网卡日志转储
决策点2
新增资源协作接口支持release版本中查看硬盘状态详细信息
详细说明
决策点1
资源path:“bmc/kepler/Debug/Systems/NetworkAdaptersDebug”
资源interface:bmc.kepler.Debug.Systems.NetworkAdapters
变化类型：新增路径，新增接口，新增方法
应用场景：提供一种手动触发网卡日志转储的方式
| 方法名称 | 变化类型 | 请求签名 | 请求参数说明 | 响应签名 | 响应参数说明 | 访问权限 | 说明 | 约束 |
|---|---|---|---|---|---|---|---|---|
| Dump | 新增方法 | 无 | 无 | 无 | 无 | SecurityMgmt | 将网卡信息转储到日志文件; 路径：/var/log/netcard/netcard_info.txt |
仅用于日志转储 |
决策点2
资源path:“/bmc/kepler/Systems/:SystemId/Storage”
资源interface:bmc.kepler.Release.Storage.Drive
变化类型：新增方法
应用场景：提供一种获取硬盘实时运行数据的一种方式，用于维测能力提升
| 方法名称 | 变化类型 | 请求签名 | 请求参数说明 | 响应签名 | 响应参数说明 | 访问权限 | 说明 | 约束 |
|---|---|---|---|---|---|---|---|---|
| GetDriveDetails | 新增方法 | s | DriveName:“Disk0” or “*” 硬盘名称： 1.指定硬盘名称：获取指定硬盘实时运行数据 2.不指定名称："*"表示获取所有硬盘实时运行数据 |
a(a{ss}) | 硬盘对象及相关信息 | ReadOnly | 获取运行时硬盘对象及信息 | 无在位硬盘时，返回一个空表 |
命令名称: getdrivedetails <drivename>
命令描述: “Get the drive details.”
参数：DriveName
详细描述：“The name of drive.”
响应参数：
| 响应体key值 | 描述 |
|---|---|
| Name | 硬盘名称 |
| ActivationLed | 激活指示灯 |
| HddBackplaneStartSlot | 硬盘在硬盘背板上的起始槽位 |
| RelativeSlot | 相对于起始槽位的偏移位置 |
| LinkFault | 硬盘链接故障状态 |
| CommandTimeoutTimes | raid卡和硬盘IO超时的次数 |
| UnexpectedSenseTimes | raid卡和硬盘交互时产生非预期错误的次数 |
评审结论
1、同意新增如下资源协作路径、接口和方法
path： bmc/kepler/Debug/Systems/NetworkAdaptersDebug
inteface：bmc.kepler.Debug.Systems.NetworkAdapters
方法：Dump，请求签名无，响应签名无，权限SecurityMgmt
2、同意在资源协作路径/bmc/kepler/Systems/:SystemId/Storage下新增接口和方法：
inteface：bmc.kepler.Release.Storage.Drive
方法：GetDriveDetails，请求签名s； DriveName:“Disk0” or “*”
硬盘名称：
1.指定硬盘名称：获取指定硬盘实时运行数据
2.不指定名称："*"表示获取所有硬盘实时运行数据；
响应签名a(a{ss})（硬盘对象及相关信息）具体信息如下：
| 响应体key值 | 描述 |
|---|---|
| Name | 硬盘名称 |
| ActivationLed | 激活指示灯 |
| HddBackplaneStartSlot | 硬盘在硬盘背板上的起始槽位 |
| RelativeSlot | 相对于起始槽位的偏移位置 |
| LinkFault | 硬盘链接故障状态 |
| CommandTimeoutTimes | raid卡和硬盘IO超时的次数 |
| UnexpectedSenseTimes | raid卡和硬盘交互时产生非预期错误的次数 |
遗留问题：
无
