功能简介 ​

固件管理为BMC基本功能特性，客户使用场景中主要涉及固件升级、固件生效、固件信息查询、固件回滚等。

关键特性 ​

1 基本功能 ​

1.1 固件升级 ​

固件升级是客户使用过程中常见场景，如对BMC、BIOS、CPLD等固件进行升级。此功能使用频率较高。当前固件管理提供了串行升级和并行升级两种升级方式，功能上包括本地升级和远程升级。

• 本地升级：固件升级包已存在于BMC本地文件系统（位于 /tmp 目录下），升级时直接从本地路径读取固件包进行升级。

• 远程升级：固件升级包存储在远程服务器上，BMC通过网络协议（如FTP、TFTP、HTTP、NFS、SCP等）下载固件包到本地后再进行升级。适用于固件包存储在远程服务器，需要通过网络传输获取的场景。

1.2 固件生效 ​

当前固件生效存在两种生效方式，一种是被动生效，一种是主动生效。 被动生效为固件管理模块检测到生效条件满足后自动触发生效任务，主动生效为客户通过BMC界面进行生效操作。 当前较危险的生效动作，如BMC升级后重启或者CPLD生效后进行掉电处理，此类操作可能会影响固件之间的生效，导致异常情况，因此由固件管理统一管理。

1.3 固件信息查询 ​

当客户需要查询当前系统的固件信息时，如各固件的名称、类型、版本、发布时间等基本信息，此特性可以提供对所有固件信息进行统一管理，方便查询。

1.4 镜像回滚 ​

当客户需要回滚到之前的固件版本时，此特性可以提供回滚操作，如BMC主备分区倒换功能。

资源协作接口 ​

bmc.kepler.UpdateService ​

path:/bmc/kepler/UpdateService properties

methods

• ParallelUpgradePackages详细说明

• UpdateProgress详细说明

• PendingFirmware详细说明

signals

bmc.kepler.UpdateService.FirmwareActive ​

path:/bmc/kepler/UpdateService/FirmwareActive methods

signals

bmc.kepler.UpdateService.FirmwareActiveInfo ​

path:/bmc/kepler/UpdateService/FirmwareActive/:Id properties

此接口内容通常是通过bmc.kepler.UpdateService.FirmwareActive下RegisterActiveAction方法添加 添加案例：

local param = {}
param[#param+1] = {Key = 'FirmwareId', Value = 'CPLD'}
param[#param+1] = {Key = 'FirmwareType', Value = 'CPLD'}
param[#param+1] = {Key = 'ActiveCondition', Value = active_condition}
param[#param+1] = {Key = 'ActiveMode', Value = active_mode}
param[#param+1] = {Key = 'ActiveStatus', Value = active_status}

client:FirmwareActiveFirmwareActiveRegisterActiveAction(context.new(), param)

添加成功后，firmware_mgmt 存在关键日志：register: FirmwareId = xxx ......

bmc.kepler.UpdateService.FirmwareInventory ​

path:/bmc/kepler/UpdateService/FirmwareInventory

methods

• FirmwareInfoItem详细说明

bmc.kepler.UpdateService.FirmwareInfo ​

path:/bmc/kepler/UpdateService/FirmwareInventory/:Id

properties

此接口通常是通过 bmc.kepler.UpdateService.FirmwareInventory 下 Add 方法添加 添加案例：

local FWINVENTORY_PATH  = '/bmc/kepler/UpdateService/FirmwareInventory/'
local FIRMWARE_INFO_INTERFACE = 'bmc.kepler.UpdateService.FirmwareInfo'

...

local obj = mdb.get_object(bus, FWINVENTORY_PATH, FIRMWARE_INFO_INTERFACE)
local param = {
    Id = id,
    Name = name,
    Version = version,
    BuildNum = build_num or '',
    ReleaseDate = release_date or '',
    LowestSupportedVersion = lowest_supported_version or '',
    SoftwareId = software_id or '',
    Manufacturer = manufacturer or '',
    Location = location or '',
    State = state or 'Enabled',
    Severity = severity or 'Informational'
}
obj:Add(context.new(), param, true, 1, 90)
...

添加成功后，firmware_mgmt 存在关键日志：Add firmware inventory successfully, Id:xxx, ...... 如果添加失败，常见原因：

• 固件名称重复，添加失败，关键日志：Already exist the same Id:[xxx] to path xxx

• 固件信息参数不正确，方法调用失败。Add方法的FirmwareInfoTable签名为a{ss}，因此通过FirmwareInfoTable传参给 firmware_mgmt 需要保证内容为字符串（firmware_mgmt 会将字符串转换为资源协作接口定义的类型）

CSR配置介绍 ​

FirmwareComponentInfo对象配置介绍 ​

此对象用于配置允许升级的固件，由ComponentID与ComponentIDEx确定唯一的固件，Name用于描述固件的名称

ActiveComponentInfo对象配置介绍 ​

此对象用于配置允许生效的固件名称

MutuallyExclusiveFirmwares对象配置介绍 ​

此对象用于配置禁止固件同时升级的互斥关系，Id的构成方式为ComponentID与ComponentIDEx的组合的U64类型转换成字符串，其中ComponentID占高四字节，举例："0x0000000505000001"

高频常见问题与关键日志介绍 ​

场景：社区包与原始包互相升级场景

关键日志：verify signature error, code xxxxxxxxx 常见验签失败code及原因介绍。

关键日志：88200004: 证书发布者不存在。该code出现原因是升级包签名与根证书不对应。处理方法：换用正确的根证书重新签名升级包。

关键日志：add pss root certificate failed,code ffffffffffffffff: 此处常见原因为：由于社区的hpm包为不签名不加密方案，当环境上为社区包时，因此直接升级原始包会上报添加根证书失败。

关键日志：rsa_decrypt failed 该问题出现场景一般是因为环境上为原始hpm包，但是升级的包为签名+不加密的hpm包（出包有误），因此升级包解密失败。处理方案：重新出包 manifest仓库的.bmcgo/config若存在配置[hpm_encrypt]且enable=false，或者不存在[hpm_encrypt]配置，则表示该包为不加密包。

关键日志：secure_tar_unzip failed: -3003 此关键日志与rsa_decrypt failed原因有类似之处。此日志出现场景一般是环境上为社区hpm包，但是升级的包已加密，即[hpm_encrypt]下enable=true。处理方案：重新出包