【已评审】Redfish升级接口新增参数校验版本是否一致

Interface SIG Interface评审
1

前置评审

背景

大包升级时HPM中包含多个固件，部分固件与设备实际运行版本一致无需升级，只在固件版本不一致才进行升级

关联ISSUE

暂无

整体方案

当前升级流程中不判断固件版本，不管是否与当前版本一致，都会强制升级
因此需要通过升级接口参数配置此次升级在版本一致场景是否进行升级。

  • Redfish升级接口新增校验版本是否一致参数

评审点一 Redfish串行升级接口新增入参表示版本号一致时是否升级

详细描述

URI: /redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate
操作类型：POST
变更点：新增参数ForceUpdate，用来表示版本号一致时是否强制升级
请求说明：

        { 
            "ImageURI": filepath, 
            "TransferProtocol": protocol,
            "BiosActiveMode": biosactivemode,
            "SystemId": systemid，
            "ForceUpdate":  true/false
        }
参数 参数说明 取值 可选/必选 备注
ForceUpdate 升级策略 true – 不管是否与当前版本一致，都会强制升级
false – 版本一致场景不升级		 可选 不选时默认强制升级

评审点二 Redfish并行升级接口新增入参表示版本号一致时是否强制升级

详细描述

URI: /redfish/v1/UpdateService/Actions/Oem/Huawei/UpdateService.ParallelUpdate
操作类型：POST
变更点：新增参数ForceUpdate，用来表示该package版本号一致时是否升级
请求说明：

{ 
    Packages：[
        { 
            "ImageURI": filepath, 
            "TransferProtocol": protocol,
            "BiosActiveMode": biosactivemode,
            "SystemId": systemid，
            "ForceUpdate": true/false
        }, 
......
    ]
}
参数 参数说明 取值 可选/必选 备注
ForceUpdate 升级策略 true – 不管是否与当前版本一致，都会强制升级
false – 版本一致场景不升级		 可选 不选时默认强制升级

评审结论

通过，具体结论如下：

  1. 同意 Redfish Action /redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate 请求新增参数 ForceUpdate，表示当前请求的升级是否强制升级；当前参数是可选参数，类型为 boolean，取值为 true 时表示当前升级是强制升级，取值为 false 时表示当前升级不进行强制升级，当待升级的固件版本号和当前固件版本号一致时不需要升级；默认值为 true
  2. 同意 Redfish Action /redfish/v1/UpdateService/Actions/Oem/Huawei/UpdateService.ParallelUpdate 请求新增参数 ForceUpdate，表示当前请求的升级是否强制升级；当前参数是可选参数，类型为 boolean，取值为 true 时表示当前升级是强制升级，取值为 false 时表示当前升级不进行强制升级，当待升级的固件版本号和当前固件版本号一致时不需要升级；默认值为 true