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.

1. 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 limit 0x01 - Activate power limit
   	5-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.

2. 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 - Deactivated 01 - Activated
   	4	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 - None 01 - Hard power-off
   	6-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 default 01 - Default
   	13	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.

3. 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 - none 01 - hard power-off
   	8-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 default 0x01 - default
   	15	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.