remotechassis command

This command displays and manages the list of each Lenovo Flex System chassis that the CMM discovers on the network.

Note: The CMM that runs the remotechassis command is also included in all lists.

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

Table 1. remotechassis 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 complete list Displays a list of all Lenovo Flex System chassis that the CMM discovers on the network. The list includes the following information about each Lenovo Flex System chassis:
  • Name
  • IP address
  • Status
  • Firmware level
  • Type
  • Serial number
  • FRU number
  • Chassis serial number
  • Chassis FRU number
  • Chassis machine-type model (MTM)
  • Chassis UUID
 remotechassis
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display list grouped by health status Displays a list of names for Lenovo Flex System chassis that the CMM discovers on the network. The list is grouped by health status. remotechassis -health
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display list filtered by IP address Displays a list of Lenovo Flex System chassis that the CMM discovers on the network, filtered by the specified IP address. The list includes the following information about each Lenovo Flex System chassis:
  • Name
  • IP address
  • Status
  • Firmware level
  • Type
  • Serial number
  • FRU number
  • Chassis serial number
  • Chassis FRU number
  • Chassis machine-type model (MTM)
  • Chassis UUID
 remotechassis -ip ip_address

where ip_address is an IP address pattern that uses the asterisk (*) as a wildcard (for example; 201.47.123.*).
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display list filtered by name Displays a list of Lenovo Flex System chassis that the CMM discovers on the network, filtered by the specified name. The list includes the following information about each Lenovo Flex System chassis:
  • Name
  • IP address
  • Status
  • Firmware level
  • Type
  • Serial number
  • FRU number
  • Chassis serial number
  • Chassis FRU number
  • Chassis machine-type model (MTM)
  • Chassis UUID
 remotechassis -name name

where name is a name pattern that uses the asterisk (*) as a wildcard (for example; WebServer*).
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Clear list Clears the list of Lenovo Flex System chassis that the CMM discovered on the network. remotechassis -clear
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.

Example:

To list all Lenovo Flex System chassis on the network with a name starting with "WebServer", while the primary CMM in bay 1, that does not support IPv6, is set as the persistent command environment, at the system:mm[1]> prompt, type 
remotechassis -name WebServer*

The following example shows the information that is returned from this command:

system:mm[1]> remotechassis -name WebServer*
Running chassis discovery...
------------------------------------------------
Name:           WebServer001
IP:             145.48.204.212
Status:         normal
Firmware:       BPET25L,CNETMNUS.PKT,01-08-07,37,1
Type:           CMM
Serial:         0J1M9E585630
FRU:            25R5777
Chassis Serial: 23A2343
Chassis FRU:    25R5780R5780
Chassis MTM:    885222Z
Chassis UUID:   4E349451FA8011D9B10C89E0183AD13D
------------------------------------------------
Name:           WebServer002
IP:             145.48.204.222
Status:         normal
Firmware:       BPET25L,CNETMNUS.PKT,01-08-07,37,1
Type:           CMM
Serial:         0J1M9E585656
FRU:            25R5777
Chassis Serial: 23A2356
Chassis FRU:    25R5780R5780
Chassis MTM:    885222Z
Chassis UUID:   4E325951FA8011D9B86C89E0183AD02D
------------------------------------------------
system:mm[1]>
To list all Lenovo Flex System chassis on the network with a name starting with "SYSTEM*", while the primary CMM in bay 1, that supports IPv6, is set as the persistent command environment, at the system:mm[1]> prompt, type 
remotechassis -name SYSTEM*

The following example shows the information that is returned from this command:

system:mm[1]> remotechassis -name SYSTEM*
Running chassis discovery...
------------------------------------------------
Name:           SYSTEM
IP:             10.13.1.190
IPv6:           2002:1013::211:25ff:fec3:227c
                2001:1013::211:25ff:fec3:227c
                2000:1013::211:25ff:fec3:227c
                fe80::211:25ff:fec3:227c
                2000:1013::a1be:a348:7672:2def
                2000:1013::1:191
Status:         critical
Firmware:       BPET002,CNETMNUS.PKT,02-17-10,1
Type:           CMM
Serial:         YK118165A117
FRU:            39Y9661
Chassis Serial: KQWPLB9
Chassis FRU:    44X2302
Chassis MTM:    8852HC1
Chassis UUID:   E13112E1829448E29999DA2066681D89
------------------------------------------------
Name:           SYSTEM
IP:             10.13.1.30
IPv6:           2000:1013::fc58:325c:c8b4:9c4c
                2000:1013::214:5eff:fed0:2e1c
                2000:1013::1:30
                fe80::5652:ff:fe69:d763
                2002:1013::211:25ff:fec3:8cfa
                2001:1013::211:25ff:fec3:8cfa
                2000:1013::211:25ff:fec3:8cfa
                fe80::211:25ff:fec3:8cfa
Status:         attention
Firmware:       BPET54A,CNETMNUS.PKT,02-17-10,84
Type:           CMM-telco
Serial:         YK118269Y115
FRU:            39Y9661
Chassis Serial: 23A0052
Chassis FRU:    42C3673
Chassis MTM:    87501RZ
Chassis UUID:   B5BAEC01A10B11DB9F3BC1BE8FFF3B3C
------------------------------------------------
system:mm[1]>
Parent topic: Command reference