【已评审】支持电源告警锁存开关设置

Interface SIG Interface评审
1

一、ISSUE链接

二、背景

电源故障场景需要新增调测命令，该命令用于控制电源锁存功能的开关，用于捕捉电源闪断的异常。锁存功能开启后，后续产生的告警无法消除，需要关闭锁存功能告警才可以恢复清除。

三、决策点

1、新增电源锁存开关设置的调测命令

四、详细描述

方案一：

1、新增release在线调试命令

path：/bmc/kepler/Systems/:SystemId/PowerMgmt/:ID
interface：bmc.kepler.Release.OnePower.Status

方法名称 变化类型 签名 读写&权限 接口说明 接口约束 命令字 描述(displayDescription)
SetAlarmLatch 新增方法 请求: y
响应：NA		 PowerMgmt 设置电源告警锁存开关
请求：
Switch：电源告警锁存开关
响应：NA		 Switch取值：
0：告警不锁存
1：告警锁存		 setpsualarmlatch 方法描述：
Set the power supply alarm latch switch.
请求参数描述：
Switch：Power supply alarm latch switch, with values of 0 and 1, where 0 indicates that the alarm is not latched, and 1 indicates that the alarm is latched.

方案二：

1、 资源协作接口新增设置电源告警锁存开关方法

path：/bmc/kepler/Systems/:SystemId/PowerMgmt/:ID
interface：bmc.kepler.Systems.PowerMgmt.OnePower.Status

方法名称 变化类型 请求签名 响应签名 读写&权限 接口说明 接口约束
SetAlarmLatch 新增方法 y 无 PowerMgmt 设置电源告警锁存开关
请求：
SwitchStatus：电源告警锁存开关
响应：NA		 SwitchStatus取值：
0：告警不锁存
1：告警锁存

2、 cli接口新增设置电源告警锁存开关方法

CLI命令：ipmcset -t maintenance -d psualarmlatch -v <psu_slot> <state>
变化类型：新增命令字
操作类型：SET
操作权限：PowerMgmt
命令描述：设置电源告警锁存开关

参数名称 取值类型 说明 是否必选 约束
psu_slot integer 电源槽位号 是 1-最大电源个数
state string 告警锁存开关 是 取值
enabled：开启告警锁存
disabled：关闭告警锁存

五、评审结论

采用方案二新增cli命令

决策点1：资源协作接口新增设置电源告警锁存开关方法

结论：同意资源协作接口bmc.kepler.Systems.PowerMgmt.OnePower.Status新增SetAlarmLatch方法用于设置电源告警锁存开关，请求签名为y，无响应签名，权限：PowerMgmt

决策点2：cli接口新增设置电源告警锁存开关方法

结论：同意新增cli命令ipmcset -t maintenance -d psualarmlatch -v <psu_slot> <state>用于设置电源告警锁存开关，psu_slot为integer类型，state为string类型，权限：PowerMgmt

命令描述:

Set the power supply alarm latch status

回显格式:

Usage: ipmcset -t maintenance -d psualarmlatch -v <psu_slot> <state>
    psu_slot: 
        Power supply slot number, the range is from 1 to 3
    state: 
        enabled - Enable power supply alarm latch
        disabled - Disable power supply alarm latch

设置成功:

iBMC:/->ipmcset -t maintenance -d psualarmlatch -v 1 enabled
Enable power supply 1 alarm latch successfully.

设置失败:

iBMC:/->ipmcset -t maintenance -d psualarmlatch -v 1 disabled
Disable power supply 1 alarm latch failed.