【已评审】并行升级接口扩展参数标识升级是否立即生效

Interface SIG Interface评审
1

背景

当前BMC的并行升级过程中，会默认将可生效的固件进行生效，比如（BMC升级完成后进行复位生效，下电升级CPLD完成后进行AC生效），但是有产业诉求，希望并行升级完成后不要立即生效，后续在通过统一生效接口进行生效，因此，需要并行升级接口中通过入参标识固件是否要立即生效

关联ISSUE

暂无

整体方案

Redfish/Web并行升级接口扩展参数标识升级是否立即生效

评审点一 Redfish并行升级接口扩展参数用来标识升级是否立即生效

详细描述

URI: /redfish/v1/UpdateService/Actions/Oem/Huawei/UpdateService.ParallelUpdate
操作类型：POST
变更点：新增参数ActiveMode，用来标识升级是否立即生效
请求说明：

{ 
    Packages：[
        { 
            "ImageURI": filepath, 
            "TransferProtocol": protocol,
            "BiosActiveMode": biosactivemode,
            "SystemId": systemid，
            "ActiveMode": active_mode
        } 
    ]
}
参数 参数说明 取值
ActiveMode 并行升级完成后是否立即生效 Immediately 立即生效，如果需要下电生效的固件在上电过程中升级，升级完后会主动下电生效
ResetBMC 需要手动复位BMC生效
ResetAC 需要手动AC生效
PowerOff 上电情况下升级待下电生效的固件需要手动下电生效

评审点二 UIRest并行升级接口扩展参数用来标识升级是否立即生效

详细描述

URI: /UI/Rest/BMCSettings/UpdateService/ParallelUpdate
操作类型：POST
变更点：新增参数ActiveMode，用来标识升级是否立即生效
请求说明：

"ReqBody": {
                        "Type": "object",
                        "Required": true,
                        "Properties": {
                            "FilePath": {
                                "Required": true,
                                "Type": "string"
                            },
                            "ActivatedImmediately": {
                                "Type": "boolean",
                            },
                        }
                    },
参数 参数说明 取值
ActivatedImmediately 并行升级完成后是否立即生效 true 立即生效
false 升级待复位BMC的固件需要手动复位BMC；升级待AC生效的固件需要手动AC；上电情况下升级待下电生效的固件需要手动下电生效

评审点三 WebUI 新增是否立即生效选项

image
image1611×905 49.6 KB

并行升级模式未勾选时串时置灰，默认立即生效

详细描述

评审结论

遗留问题

2

方案评审结果如何？技术难点主要在哪些方面？