- Oracle ILOM Protocol Management Reference SNMP and IPMI Firmware Release 5.1.x
- Server Management Using IPMI
- Performing System Management Tasks (IPMItool)
- Manage Oracle ILOM Power Budget Interfaces
Manage Oracle ILOM Power Budget Interfaces
Note:
The IPMI TLS interface (orcltls
) is supported as of Oracle ILOM
firmware version 3.2.8 and later. For a higher level of security, you should always specify
the IPMI TLS interface (-I orcltls
) when executing Oracle ILOM commands
from the IMPItool utility. For more information about using the IPMI TLS interface from
Oracle, see these topics:IPMI TLS Service and Interface and
Configure IPMI Management Access for Increased Security in Oracle ILOM Security Guide For Firmware Release 5.1.x
Follow these steps to set the power budget properties on a managed device.
-
To set the Power Limit Activation State on a managed device, use one of the following commands:
-
To activate, type:
$ ipmitool -I [orcltls|lanplus] -H SP_hostname_or_IPaddress -U username -P password
raw 0x2e 0x49 0x00 0x01 0xFF 0xFF
Upon command completion:
dc
-
To deactivate, type:
$ ipmitool -I [orcltls|lanplus] -H SP_hostname_or_IPaddress -U username -P password
raw 0x2e 0x49 0x00 0x00 0xFF 0xFF
Upon command completion:
dc
The following table describes the Power Limit Activation State (IPMItool) input and output fields.
Fields Byte Description Input Data
1
Sunoem command group number:
0x2e
.2
Command code
0x49
sets the power limit activation state.3
Group extension identification:
0x00
. The value for this field is ignored.4
Sub-commands for power limit activation:
0x00
- Deactivate power limit0x01
- Activate power limit5-6
Reserved fields
0xFF
. The values for these fields are ignored.Output Data
1
Completion code consumed by IPMItool.
The system does not display a status for successful completion code. However, if the result of the completion code is anything other than '
successful
', a failure message appears.2
Group extension identification
dc
' appears upon command completion. -
-
To get Power Limit Budget properties, type:
Note:
You should use a Get Power Limit Budget Wattage command prior to setting the Power Limit Budget Wattage property.
$ ipmitool -I [orcltls|lanplus] -H SP_hostname_or_IPaddress -U username -P password
raw 0x2e 0x4A 0x00 0x00 0x00
Upon command completion:
dc 00 01 b3 00 02 fa 00 00 00 00 01 e9 00 00
The following table describes the Get Power Limit (IPMItool) input and output fields:
Field Byte Description Input Data
1
Sunoem command group number:
0x2e
.2
Command code
0x4A
gets Power Budget settings.3
Group extension identification:
0x00
. The value for this field is ignored.4-5
Reserved fields
0x00
. Values for these fields are ignored.Output Data
1
Completion code, consumed by IPMItool. Not displayed upon command completion. However if completion code is anything other than success, then a failure message is displayed upon command completion.
2
Group extension identification. Displayed as '
dc
in the preceding example.3
Activation state:
00
- Deactivated01
- Activated4
Reserved field. Note that the value
b3
in the preceding example can be ignored.5
Exception action, taken if power limit is exceeded and cannot be controlled within the correction time limit. Return values:
00
- None01
- Hard power-off6-7
Power limit in watts.
02 fa
in the preceding example.8-11
Correction time limit in milliseconds.
00 00 00 00
in the preceding example.12
Flag indicating whether the correction time limit is the system default time limit.
00
- Not default01
- Default13
Reserved field. Note that the value shown (
e9
) in the preceding example can be ignored.14-15
Reserved fields. Note that the value shown (
00 00
) in the preceding example can be ignored. -
To set the Power Limit, type:
Note:
The set power limit commands sets the power budget limit for the system. Use this command to set the maximum system power usage. The power limit should always be persistent across AC and DC cycles.
$ ipmitool -I [orcltls|lanplus] -H SP_hostname_or_IPaddress -U username -P password
raw 0x2e 0x4B 0x00 0xff 0xff 0xff 0x01 0x02 0xaa 0x00 0x00 0x1b 0x58 0x00 0xff 0x00 0x00
Upon command completion:
dc 00
The following table describes Set Power Limit (IPMItool) input and output fields:
Fields Byte Description Input Data
1
Sunoem command group number:
0x2e
.2
Command code
0x4B
sets power budget settings.3
Group extension identification:
0x00
. The value for this field is ignored.4-6
Reserved fields:
0xff 0xff 0xff
. The values for this field are ignored.7
Exception action taken:
00
- none01
- hard power-off8-9
Power limit in watts. For example:
0x2a
0xaa
10-13
Correction time limit in milliseconds. For example:
0x00 0x00 0x1b 0x58
. This value is ignored if the time limit is set to default; see next byte.14
A flag indicating whether to use the system default time limit. Correction time limit in bytes 10-13 will be ignored.
0x00
- not default0x01
- default15
Reserved field
0xff
. The value for this field is ignored.16-17
Reserved field
0x00 0x00
. The values for these fields are ignored.Output Data
1
Completion code that is consumed by IPMItool.
The system does not display a status for successful completion code. However, if the result of the completion code is anything other than successful, a failure message appears.
2
Group extension identification '
dc
' appears upon command completion.