【变更声明】功耗封顶失败动作接口行为和值变更

Interface SIG
1

变更声明

为了保证功耗封顶失败动作的实现与Redfish/ipmi-DCMI标准定义一致，需对功耗封顶失败动作的定义及设置功耗封顶失败动作的相关接口进行变更。针对功耗封顶失败动作的定义，原选项NoAction由记录事件日志变更为不做任何操作，新增LogEventOnly选项用于记录事件日志，设置功耗封顶失败动作的相关接口增加了LogEventOnly选项，详细变更内容请见评审材料：

受影响的版本

  • openUBMC 25.09

变更描述

规格变化

不涉及

外观变化

不涉及

外部接口变化

2.1 Redfish

https:// device_ip /redfish/v1/Chassis/ chassis_id /Power

{
    "PowerControl": [{
            "PowerLimit": {
                "LimitException": "xxx"
            }
    }]
}
变更前
  • LimitException字段支持设置 “NoAction(默认)”、“HardPowerOff”、“Reset”
  • NoAction选项实现为记录事件日志
变更后
  • LimitException字段支持设置 “NoAction”、“HardPowerOff”、“Reset”、“LogEventOnly(默认)”
  • NoAction选项实现由记录事件日志变更为不做任何操作，新增的LogEventOnly选项实现为仅记录事件日志

2.2 IPMI OEM

Set Power Capping Configuration

IPMI OEM设置功耗封顶失败状态的命令如下
ipmitool -H ip -I lanplus -U username -P password -C 17 raw 0x30 0x93 0xDB 0x07 0x00 0x13 0x03 0x00 0x00 0x02

的含义分别为事件日志使能状态和封顶失败后期望动作

变更前
  • 封顶失败后期望动作：0-NoAction(默认)，1-HardPowerOff，2-Reset
  • NoAction选项实现为记录事件日志
  • 事件日志使能状态为0（disable），封顶失败后期望动作也应为0（NoAction），返回异常
变更后
  • 封顶失败后期望动作：0-NoAction，1-HardPowerOff，2-Reset，3-LogEventOnly(默认)
  • NoAction选项实现由记录事件日志变更为不做任何操作，新增的LogEventOnly选项实现为仅记录事件日志
  • 事件日志使能状态为0（disable），封顶失败后期望动作也应为0（NoAction），表示NoAction，NoAction选项实现为不做任何操作

2.3 IPMI DCMI

Set Power Limit

ipmitool -H ip -I lanplus -U username -P password -C 17 raw 0x2c 0x04 0xdc 0x00 0x00 0x00 0xe8 0x03 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00

的含义为封顶失败后期望动作

变更前
  • 封顶失败后期望动作：00h – NoAction(默认)，01h – HardPowerOff，02h – Reset
  • NoAction选项实现为记录事件日志
变更后
  • 封顶失败后期望动作：00h – NoAction，01h – HardPowerOff，02h – Reset，11h – LogEventOnly(默认)
  • NoAction选项实现由记录事件日志变更为不做任何操作，新增的LogEventOnly选项实现为仅记录事件日志

2.4 Web

https:// device_ip /UI/Rest/System/Power

对象 字段 类型
PowerLimit LimitException String
变更前
  • LimitException字段支持设置 “NoAction(默认)”、“HardPowerOff”、“Reset”
  • NoAction选项实现为记录事件日志
变更后
  • LimitException字段支持设置 “NoAction”、“HardPowerOff”、“Reset”、“LogEventOnly(默认)”
  • NoAction选项实现由记录事件日志变更为不做任何操作，新增的LogEventOnly选项实现为仅记录事件日志

2.5 SNMP

snmpset -v 3 -l authPriv -a SHA-512 -x AES -u username -A ****** -X ****** ip 1.3.6.1.4.1.2011.2.235.1.1.23.3.0 i

的含义为封顶失败后期望动作

变更前
  • 封顶失败后期望动作：1 – LogEventOnly(默认)，2 – HardPowerOff，3 – Reset
变更后
  • 封顶失败后期望动作：1 – LogEventOnly(默认)，2 – HardPowerOff，3 – Reset，4 – NoAction，NoAction选项实现为不做任何操作

安装方式变化

不涉及

兼容性说明

  • BMC固件兼容性：当前变更仅涉及BMC的固件软件版本，不涉及兼容性

  • openUBMC 和 BMC SDK 兼容性：对于老版本openUBMC+新版本BMC SDK的场景，存在兼容性问题：Web/Redfish查询失败动作为NoAction、SNMP查询失败动作为1（LogEventOnly）时，无法判断是否会记录事件日志；Web/Redfish设置失败动作为NoAction、SNMP设置失败动作为1（LogEventOnly）时，设置的失败动作为变更后的NoAction，即此时不会记录事件日志（与IPMI OEM/IPMI DCMI保持一致），Web/Redfish/SNMP无法将失败动作由新增的LogEventOnly切换为变更后的NoAction，且不支持设置新增的LogEventOnly

文档影响

影响 openUBMC 社区开发文档中心API文档

建议动作

  • 建议使用最新的openUBMC版本
  • 建议升级 BMC SDK 版本至 25.12 或更高版本