pwrprofile command

This command displays and configures power groups and schedules for 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 pwrprofile command errors for a list of error messages that are specific to the pwrprofile command.

Table 1. pwrprofile 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 all power groups and schedules	Displays all power groups and schedules configured for the Lenovo Flex System chassis.	`pwrprofile`	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Display power group	Displays information for the specified power group.	`pwrprofile -`group_index where group_index is the index number that identifies the power group. Index numbers are assigned automatically at group creation and can be seen in the Display all power groups and schedules list.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Add power group	Adds a power group with the specified name for the specified key group of compute nodes and I/O modules. Note All parameters must be specified when creating a power group. The index number for the power group is assigned automatically and can be seen in the Display all power groups and schedules list.	`pwrprofile -add -n` name -key group_key -servers server_group where: name is a alphanumeric string up to 63 characters in length that can include periods ( . ) and underscores ( _ ). Each of the 32 group names must be unique. group_key is: tm for type/model sn for serial number by for bay number server_group is: Type/model or serial number (maximum 31 characters). The wildcard character () is accepted. Bay designations that meet the following criteria: Maximum string length of 127 characters. One or more bay-type keywords (blade and switch are the only keywords supported at this time), each followed by a comma delimited list of bay numbers or range of bay numbers (two bay numbers separated by a dash) surrounded by parentheses. Bay-type keywords can be in any order separated by a comma. (continued on next page)*	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Add power group (continued)		server_group(continued): Bay designations (continued): Individual bay numbers and ranges can be in any order. Overlapping ranges and whitespace are allowed. For example: blade (1, 3, 4-6, 8, 2-5, 12, 13-14) blade (3), blade (5-9, 2) switch (1-2) ,blade (1), switch (4) This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.
Add power schedule and assign to power group	Adds a power schedule, assigned to a specific power group, with the specified name for the specified key group of compute nodes or I/O modules. Important The power group index must be the first command option specified (for example, `pwrprofile -1 -add -s enabled -a on -f once -d 11202015` ). Note The power group index, -s, -a, and -f parameters must be specified when creating a power schedule. If the frequency (-f) is set to once, you must specify either a time (-t), a date (-d), or both a time and date. If only a date is specified, the scheduled action will take place when the system switches to the date indicated. If the frequency (-f) is set to daily, you must specify a time (-t). If the frequency (-f) is set to weekly, you must specify both a time (-t) and a day (-d). Up to four power schedules can be assigned to a power group. The index number for the power schedule is assigned automatically and can be seen in the Display all power groups and schedules list.	`pwrprofile -`group_index -add -s status -a action -f freq -d day -t time where: where group_index is the index number that identifies the power group where this schedule will be applied. Index numbers are assigned automatically at group creation and can be seen in the Display all power groups and schedules list. status is a power schedule status of enabled or disabled. action is the power action to perform: on, off, cycle, or softoff. freq is how often the schedule is applied: once, daily, or weekly. day is: For frequency of once, a date in mmddyyyy format. For weekly frequency: mon, tues, wed, thur, fri, sat, or sun. time is the time of day in hhmm format. This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Modify power group	Changes values for the specified power group. Important The power group index must be the first command option specified (for example, `pwrprofile -1 -n group2` ). Note You can modify any valid subset of values for the power group.	`pwrprofile -`group_index `-n` name -key group_key -servers server_group where: where group_index is the index number that identifies the power group to modify. Index numbers are assigned automatically at group creation and can be seen in the Display all power groups and schedules list. name is a alphanumeric string up to 63 characters in length that can include periods ( . ) and underscores ( _ ). Each of the 32 group names must be unique. group_key is: tm for type/model sn for serial number by for bay number server_group is: Type/model or serial number (maximum 31 characters). The wildcard character (*) is accepted. Bay designations that meet the following criteria: Maximum string length of 127 characters. One or more bay-type keywords (blade and switch are the only keywords supported at this time), each followed by a comma delimited list of bay numbers or range of bay numbers (two bay numbers separated by a dash) surrounded by parentheses. Bay-type keywords can be in any order separated by a comma. Individual bay numbers and ranges can be in any order. Overlapping ranges and whitespace are allowed. For example: blade (1, 3, 4-6, 8, 2-5, 12, 13-14) blade (3), blade (5-9, 2) switch (1-2), blade (1), switch (4) This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Modify power schedule	Changes values for the specified power schedule. Note You can modify any valid subset of values for the power schedule. If the frequency (-f) is set to once, you must specify either a time (-t), a date (-d), or both a time and date. If only a date is specified, the scheduled action will take place when the system switches to the date indicated. If the frequency (-f) is set to daily, you must specify a time (-t). If the frequency (-f) is set to weekly, you must specify both a time (-t) and a day (-d).	`pwrprofile -i` index -s status -a action -f freq -d day -t time where: where index is the index number that identifies the power schedule to modify. Index numbers are assigned automatically at schedule creation and can be seen in the Display all power groups and schedules list. status is a power schedule status of enabled or disabled. action is the power action to perform: on, off, cycle, or softoff. freq is how often the schedule is applied: once, daily, or weekly. day is: For frequency of once, a date in mmddyyyy format. For weekly frequency: mon, tues, wed, thur, fri, sat, or sun. time is the time of day in hhmm format. This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Delete power group	Deletes the specified power group. Important The power group index must be the first command option specified (for example, `pwrprofile -1 -clear` ).	`pwrprofile -`group_index `-clear` where group_index is the index number that identifies the power group. Index numbers are assigned automatically at group creation and can be seen in the Display all power groups and schedules list. This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Delete power schedule	Deletes the specified power schedule.	`pwrprofile -clear -i` index where index is the index number that identifies the power schedule. Index numbers are assigned automatically at schedule creation and can be seen in the Display all power groups and schedules list. This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.

Example:

To display information for all power profiles, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type

pwrprofile

To add a power profile named g1 that is keyed by bay number and includes the compute nodes in node bays 1 and 2, and the I/O module in I/O-module bay 3, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type

pwrprofile -add -n g1 -key by -servers blade(1,2),switch(3)

To add a power schedule to power group g1 (index 1) and enable this new power schedule that turns on the compute nodes in power group 1 once on 11 November 2015 at 11:11 AM, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type

pwrprofile -1 -add -s enabled -a on -f once -d 11202015 -t 1111

To delete power schedule 1, while the primary CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type

pwrprofile -i 1 -clear

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

system:mm[2]> pwrprofile
No group found
<span className="ph">system:mm[2]>  pwrprofile -add -n g1 -key by -servers blade(1,2),switch(3)</span>
Group 1 added
system:mm[2]>  pwrprofile

1. g1
   key: by
<span className="ph">   servers: blade(1,2),switch(3)</span>
   power schedules: Not Available

system:mm[2]>  pwrprofile -1 -add -s enabled -a on -f once -d 11202015 -t 1111
Power schedule 1 added
system:mm[2]>  pwrprofile

1. g1
   key: by
<span className="ph">   servers: blade(1,2),switch(3)</span>
   power schedules:

        -i 1
        -s enabled
        -a on
        -f once
        -d 11/20/2015
        -t 1111

system:mm[2]>  pwrprofile -i 1 -clear
OK
system:mm[2]>  pwrprofile

1. g1
   key: by
<span className="ph">   servers: blade(1,2),switch(3)</span>
   power schedules: Not Available

system:mm[2]>  pwrprofile -1 -clear
OK
system:mm[2]>  pwrprofile
No group found
system:mm[2]>

Give documentation feedback