1. 概述 ​

针对产品整机固件升级场景，为解决固件包数量多，固件下载效率低，版本配套管理困难问题，BMC提供产品级固件整包升级能力，避免运维人员由于误操作导致版本不匹配问题，同时提升整机升级效率。

2. 压缩包格式 ​

• 文件格式：zip
• 压缩包大小限制：
  • 压缩前：≤ 110 MB
  • 压缩后：≤ 150 MB
• 推荐压缩方式：
  • windows：7zip
  • linux：zip命令

3. 压缩包内容 ​

压缩包内应包含以下内容：

✅ 示例结构：

fullimage.zip
├── a.hpm
├── b.hpm
└── full_image_profile.json

⚠️ 注意：

• 仅允许包含 .hpm 和 full_image_profile.json 文件。
• 禁止包含其他无关文件（如 .txt, .log, .tmp 等）。
• 禁止包含隐藏文件或目录。

4. 文件命名规范 ​

5. full_image_profile.json 格式说明 ​

5.1 基本结构 ​

{
    "Packages": [
        {
            "Module": "CPLD_EXU",
            "FileName": "a.hpm",
            "Priority": 1
        },
        {
            "Module": "BMC",
            "FileName": "b.hpm",
            "Priority": 2
        }
    ]
}

5.2 字段说明 ​

✅ 优先级示例：

• Priority: 1 → 最高优先级，最先升级
• Priority: 16 → 最低优先级，最后升级

⚠️ 注意事项：

• 所有 Priority 必须为整数，非数字将导致解析失败。
• 若多个模块优先级相同，则它们同时执行并行升级。

6. 并行升级数量限制 ​

• 固件包中 .hpm 文件数量应不超过系统支持的并行升级最大数量（可CSR配置，默认为20个）。
• 超出数量将导致升级失败。
• 建议：使用 Packages 列表中 Priority 字段合理调度升级顺序。

7. 注意事项 ​

• 使用Redfish进行整包升级时，由于涉及远程升级，为保证接口响应时间，需要提前创建最大并行升级个数的子任务。在获取到具体固件后，再将子任务与对应固件匹配，多余的子任务状态标记为"exception"，多余子任务不影响主任务的升级状态及进度。

8. 接口使用说明 ​

8.1. Redfish接口升级 ​

• URL POST

https://<device_ip>/redfish/v1/UpdateService/Actions/Oem/&#123;OemIdentifier&#125;/UpdateService.FullImageUpdate

• 请求头：

    X-Auth-Token : auth_value
    Content-Type : header_type

• 请求消息体：

    {
        "ImageURI": image_uri,
        "TransferProtocol": transfer_protocol,
        "ForceUpdate": force_update
    }

8.2 IPMI接口升级 ​

8.2.1 触发固件整机升级 ​

命令权限： BasicSetting

是否锁定之后可以访问： 是

命令样式：

• 请求：ipmitool raw 0x30 <ManufacturerID> <SubCmd> <Length> <Filename>
• 响应：<ManufacturerID>

命令请求参数：

命令响应参数：

命令示例：样例：开始升级整包/tmp/fullimage.zip

• 请求：ipmitool raw 0x30 0x93 0xdb 0x07 0x00 0x94 0xaa 0x00 0x00 0x00 0x12 0x2F 0x74 0x6D 0x70 0x2F 0x66 0x75 0x6C 0x6C 0x69 0x6D 0x61 0x67 0x65 0x2E 0x7A 0x69 0x70
• 响应：0xdb 0x07 0x00

8.2.2 查询整包升级进度 ​

命令权限： ReadOnly

是否锁定之后可以访问： 是

命令样式：

• 请求：ipmitool raw 0x30 <ManufacturerID> <SubCmd>
• 响应：<ManufacturerID> <SubCmd> <Length> <Data>

命令请求参数：

命令响应参数：

命令示例：样例1：查询整包升级进度及状态

• 请求：ipmitool raw 0x30 0x93 0xdb 0x07 0x00 0x95 0x00 0x00
• 响应：0xdb 0x07 0x00 0x0a 0x00 0x50 0x00 0x53 0x01 0x00 0x00 0x64 0x02 0x00
• 固件1、2升级到80%，固件3升级失败，固件4升级到100%，固件5未匹配到具体板卡而未升级

8.3 Web Rest接口升级 ​

8.3.1 整包上传接口 ​

uri：

/UI/Rest/BMCSettings/UpdateService/Actions/UpdateService.FullImageUnpack

操作类型： POST

请求参数：

操作权限：BasicSetting

样例展示：

请求参数：

{
    "FilePath": "/tmp/fullimage.zip",
}

响应消息体举例：

{
    "url":"/UI/Rest/Task/1"
}

8.3.2 整包升级下发二次确认 ​

uri：

/UI/Rest/BMCSettings/UpdateService/ParallelUpdate

操作类型： POST

请求参数：

8.3.3 获取并行升级各固件信息 ​

uri：

/UI/Rest/BMCSettings/UpdateService/UpdateProgress

操作类型： GET

响应参数：

8.4 相关资源协作接口 ​

interface: bmc.kepler.UpdateService

path: /bmc/kepler/UpdateService