power command

This command turns on and turns off compute nodes and I/O modules.

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 power command errors for a list of error messages that are specific to the power command.

Table 1. power 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)
Power on Turns on the specified command target.
Note: Some storage nodes might have specific boot sequence requirements, see the documentation for your storage node for details.
 power -on
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration (for compute node)
  • I/O module administration (for I/O module)
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Power on to command console Opens a command console with an SOL session when the specified compute node is turned on.
Note: Some storage nodes might have specific boot sequence requirements, see the documentation for your storage node for details.
 power -on -c
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration and blade remote presence
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Enable / disable SMS for compute node Enable or disable the System Management Services (SMS) firmware menu on the specified compute node, for compute nodes that support this feature.
Note:
  • The compute node will restart immediately after setting the -sms option.
  • The -sms option state that is set is retained after the compute node restarts.
  • The -f1, -f2-sms, -wol, -local, -ap, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -sms state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Enable / disable F1 (Setup) for compute node Enable or disable F1 (Setup) menu on the specified compute node, for compute nodes that support this feature.
Note:
  • The compute node will restart immediately after setting the -f1 option.
  • The -f1 option state that is set is retained after the compute node restarts.
  • The -f1, -f2, -sms, -wol, -local, -ap, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -f1 state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Enable / disable F2 (Diagnostics) for compute node Enable or disable F2 (Diagnostics) menu on the specified compute node, for compute nodes that support this feature.
Note:
  • The compute node will restart immediately after setting the -f2 option.
  • The -f2 option state that is set is retained after the compute node restarts.
  • The -f1, -f2, -sms, -wol, -local, -ap, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -f2 state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Power off Turns off the specified command target. power -off
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration (for compute node)
  • I/O module administration (for I/O module)
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Shutdown and power off compute node Shuts down the operating system and turns off the specified compute node. power -softoff
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Power cycle Cycles power for the specified compute node or I/O module. If the compute node or I/O module is off, it will turn on. If the compute node or I/O module is on, it will turn off and then turn on. power -cycle
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration (for compute node)
  • I/O module administration (for I/O module)
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Power cycle to command console Cycles power for the specified compute node. If the compute node is off, it opens a command console with an SOL session when it is turned on. If the compute node is on, it will turn off and then turn on. power -cycle -c
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade administration and blade remote presence
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Display power state Displays the current power state for the specified compute node or I/O module. Possible return values are off, on, standby, or hibernate. power -state
Compute node:
  • blade[x]
  • where x is the node bay number.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Enable / disable Wake on LAN globally Enables or disables Wake on LAN globally for all compute nodes.
Note: The -wol, -sms, -local, -ap, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -wol state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Enable / disable Wake on LAN for compute node Enables or disables Wake on LAN for the specified compute node.
Note: The -wol, -sms,-local, -ap, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -wol state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Enable / disable local power control globally Enables or disables local power control globally for all compute nodes.
Note: The -local, -sms, -wol, -ap, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -local state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Enable / disable local power control for compute node Enables local power control for the specified compute node.
Note: The -local, -sms, -wol, -ap, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -local state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set automatic power-on policy for compute node Sets the automatic power-on policy for the targeted compute node.

Changes to the power-on policy setting take effect after the next restart of the compute node.

Note: The -ap, -sms, -wol, -local, and -d command options can be entered together, but these options must be used exclusive of all other command options.
 power -ap policy
where policy is:
  • restore : the compute node will power on if it was previously on
  • auto : when power is applied to the Lenovo Flex System chassis, the compute node will be powered on
  • manual : the compute node will remain off until manually powered on
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set restart delay for compute node Sets the amount of time that the targeted compute node waits to start after application of power to the Lenovo Flex System chassis.

Changes to the restart delay take effect after the next restart of the compute node.

Note: The -d, -sms, -wol, -local, and -ap command options can be entered together, but these options must be used exclusive of all other command options.
 power -d value

where value is from 0 to 3600 seconds, inclusive. If you enter a value of 0, the restart delay is disabled (no delay). If you enter a value greater than 3600, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Blade configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
Set restart delay for I/O-module Sets the amount of time that the targeted I/O-module waits to start after application of power to the Lenovo Flex System chassis.

Changes to the restart delay take effect after the next restart of the I/O-module.

Note: The -d, -sms, -wol, -local, and -ap command options can be entered together, but these options must be used exclusive of all other command options.
 power -d value

where value is from 0 to 3600 seconds, inclusive. If you enter a value of 0, the restart delay is disabled (no delay). If you enter a value greater than 3600, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module administration
See Commands and user authority for additional information.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Display POST status for I/O module Displays the POST status for the specified I/O module. If the command is run while POST is in progress, it returns the level of POST that is currently in process. If the command is run after POST is complete, it displays one of the following return values:
  • The POST results could not be read. message displays if there was an internal error during POST.
  • The POST results not complete: hex_code message displays if POST results are not available after POST completes.
  • If POST returns valid results, one of the following messages displays:
    • hex_code: Base internal function failure detected.
    • hex_code: Internal interface failure detected.
    • hex_code: External interface failure detected.
    • hex_code: Module completed POST successfully.
    • hex_code: Cannot decode POST result code.
  • The Invalid POST results. message displays if none of the above conditions is true.

Where hex_code is a hexadecimal code. See the documentation that comes with your I/O module for information.

Note: This command option is not supported for serial concentrator I/O modules.
 power -state -post
I/O module:
  • switch[x]
  • where x is the I/O-bay number.

Example:

To display the power state for the compute node in compute node bay 5, while this compute node is set as the persistent command environment, at the system:blade[5]> prompt, type 
power -state
To turn on the compute node in node bay 5, while this compute node is set as the persistent command environment, at the system:blade[5]> prompt, type 
power -on
To display the power state for the compute node in node bay 5 again, while this compute node is set as the persistent command environment, at the system:blade[5]> prompt, type 
power -state

The following example shows the information that is returned from these three commands:

system:blade[5]> power -state
Off
system:blade[5]> power -on
OK
system:blade[5]> power -state
On
system:blade[5]>
Parent topic: Command reference