产品分类说明及其注意事项

不同产品支持的命令集合可能存在差异,即同一条命令非以上所有机型均支持。

【注意事项】子系统命名和划分

子系统中文名称英文名称备注
融合运维子系统om1、interface,包含北向接口(含web)
2、om,运维系统,在BMC领域的运维管理
多样硬件子系统hardwarehardware,硬件管理
能效管理子系统energyenergy,不呈现动词
RAS故障管理子系统rasras,业界专用缩写,完整呈现故障管理领域功能
安全韧性子系统securitysecurity,安全相关APP
平台功能子系统bmc_corebmc_core,BMC软件的基础核心功能
基础框架子系统frameworkframework,与业务无关的纯软件框架

【注意事项】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命令“使用实例”需要准确、可执行。