【已评审】ConfigurationModel和客户Redfish规范版本配套资源树与定制化方案评审

关联issue

redfish System资源支持ConfigurationModel属性
bmc.kepler.Systems.Product.Custom新增CustomerRedfishVersion属性
支持客户redfish规范版本定制化与导入导出

背景

客户的redfish接口规范要求在/redfish/v1/Systems/{Systemid}下支持查询和设置客户采购的硬件配置型号(ConfigurationModel),支持查询客户Redfish规范版本

决策点

决策点1:客户采购的硬件配置型号(ConfigurationModel)出厂定制化方案
决策点2:客户Redfish规范版本出厂定制化方案
决策点3:新增资源树接口属性支持查询客户Redfish规范版本

详细描述

决策点1:客户采购的硬件配置型号(ConfigurationModel)出厂定制化方案

方案一:保持现有能力不变更,使用已有的定制项BMCSet_PackageCustomerVersion

方案二:新增资源协作接口属性ConfigurationModel与定制项BMCSet_ComSysConfigurationModel

资源path: /bmc/kepler/Systems/${SystemId}/Product
资源interface: bmc.kepler.Systems.Product.Custom
变化类型:新增属性
应用场景:定制化时配置属性值,通过redfish接口获取属性值
持久化类型: 掉电持久化 操作权限:BasicSetting/ReadOnly
详细描述:

属性名称 变化类型 签名 读写&权限 持久化 变化通知 接口说明 接口约束
ConfigurationModel 新增属性 s R:ReadOnly W:BasicSetting 掉电持久化 true 客户采购的硬件配置型号 默认为空字符串

定制化项/配置项名称: BMCSet_ComSysConfigurationModel
应用场景:定制化配置模型名称

定制化项名称(中文) 定制化项 归属组件 取值说明 默认值 处理逻辑(伪代码) 说明 实现方式(配置文件导入、IPMI命令)
硬件配置型号 BMCSet_ComSysConfigurationModel Product_mgmt 字符串 空字符串 if(BMCSet_ComSysConfigurationModel != ‘’):
设置硬件配置型号为BMCSet_ComSysConfigurationModel的值
else:
设置硬件配置型号为空字符串
出厂定制客户采购的硬件配置型号 配置文件导入

决策点2:客户Redfish规范版本出厂定制化方案


定制化项/配置项名称: BMCSet_CustomerRedfishVersion
应用场景:定制化客户Redfish规范版本
定制化项名称(中文) 定制化项 归属组件 取值说明 默认值 处理逻辑(伪代码) 说明 实现方式(配置文件导入、IPMI命令)
客户Redfish规范版本 BMCSet_CustomerRedfishVersion Product_mgmt 字符串 空字符串 if(BMCSet_CustomerRedfishVersion != ‘’):
设置客户Redfish规范版本为CustomerRedfishVersion的值
else:
设置客户Redfish规范版本为空字符串
定制客户redfish规范版本 配置文件导入

决策点3:新增资源树接口属性支持查询客户Redfish规范版本

资源path: /bmc/kepler/Systems/${SystemId}/Product
资源interface: bmc.kepler.Systems.Product.Custom
变化类型:新增属性
应用场景:1、出厂定制化时配置;2、通过redfish接口查询
持久化类型: 掉电持久化
操作权限:BasicSetting/ReadOnly
详细描述:

属性名称 变化类型 签名 读写&权限 持久化 变化通知 接口说明 接口约束
CustomerRedfishVersion 新增属性 s R:ReadOnly W:BasicSetting 掉电持久化 true 客户Redfish规范版本 默认为空字符串

评审结论

决策点1:redfish属性ConfigurationModel 对应的定制化方案评审

采用方案一:使用当前已有的定制项BMCSet_PackageCustomerVersion,不新增定制项与接口

决策点2:客户Redfish规范版本出厂定制化方案评审

1、同意新增定制项BMCSet_CustomerRedfishVersion,默认值为空字符串,最大长度为128。
2、增加配置导入导出项CustomerRedfishVersion

配置项名称(中文) 配置项类别 配置项 归属组件 取值说明 默认值 导入导出类型(ExportOnly,ImportAndExport) 导出后是否可直接导入(无修改)
客户redfish规范版本 BMC CustomerRedfishVersion Product_mgmt 字符串 空字符串 ImportAndExport

决策点3:新增资源树接口属性支持查询客户Redfish规范版本

同意在bmc.kepler.Systems.Product.Custom接口新增属性CustomerRedfishVersion,签名s,最大长度为128,掉电持久化,需要发送变更通知事件