【已评审】资源协作接口新增属性用于支持传感器显示在机箱前后位置的硬盘的最大温度

Interface SIG Interface评审
1

关联issue

支持扩展硬盘温度传感器

背景

  • 为了支持硬盘温度传感器的扩展，即需要支持显示前置背板，后置背板的NVMe SSD盘最大温度，Hdd硬盘最大温度，目前业务场景无法支持该扩展，需要在资源协作接口新增属性。

  • 传感器名称需要体现出硬盘所属硬盘背板位置，当前硬盘对象相关属性无法满足该需要，因此需要在资源协作接口新增表征硬盘位置的属性。

决策点

决策点1： 资源协作接口需要新增属性FrontNVMeSSDMaxTemperatureCelsius, FrontHddMaxTemperatureCelsius, RearNVMeSSDMaxTemperatureCelsius, RearHddMaxTemperatureCelsius

决策点2： 资源协作接口需要新增属性ContainerPhysicalContext

详细说明

决策点1

资源树路径： /bmc/kepler/Systems/:SystemId/CoolingConfig
资源树接口： bmc.kepler.Systems.DiskCoolingConfig
新增属性： FrontNVMeSSDMaxTemperatureCelsius , FrontHddMaxTemperatureCelsius, RearNVMeSSDMaxTemperatureCelsius, RearHddMaxTemperatureCelsius

属性名称 变化类型 签名 读写&权限 持久化 变化通知 属性说明 接口约束
FrontNVMeSSDMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W: 无
不持久化 true 前置NVMe SSD盘最大温度,单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0
FrontHddMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W:无
不持久化 true 前置Hdd盘最大温度，单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0
RearNVMeSSDMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W:无
不持久化 true 后置NVMe SSD盘最大温度，单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0
RearHddMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W:无
不持久化 true 后置Hdd盘最大温度 ，单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0

决策点2

资源树路径：/bmc/kepler/Systems/:SystemId/Storage/Drives/:Id
资源树接口： bmc.kepler.Systems.Storage.Drive
新增属性： ContainerPhysicalContext

属性名称 变化类型 签名 读写&权限 持久化 变化通知 属性说明 接口约束
ContainerPhysicalContext 新增属性 s 只读
R: ReadOnly

W:无
不持久化 false 硬盘所在背板在机箱相对位置
“Front”表示在前部

“Inner”表示在中部

“Rear”表示在后部
""表示未配置
默认值为空字符串

评审结论

1、同意资源协作接口bmc.kepler.Systems.DiskCoolingConfig新增如下属性：

属性名称 变化类型 签名 读写&权限 持久化 变化通知 属性说明 接口约束
FrontNVMeSSDMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W: 无
不持久化 true 前置NVMe SSD盘最大温度,单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0
FrontHddMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W:无
不持久化 true 前置Hdd盘最大温度，单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0
RearNVMeSSDMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W:无
不持久化 true 后置NVMe SSD盘最大温度，单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0
RearHddMaxTemperatureCelsius 新增属性 d 只读
R: ReadOnly

W:无
不持久化 true 后置Hdd盘最大温度 ，单位：摄氏度 无效值：32768表示无可进行温度最大值计算的对象； 有效值范围：不等于0

2、同意资源协作接口bmc.kepler.Systems.Storage.Drive新增如下属性

属性名称 变化类型 签名 读写&权限 持久化 变化通知 属性说明 接口约束
ContainerPhysicalContext 新增属性 s 只读
R: ReadOnly

W:无
不持久化 false 硬盘所在背板在机箱相对位置
"Front"表示在机箱前部
"Inner"代表在机箱中部
"Rear"表示在机箱后部
""表示未配置
默认值为空字符串

遗留问题及确认结论

无

2

1、决策点遗漏第二个决策点，并请把评审的决策点拆分开，使用编号；
2、决策点一：
属性名更新为
FrontNvmeMaxTemperature, FrontHddMaxTemperature, ReaNvmeMaxTemperature, RearHddMaxTemperature
属性说明请描述清楚，给个参考：前置Nvme硬盘的最大温度, 单位:摄氏度
3、决策点二：Position改为String，并详细描述属性说明

3

1,2 两点已做修改，第3点对于Position属性，由于要在csr里面进行运算，不推荐采用字符串的形式