C H A P T E R 6

Monitor and Manage Power Consumption Using SNMP

Topics |
--- | ---
Description | Links
Review the prerequisites | Before You Begin
Monitor the power consumption interfaces | Monitor System Total Power Consumption Monitor Actual Power Consumption Monitor Individual Power Supply Consumption Monitor Available Power Monitor Hardware Configuration Maximum Power Consumption Monitor Permitted Power Consumption Monitor Power Management Settings
View and set power policy | View and Set the Power Policy

Related Topics |  |
--- | --- | ---
For ILOM | Section | Guide
Concepts | Power Monitoring and Management Interfaces | Oracle Integrated Lights Out Manager (ILOM) 3.0 Concepts Guide (820-6410)
Web | Monitoring Power Consumption | Oracle Integrated Lights Out Manager (ILOM) 3.0 Web Interface Procedures Guide (820-6411)
CLI | Monitoring Power Consumption | Oracle Integrated Lights Out Manager (ILOM) 3.0 CLI Procedures Guide (820-6412)
The ILOM 3.0 Documentation Collection is available at: `http://docs.sun.com/app/docs/prod/int.lights.mgr30#hic`

##

Before You Begin

Prior to performing the procedures in this chapter, you should ensure that the following requirements are met.

- Before you can use SNMP to view and configure ILOM settings, you must configure SNMP. For more information, see Preparing Your System to Use SNMP.

- To execute the `snmpset` command, you need to use an SNMP v1 or v2c community or an SNMP v3 user with read/write (rw) privileges.

- For examples of SNMP commands, see SNMP Command Examples.

Note - The example SNMP commands presented in this section are based on the Net-SNMP sample applications and, therefore, will only work as presented if you have Net-SNMP and the Net-SNMP sample applications installed.

##

Monitoring the Power Consumption Interfaces

Topics |
--- | ---
Description | Links
Monitor the power consumption interfaces | Monitor System Total Power Consumption Monitor Actual Power Consumption Monitor Individual Power Supply Consumption Monitor Available Power Monitor Hardware Configuration Maximum Power Consumption Monitor Permitted Power Consumption
View and set power policy | View and Set the Power Policy

Note - The power consumption interfaces described in this chapter might or might not be implemented on the platform that you are using. See the platform-specific ILOM Supplement, Platform Administration guide, or Product Notes for implementation details. You can find the ILOM Supplement, Platform Administration guide and Product Notes within the documentation set for your system.

Note - The ability to view and set the power policy is not available on SPARC platforms using ILOM 3.0 or ILOM 3.0.2. The power policy setting is available on some SPARC platforms starting with ILOM 3.0.3.

### Monitor System Total Power Consumption

To view total system power consumption using SNMP, type this command:

    % snmpget -v2c -cprivate -mALL snmp_agent_ipaddress entPhysicalName.308

### Monitor Actual Power Consumption

To view actual power consumption using SNMP, type this command:

    % snmpget -v2c -cprivate -mALL snmp_agent_ipaddress sunHwCtrlPowerMgmtActual.0

### Monitor Individual Power Supply Consumption

Before you can use SNMP to monitor individual power supply consumption, you must determine the `entPhysicalName` index numbers that correspond to the output and input power sensors for a particular power supply.

To view the individual power supply consumption, type a command similar to the following command.

For example, if you know that the `entPhysicalIndex` of `/SYS/VPS` is 303, you can view total output power consumption by typing the following command:

    % snmpget -v2c -cprivate -mALL snmp_agent_ipaddress \
      entPhysicalName.303 \
      entPhysicalClass.303 \
      entPhysicalDescr.303 \
      sunPlatNumericSensorBaseUnits.303 \
      sunPlatNumericSensorExponent.303 \
      sunPlatNumericSensorCurrent.303 \
      sunPlatNumericSensorLowerThresholdNonCritical.303 \
      sunPlatNumericSensorUpperThresholdNonCritical.303 \
      sunPlatNumericSensorLowerThresholdCritical.303 \
      sunPlatNumericSensorUpperThresholdCritical.303 \
      sunPlatNumericSensorLowerThresholdFatal.303 \
      sunPlatNumericSensorUpperThresholdFatal.303

TABLE 6-1 provides a brief description of each of the MIB objects included in the above command example. For more information, see the ENTITY-MIB and the SUN-PLATFORM-MIB.

TABLE 6-1 Individual Power Supply Consumption MIB Objects
MIB Object | MIB Name | Description
--- | --- | ---
`entPhysicalName` | ENTITY-MIB | The textual name of the physical entity.
`entPhysicalClass` | ENTITY-MIB | The general hardware type of the physical entity.
`entPhysicalDescr` | ENTITY-MIB | A textual description of physical entity.
`sunPlatNumeric SensorBaseUnits` | SUN-PLATFORM-MIB | The base unit of the values returned by this sensor as per CIM_NumericSensor.BaseUnits.
`sunPlatNumeric SensorExponent` | SUN-PLATFORM-MIB | The exponent to be applied to the units returned by this sensor as for CIM_NumericSensor.UnitModifier.
`sunPlatNumeric SensorCurrent` | SUN-PLATFORM-MIB | The sunPlatDiscreteSensorStatesIndex of a row in the sunPlatDiscreteSensorStatesTable that corresponds to the current reading of the sensor.
`sunPlatNumeric SensorLower ThresholdNon Critical` | SUN-PLATFORM-MIB | The lower threshold at which a NonCritical condition occurs as defined for CIM_NumericSensor.LowerThreshold NonCritical.
`sunPlatNumeric SensorUpper ThresholdNon Critical` | SUN-PLATFORM-MIB | The upper threshold at which a NonCritical condition occurs as defined for CIM_NumericSensor.UpperThreshold NonCritical.
`sunPlatNumeric SensorLower ThresholdCritical` | SUN-PLATFORM-MIB | The lower threshold at which a Critical condition occurs as defined for CIM_NumericSensor.LowerThreshold Critical.
`sunPlatNumeric SensorUpper ThresholdCritical` | SUN-PLATFORM-MIB | The upper threshold at which a Critical condition occurs as defined for CIM_NumericSensor.UpperThreshold Critical.
`sunPlatNumeric SensorLower ThresholdFatal` | SUN-PLATFORM-MIB | The lower threshold at which a Fatal condition occurs as defined for CIM_NumericSensor.LowerThreshold Fatal.
`sunPlatNumeric SensorUpper ThresholdFatal` | SUN-PLATFORM-MIB | The upper threshold at which a Fatal condition occurs as defined for CIM_NumericSensor.UpperThreshold Fatal.

### Monitor Available Power

To view total available power using SNMP, type this command:

    % snmpget -v2c -cprivate -mALL snmp_agent_ipaddress sunHwCtrlPowerMgmtAvailablePower.0

### Monitor Hardware Configuration Maximum Power Consumption

To view the hardware configuration maximum power consumption using SNMP, type this command:

    % snmpget -v2c -cprivate -mALL snmp_agent_ipaddress sunHwCtrlPowerMgmtHWConfigPower.0

### Monitor Permitted Power Consumption

To view permitted power consumption using SNMP, type this command:

    % snmpget -v2c -cprivate -mALL snmp_agent_ipaddress sunHwCtrlPowerMgmtPermittedPower.0

### Monitor Power Management Settings

Note - You can use the `get` command to view power management settings. For a description of the MIB objects used in these commands, see the SUN-HW-CTRL-MIB.

1. Log in to a host that has an SNMP tool and the ILOM MIBs installed. For example, type:

`ssh` username`@`snmp_manager_ipaddress

`Password:` password

2. Refer to the following SNMP command examples:

- To view the name of the power management policy for `PowerMgmtTable` index number 5, type:

    % snmpget -mALL -v2c -cprivate SNMP_agent_ipaddress sunHwCtrlPowerMgmtName.5

- To view the units for the value of the power management policy for `PowerMgmtTable` index number 5, type:

    % snmpget -mALL -v2c -cprivate SNMP_agent_ipaddress sunHwCtrlPowerMgmtUnits.5

- To view the value of the power management policy for `PowerMgmtTable` index number 5, type:

    % snmpget -mALL -v2c -cprivate SNMP_agent_ipaddress sunHwCtrlPowerMgmtValue.5

##

Using the Power Consumption Control Interfaces

Topics |
--- | ---
Description | Links
View and set power policy | View and Set the Power Policy

### View and Set the Power Policy

Note - You can use the `get` and `set` commands to view and set power policy.

1. To view the power policy using SNMP, type this command:

    % snmpget -v2c -cprivate -mALL snmp_agent_ipaddress sunHwCtrlPowerMgmtPolicy.0

2. To set the power policy, use the `snmpset` command.

For example, to set this MIB object to `performance`, type this command:

    % snmpset -v2c -cprivate -mALL snmp_agent_ipaddress sunHwCtrlPowerMgmtPolicy.0 i 3

TABLE 6-2 shows the MIB object type and values that are supported by the `sunHwCtrlPowerMgmtPolicy` MIB object.

TABLE 6-2 Valid Values and Type for the sunHwCtrlPowerMgmtPolicy MIB Object
MIB Object | Values | Type | Default
--- | --- | --- | ---
`sunHwCtrlPowerMgmtPolicy` | `notsupported(1), unknown(2), performance(3), elastic(4)` | Integer | None

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.