restartcmm command

Use the restartcmm command to restart or cause failover of one or both of the Chassis Management Modules (CMM) of a Flex System Enterprise Chassis.

Synopsis

smcli restartcmm [-h | -? | --help]

smcli restartcmm [-v] [-t type] {-a | -n system_list | -N group_list | -i ip_address_list | -w query | -f file} [-t type] restart_operation

Description

The restartcmm command performs restart or failover operations for one or both of the CMMs of an Flex System Enterprise Chassis. You can run this command only against accessible managed resources.

Operands

restart_operation is a required operand and must be one of the following values:
  • RestartPrimary: Restart the primary CMM
  • RestartStandby: Restart the standby CMM
  • SwitchOverCMMCalledByPrimary: Restarts the primary CMM, then switches over to the standby CMM.
  • SwitchOverCMMCalledByStandBy: Reboots the primary CMM as the non-active module, then switches over to the standby CMM. All existing network connections are temporarily interrupted.
  • VirtualReseatPrimary: Virtual reseat of primary CMM
  • Support: Lists the restart operations supported for the targeted systems

Options

-a | --all
Targets all managed systems.
-f | --file {file_name | -}
Targets the managed systems specified in the file file_name or from a standard input pipe.

To retrieve input piped from another command, specify a hyphen (-) instead of a file name (for example, smcli cmd1 | smcli cmd2 -f -). To retrieve input from a file, specify the full path. If the path contains spaces, enclose it in quotation marks.

-h | -?
Displays the syntax and a brief description of the command.
Tip: If you specify additional options other than -h | -? | --help, the options are ignored.
--help
Displays detailed information about the command, including the syntax, a description of the command, a description of the options and operands, error codes, and examples.
Tips:
  • If you specify additional options other than -h | -? | --help, the options are ignored.
  • You can also display detailed help in the form of man pages using the man command_name command.
-i | --ipaddress {ip_address}[,{ip_address}...]
Targets one or more systems, specified by IP address. Separate the IP addresses by a comma.
ip_address
The IP address of the system.
Tips:
  • You can enter lssys -A IP_address to list the IP address of each discovered system.
  • You can use either the IPv4 or IPv6 format to specify the IP address.
-N | --groups {group_oid | group_name}[,{group_oid | group_name}...]
Targets all systems in one or more specified groups that are identified by name or ID.

The list can be a mixture of group names and IDs, separated by a comma.

Tips:

  • If the same systems are members of more than one group, they are targeted only once.

  • To target all systems, specify the "All Systems" group.
group_oid
The unique ID of the group, specified as a hexadecimal value prefixed with 0x (for example, 0x3e7).
Tip: Use the lsgp -o command to list all group IDs.
group_name
The name of the group. If the group name contains spaces, enclose it in quotation marks. If it contains a comma, prefix the comma with a backslash (\) and enclose the name in quotation marks.
Tips:
  • Group names are unique.
  • Use the lsgp command without any options to list all group names.
  • The group names are not locale specific.
-n | --names {system_oid | system_name}[,{system_oid | system_name}...]
Targets one or more managed systems specified by name or ID.

The list can be a mixture of system names and IDs, separated by a comma.

system_oid
The unique ID of the system, specified as a hexadecimal value prefixed with 0x (for example, 0x37) or a decimal value (for example, 123).
Tip: Use the lssys -o command to list all system IDs.
system_name
The name of the system. If the system name contains a comma, prefix the comma with a backslash (\).
Tips:
  • The system names might not be unique. This command acts on all systems with the specified name. Use the -v | --verbose option to generate a message when this command targets multiple systems with the same name. To target a particular system that has a name that is not unique, identify the system by specifying its unique, hexadecimal ID, or use additional target options to refine the selection.
  • Use the lssys command without any options to list all system names.
  • The system names are not locale specific.
-t | --type system_type

Narrows the specified targeted systems to all systems of the specified type.

-v | --verbose
Writes verbose messages to standard output.

If this option is not specified, this command suppresses noncritical messages.

-w | --where "query"
Targets one or more systems based on system attributes specified by query.
The query operand is a string, enclosed in quotation marks, that defines a simple SELECT query using the following format:
"attribute_key=value [{AND | OR} attribute_key=value...]"

where attribute_key can be any valid attribute, and value is the value of the attribute. The value must match the expected type for the associated attribute. For example, if the attribute is of type integer, an integer must be specified.

Tips:
  • Use logical operators AND or OR to combine attributes.
  • Use parentheses to create nested logical constructs.
  • The query operand must be enclosed in quotation marks. Do not use double quotation marks in the query.
  • If the value contains spaces, enclose it in single quotation marks.
  • Only system attributes can be specified. Use the lssys -l command to list the available system attributes.

Exit status

The following codes are returned by this command.
  • 0: The operation completed.
  • 1: A usage error occurred.
  • 2: The command or bundle was not found.
  • 3: The command was not performed because either authentication failed or you are not authorized to perform the action.
  • 10: The file was not found.
  • 20: A specified system is not valid.
  • 21: A specified system group is not valid.
  • 25: A number-formatting error occurred.
  • 29: The specified locale is not valid or not supported.
  • 50: A specified restart operation is not valid.
  • 51: The restart operation failed.
  • 52: One or more managed systems were not accessible.

Examples

  1. Restart the primary CMM

    This example illustrates how to restart (reboot) the primary CMM in the group1 group. 

    smcli restartcmm -N group1 RestartPrimary