fuelg command

This command displays power domain information, listing the power supplies that are installed in the Lenovo Flex System chassis and information about power usage. This command also configures policies for power redundancy loss and limiting fan noise during thermal events.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or fuelg command errors for a list of error messages that are specific to the fuelg command.

Table 1. fuelg command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function What it does Command Target (see paths in Command targets)
Display power domain status overview Displays health status, total power usage, total dc power available, total ac power in use, thermal response (acoustic mode) settings, total thermal output in BTU/hour, chassis static power limit, and the hot air recirculation detection state.
Note: The chassis static power limit (-spl) indicates the set value as both a percentage and a wattage, along with the upper and lower wattage values that can be set.
 fuelg
Lenovo Flex System chassis:
  • system
Display compute node power status overview Displays the power management and capping setting (on/off) and power management capability for the specified compute node. Depending on the power management capability of the specified compute node, the following information will also display:
  • CPU duty cycles
  • Effective and maximum CPU speeds
  • Power capping value (minimum and maximum)
  • Maximum, minimum, and average power levels
  • Time when above data was captured
  • Power saver mode status (on, off)
 fuelg
Compute node:
  • blade[x]
  • where x is the node bay number.
Display I/O module power status Displays the maximum, minimum, and average power information for the specified I/O module. fuelg
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Display fan module power status and temperature Displays the maximum power, minimum power, average power, and current temperature information for the specified fan module. fuelg
Fan module:
  • blower[x]
  • where x is the fan module bay number.
Display rear LED card temperature Displays the minimum, maximum, and average temperature for the specified rear LED card. fuelg
Rear LED card:
  • mt[x]
  • where x is the rear LED card.
Display detailed power domain status Displays detailed status and usage information for the power domain, including the policy setting for that domain, the maximum power limit, and the power in use. The valid states for components in the domain are:
  • * - compute node might throttle
  • C - communication error
  • D - discovering
  • Hib - hibernate
  • NP - module is not present
  • SB - standby
  • T - throttled
  • U - unable to power up
Note: The Lenovo Flex System chassis has only one power domain.
 fuelg pd
Lenovo Flex System chassis:
  • system
Set power domain redundancy loss policy Sets how the Lenovo Flex System chassis responds to a condition that could cause a loss of redundant power. fuelg pd -pm policy

where policy is:

  • acred (ac power source redundancy policy)
  • acredov (ac power source redundancy policy, with compute node throttling)
  • redwoperf (power module redundancy, no compute node oversubscription)
  • redwperf (power module redundancy with compute node power throttling)
  • nonred (no power management policy)
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Display power trending for specified time period for power domain Displays power trending information, for the selected time interval, for the power domain of the Lenovo Flex System chassis.
Note: The Lenovo Flex System chassis has only one power domain.
 fuelg pd -pt period

where period is 1, 6, 12, or 24 hours.
Lenovo Flex System chassis:
  • system
Display power trending for specified time period Displays power trending information for the selected time interval for the specified command target. fuelg -pt period

where period is 1, 6, 12, or 24 hours.
Lenovo Flex System chassis:
  • system
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Fan module:
  • blower[x]
  • where x is the fan module bay number.
Display thermal trending for specified time period Displays thermal trending information (minimum, maximum, and average temperature) for the selected time interval for the specified command target. fuelg -tt period

where period is 1, 6, 12, or 24 hours.
Rear LED card:
  • mt[x]
  • where x is the rear LED card.
Fan module:
  • blower[x]
  • where x is the fan module bay number.
Display exhaustive heat trending information for chassis for specified time period Displays exhaustive heat trending information for the chassis for the selected time interval. fuelg -ht period

where period is 1, 6, 12, or 24 hours.
Lenovo Flex System chassis:
  • system
Set hot air recirculation detection state Enables or disables hot air recirculation detection for the Lenovo Flex System chassis. fuelg -har setting

where a setting of:

  • disabled turns off hot air recirculation detection for the chassis.
  • enabled (default) turns on hot air recirculation detection for the chassis.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Set hot air recirculation threshold Sets the hot air recirculation threshold, the maximum allowable temperature difference between the input and output sensors, for the specified command target. If this threshold is exceeded, a hot air recirculation event is created in the CMM event log. fuelg -hart setting

where setting is a temperature, between, 5.00 and 9.00 Celsius, that triggers a hot air recirculation event. For example, a value of 6.00 would trigger an event if the output temperature was more than 6.00 degrees greater than the input temperature.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Display air flow trending for specified time period Displays chassis air flow trending information, in cubic feet per minute (CFM), for the selected time interval. fuelg -aft period

where period is 1, 6, 12, or 24 hours.
Lenovo Flex System chassis:
  • system
Thermal event response (acoustic mode) Sets the acoustic mode of Lenovo Flex System chassis fan system response to thermal events.
Note: When the CMM is installed in a Lenovo Flex System Carrier-Grade chassis:
  • Turning on NEBS mode (fuelg -am on) turns off acoustic mode (-am off).
  • Setting acoustic mode to a value of 1 through 5 (-am x, where x is 1 though 5) turns off NEBS mode (fuelg -am off).
  • The NEBS (-nm) setting overrides the acoustic mode (-am) setting if both options are specified at the same time.
 fuelg -am setting

where the acoustic-mode setting is off or a number from 1 to 5, inclusive. A value of off disables acoustic mode (fans run at maximum requested speed, providing highest cooling). A value of 1 provides low attenuation (higher cooling). A value of 5 provides highest attenuation (lowest cooling). If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Set NEBS mode for chassis
Note: This command option applies only to CMMs installed in a Lenovo Flex System Carrier-Grade chassis.
 Enables or disables NEBS (Network Equipment-Building System) mode for a Lenovo Flex System Carrier-Grade chassis.
Note:
  • Turning on NEBS mode (-am on) turns off acoustic mode (fuelg -am off).
  • Setting acoustic mode to a value of 1 through 5 (fuelg -am x, where x is 1 though 5) turns off NEBS mode (-am off).
  • The NEBS (-nm) setting overrides the acoustic mode (-am) setting if both options are specified at the same time.
 fuelg -nm setting

where setting is off or on.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Set static power limit Sets the static power limit value for the Lenovo Flex System chassis.
Note: To set the static power limit value for the chassis, power management and capping for the chassis must not be set to none (fuelg -pme static ).
 fuelg -spl setting
where setting is:
  • a maximum percentage, between, 0 and 100, of total available power. For example, a value of 80 would set the upper limit of available power to 80 percent of total available power. The percentage selected must fall within the range of available power for the chassis.
  • a maximum wattage value, indicated by w, within the range of total available power. For example, a value of 5000w would make up to 5000 watts of power available for use by chassis components.
Available power for a chassis is displayed by running the fuelg command, with no options, on the system target.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Set power capping value Sets the power capping value for the specified command target that supports this feature.
Note:
  • Setting a power capping value for a compute node, automatically turns on power management and capping for the compute node (fuelg -pme on ).
  • A compute node must be turned on before you can set its power capping value.
  • When setting -pcap to the maximum power limit value for a range, verify that there is sufficient power available in the budget, or the setting will be rejected. Use the fuelg command with no options to see the amount of power currently allocated.
  • Reconfiguration of the fuelg -pcap value might be required when disabling fuelg -dps to make sure that the power allocated for a node is not greater than the maximum power limit allowed.
 fuelg -pcap setting

where setting is a numeric wattage value that falls within the range of power capping values displayed when running the fuelg command, with no options, on the target.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Power management and capping - enable or disable Turns power management and capping for the specified command target on or off.
Note:
  • If power management and capping is set to static for a chassis, you must also specify a static power limit value (fuelg -spl value).
  • A compute node must be turned on before you can enable power management and capping for it.
 fuelg -pme setting

where:

  • for the chassis target, a setting of:
    • none (default) disables power management and capping for the chassis.
    • static enables power management and capping for the chassis.
  • for a compute node target, a setting of:
    • off (default) disables power management and capping for the compute node.
    • on enables power management and capping for the compute node.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Compute node:
  • blade[x]
  • where x is the node bay number.
Static low power saver mode - enable or disable for compute node Turns the static low power saver mode for the specified compute node on or off.
Note:
  • A compute node must be turned on before you can enable power saver mode for it.
  • Not all compute nodes support the power saver mode.
 fuelg -ps setting

where a setting of:

  • off (default) disables power saver mode for the compute node.
  • on enables power saver mode for the compute node.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Dynamic power optimizer - enable or disable for compute node Turns dynamic power optimizer for the specified compute node on or off.
Note:
  • A compute node must be turned on before you can enable dynamic power optimizer for it.
  • Not all compute nodes support the dynamic power optimizer.
  • When enabling -dps, set fuelg -pcap to the maximum power limit value for that range so the node receives the full benefit of dynamic power optimizer mode. When setting fuelg -pcap to the maximum power limit value for a range, verify that there is sufficient power available in the budget, or the setting will be rejected. Use the fuelg command with no options to see the amount of power currently allocated.
  • When disabling -dps, make sure that the configured fuelg -pcap value for the node is not greater than the maximum power limit for the -dps disabled range. Reconfiguration of the fuelg -pcap value might be required to make sure that the power allocated for a node is not greater than the maximum power limit allowed.
 fuelg -dps setting

where a setting of:

  • off (default) disables dynamic power optimizer for the compute node.
  • on enables dynamic power optimizer for the compute node.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Favor performance over power - enable or disable for compute node Turns the favor performance over power feature on or off for the specified compute node.
Note:
  • A compute node must be turned on before you can enable the favor performance over power feature for it.
  • Not all compute nodes support the favor performance over power feature.
  • This feature can only be active if the dynamic power optimizer is enabled.
 fuelg -fpop setting

where a setting of:

  • off (default) disables favor performance over power for the compute node.
  • on enables favor performance over power for the compute node.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Example: To view a power domain status overview, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
fuelg
To view the detailed power domain status for the power domain, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
fuelg pd
To view Lenovo Flex System chassis power trending information for the past 6 hours, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
fuelg -pt 6
To view the power status for the compute node in blade bay 9, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
fuelg -T blade[9]
To view thermal trending information for the rear LED card in bay 1, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
fuelg -T mt[1] -tt 1

The following examples show the information that is returned from these commands.

system> fuelg
Note: All power values are displayed in Watts.

Total DC Power Available: 13725
Total Power In Use:      678 (+/- 0.5%)
Total Thermal Output:      2313 BTU/hour

Power Domain
--------------
Status: Power domain status is good.
Modules:
 Bay 1:   2745
 Bay 2:   2745
 Bay 3:   2745
 Bay 4:   2745
 Bay 5:   2745
 Bay 6:   2745 (off)
Power Management Policy: Basic Power Management
Power in Use:            596 (+/- 0.5%)
Total Power:           13725
Allocated Power (Max):  3233
Remaining Power:       10492
Power Service: 220 VAC

-am  off
-pme  static
-spl 90 (12489W, min: 3233W, max: 13725W)
-har enabled
-hart 5.00

Component: system
Temp: 23.50 C
Threshold exceeded: No

Component: system:bladegroup[3]:blade[1]
Temp: 23.00 C
Threshold exceeded: No

Component: system:bladegroup[3]:blade[2]
Temp: 23.00 C
Threshold exceeded: No

Component: system:blade[4]
Temp: 22.00 C
Threshold exceeded: No

Component: system:bladeenclosure[7]:blade[1]
Temp: 23.00 C
Threshold exceeded: No

Component: system:bladeenclosure[7]:blade[2]
Temp: 22.00 C
Threshold exceeded: No

Component: system:bladeenclosure[11]:blade[1]
Temp: 29.00 C
Threshold exceeded: Yes

system> fuelg pd
Maximum Power Limit: 13725
Power In Use:          689

                                       Power  -- Allocated Power --
Bay(s)  Module                         State  Current   Max    Min
======  =============================  =====  =======  =====  =====
Chassis Components
        Midplane                        On         38     38     38
     1  Rear LED Card 1                 On          2      2      2
Chassis Cooling Devices
     1  Chassis Cooling Device 1        On          9     75     75
     2  Chassis Cooling Device 2        On         11     75     75
     3  Chassis Cooling Device 3        On         12     75     75
     4  Chassis Cooling Device 4        On         11     75     75
     5  Chassis Cooling Device 5        On          7     60     60
     6  Chassis Cooling Device 6        On         11     75     75
     7  Chassis Cooling Device 7        On         11     75     75
     8  Chassis Cooling Device 8        On         10     75     75
     9  Chassis Cooling Device 9        On         10     75     75
    10  Chassis Cooling Device 10       On          6     60     60
Power Module Cooling Devices
     1  PM Cooling Device 1             On         40     40     40
     2  PM Cooling Device 2             On         40     40     40
     3  PM Cooling Device 3             On         40     40     40
     4  PM Cooling Device 4             On         40     40     40
     5  PM Cooling Device 5             On         40     40     40
     6  PM Cooling Device 6             On         40     40     40
Management Modules
     1  CMM 1 (NP)                                  0     20     20
     2  SN#Y031BG18Y03L                 On         20     20     20
I/O Modules
     1  Ethernet ScSE                   On         29     64     64
     2  I/O Module 2 (NP)                           0    175    175
     3  Fibre ScSE                      On         39     45     45
     4  Fibre ScSE                      On         38     50     50
Blades
   1-4  Enclosure 01
     1    Discovering                   Off       104    730    730
Getting power allocation for blade[2] failed
Getting duty cycle numbers of blade[2] failed.
     2    Discovering                   Off         0      0      0
   5-8  Enclosure 05
     1    Discovering (C)               Off         0    638    638
     2    Discovering (C)               Off         0      0      0
     9  Node 09                         Off         6    107     72
    13  Discovering                     Off         0      0      0

Domain totals:
  Allocated Power                                 614   2849   2814

Note: (T) means "throttled", (U) means "unable to power up",
      * means "the blade may throttle", (NP) means "the module is not present",
      (D) means "discovering", (C) means "comm error", (SB) means "Standby"
      (CA) means "capped max power allocation"
-pm nonred

system> fuelg -pt 6
Date     Time     Avg Pwr
-------- -------- -------
10/29/12 19:45:00     784
10/29/12 19:50:00     792
10/29/12 19:55:00     784
10/29/12 20:00:00     787
10/29/12 20:05:00     787
10/29/12 20:10:00     784
10/29/12 20:15:00     784
10/29/12 20:20:00     782
10/29/12 20:25:01     786
system> fuelg -T blade[9]
PM Capability: Dynamic Power Measurement
Effective CPU Speed:    0 MHz
Maximum CPU Speed: 1900 MHz
Maximum Power:    6
Minimum Power:    6
Average Power:    6
Data captured at 10/29/12 20:25:03
system> fuelg -T mt[1] -tt 1
                        Temp (C)
Date     Time     Max    Min    Avg
-------- -------- ------ ------ ------
02/06/14 12:20:01  25.50  24.50  24.90
02/06/14 12:24:59  25.50  24.50  24.80
02/06/14 12:30:01  27.00  25.50  26.20
system>
Parent topic: Command reference