产品分类说明及其注意事项
不同产品支持的命令集合可能存在差异,即同一条命令非以上所有机型均支持。
【注意事项】子系统命名和划分
| 子系统中文名称 | 英文名称 | 备注 |
|---|---|---|
| 融合运维子系统 | om | 1、interface,包含北向接口(含web) 2、om,运维系统,在BMC领域的运维管理 |
| 多样硬件子系统 | hardware | hardware,硬件管理 |
| 能效管理子系统 | energy | energy,不呈现动词 |
| RAS故障管理子系统 | ras | ras,业界专用缩写,完整呈现故障管理领域功能 |
| 安全韧性子系统 | security | security,安全相关APP |
| 平台功能子系统 | bmc_core | bmc_core,BMC软件的基础核心功能 |
| 基础框架子系统 | framework | framework,与业务无关的纯软件框架 |
【注意事项】openUBMC四段式版本号规则
BMC四段式版本号定义规则:
- 第1段固定为1字节,范围是3-9;
- 后3段固定为2字节,范围为00-99,不允许省略前缀0。(IPMI接口查询版本号返回时,将4段式直接按照十六进制解读后返回,比如99解读为0x99,命令ipmitool raw 0x2C 0x2F 0x00 0x00 0x01)
【注意事项】接口申报责任人
总体原则:
1、由BMC软件实现的IPMI命令,优先由BMC侧申报议题评审。
2、由IMU软件实现的IPMI命令,优先由IMU侧申报议题评审。
例外场景:有一些特性,确实是某个领域看的比较全,或者是对应需求发起方,就让对应领域的责任人申报议题一起评审。
【注意事项】接口修改流程
步骤1、 “开发人员”获取最新的接口文档。
步骤2、 “开发人员”基于最新的文档,刷新修改或新增接口,并通过组内的SE审核(审核维度:接口完整性、接口需求满足度)。
步骤3、 “开发人员”找“接口文档看护SE”审核(审核维度:接口的合理性、通用性、兼容性),审核通过后提交SubPC评审。
步骤4、 SubPC评审通过后,“开发人员”将修改点和评审纪要邮件通知“接口文档看护SE”刷新。
【注意事项】IPMI接口修改常见问题checklist
1、设置、查询的内容,需要增加长度字段,如果超长内容,需要考虑分段读写。
2、不要漏了步骤4“SubPC评审通过后,“开发人员”将修改点和评审纪要邮件通知“接口文档看护SE”刷新”,测试会基于对外IPMI接口文档来验收,不更新对外IPMI文档,测试提单跟踪。
3、命令字定义,要避免与已有的IPMI冲突。
4、复用老版本命令,必须要考虑BMC全场景的兼容性,包括不限于:新老板、周边组件、工具、生产装备、现网场景等。
5、接口修改需要必须写清楚“修订记录”,包括:openUBMC软件版本、修改背景、时间、修改人。
6、IPMI命令若是特定机型专用命令,需要在“适用机型”中明确具体机型。
7、IPMI命令“使用实例”需要准确、可执行。