【已评审】支持硬盘诊断功能控制的资源协作接口及装备定制化评审

关联issue

支持硬盘诊断功能控制

评审背景

  • BMC带外硬盘日志自动收集可能会影响客户带内的性能(跟具体的硬盘有关,有的盘会出现IO跌零现象),客户希望改成手动控制,因此需要支持通过BMC接口查询和设置硬盘诊断功能的状态,包括日志收集等。

评审点

  • 资源协作接口新增属性LogAutoCollectEnable、LogAutoCollectInterval,新增方法StartCollectLog
  • 新增装备定制化接口设置硬盘日志自动收集开启状态和周期

1、资源协作接口新增属性及方法

评审点: 是否新增属性LogAutoCollectEnable、LogAutoCollectInterval,是否新增方法StartCollectLog
资源协作接口路径: /bmc/kepler/Systems/:SystemId/Storage/Drives
资源协作接口: bmc.kepler.Systems.Storage.Drives
新增属性:

属性名称 变化类型 签名 读写&权限 持久化 变化通知 属性说明 接口约束
LogAutoCollectEnable 新增属性 b R ReadOnly W:BasicSetting 掉电持久化 false 硬盘日志自动收集开启状态
LogAutoCollectInterval 新增属性 y R ReadOnly W:BasicSetting 掉电持久化 false 硬盘日志自动收集周期,单位:小时

新增方法:

方法名称 变化类型 入参签名 入参说明 权限 方法说明 接口约束
StartCollectLog 新增方法 s 请求参数: “DriveName” : “Disk0” or “*”
硬盘名称:
1、指定硬盘名称:收集指定硬盘日志
2、不指定硬盘名称:“*” 表示收集所有硬盘日志
BasicSetting 手动触发硬盘日志收集功能(区分单盘或所有盘)

评审结论:
同意资源协作接口bmc.kepler.Systems.Storage.Drives新增如下属性和方法

  • 新增属性LogAutoCollectEnable:硬盘日志自动收集开启状态,签名为b,读权限:ReadOnly,写权限:BasicSetting,不发送变更通知事件
  • 新增属性LogAutoCollectInterval:硬盘日志自动收集周期,签名为y,读权限:ReadOnly,写权限:BasicSetting,不发送变更通知事件
  • 新增方法StartCollectLog:手动触发硬盘日志收集,请求签名:s,响应签名:无,权限:BasicSetting

2、新增装备定制化项

新增定制化项,用于定制是否开启硬盘日志自动收集和硬盘日志收集周期,具体的定制化项信息如下:

项目
定制化项 硬盘日志自动收集开启状态
定制化接口名称 BMCSet_DrivesLogAutoCollectEnable
默认值 1
处理逻辑 1、不配置导入此值时,默认开启硬盘日志收集;
2、配置导入此值时,处理逻辑如下:
if(BMCSet_DrivesLogAutoCollectEnable == 0)
 关闭硬盘日志自动收集
else
  开启硬盘日志自动收集
说明 取值范围:
0:关闭硬盘日志自动收集
1:开启硬盘日志自动收集
项目
定制化项 硬盘日志自动收集周期
定制化接口名称 BMCSet_DrivesLogCollectInterval
默认值 24(小时)
处理逻辑 1、不配置导入此值时,日志收集周期为24小时;
2、日志收集周期以配置导入的BMCSet_DrivesLogAutoCollectInterval的值为准;
约束 1、取值范围:1 - 255(小时)
2、超过上述范围装备定制化将报失败;

评审结论:
同意新增装备定制化项BMCSet_DrivesLogCollectInterval,表示硬盘日志自动收集周期,取值范围1~255,单位:小时

1 个赞