Skip to main content

Command targets

You can set a persistent command target for the CMM CLI or send individual CLI commands to a specific target.

You can use the command-line interface to target commands to the Flex System chassis, the CMM, or to other devices installed in the chassis. The command-line prompt indicates the persistent command environment: the target where commands are directed unless another target is specified. You can specify a command target by using the full target name or by using a target name that is relative to the persistent command environment.

When a command-line interface session is started, the persistent command environment is system ; this indicates that commands are being directed to the Flex System chassis.

The following table lists Flex System components that are supported as command targets. Target names have been selected to maintain scripting compatibility with other Lenovo systems.

To direct commands to a specific command target, its path name must be specified, either as a full path name or as a path name based on the current persistent command environment. To view path names for targets in your Flex System chassis, use the list command.

Table 1. Valid command targets
ComponentTarget path
Flex System chassissystem
CMM (by bay number)mm[x]
CMM (primary)mm[p] or mm[P]
CMM (standby)mm[s] or mm[S]
Compute nodeblade[x]
Logical node groupingbladegroup[x]
System-management processorsp
Expansion adapterexp[x]
Compute node management cardmgmtcrd[x]
Compute node microprocessorcpu[x]
Expansion nodebe[x]
Compute node high-speed expansion cardhsec[x]
Compute node memorymemory[x]
Compute node flash DIMM (Lenovo eXFlash Storage DIMM)flashdimm[x]
Storage expansion enclosurebladeenclosure[x]
Storage diskdisk[x]
Alarm paneltap[x]
Storage backplanestgbkplane[x]
Add-in cardaddin[x]
Add-in card PCI-Express modulepciexpress[x]
I/O (switch) moduleswitch[x]
Power supplypower[x]
Fan logic modulefanmux[x]
Fan moduleblower[x]
Rear LED cardmt[x]

You can change the persistent command environment for the remainder of a command-line interface session by using the env command (see env command). When you list the target as a command attribute by using the -T option, you change the target environment for the command that you are entering, temporarily overriding the persistent command environment. You can specify target environments by using the full path name or by using a partial (relative) path name that is based on the persistent command environment. Full path names always begin with system. The levels in a path name are divided using a colon ( : ).

For example:

  • Use the -T system:mm[1] option to redirect a command to the CMM in bay 1.
  • Use the -T system:switch[1] option to redirect a command to the I/O module in I/O bay 1.
  • Use the -T sp option to redirect a command to the system-management processor in the compute node in node bay 3, when the persistent command environment is set to the compute node in node bay 3.
  • Use the -T bladegroup[1]:blade[1] option to redirect a command to the first compute node in a logical node grouping in node bay 1, when the persistent command environment is set to the Flex System chassis.

Most CMM commands must be directed to the primary CMM. If only one CMM is installed in the Flex System chassis, it always acts as the primary CMM. Either CMM can function as the primary CMM; however, only one CMM can be primary at one time. You can determine which CMM is acting as the primary CMM by using the list command (see list command).

Commands can be directed to the primary CMM, regardless of its bay location, using the -T system:mm[p] or -T system:mm[P] option. Commands can be directed to the standby CMM, regardless of its bay location, using the -T system:mm[s] or -T system:mm[S] option.

Example: To display a hierarchical list of all command targets in the Flex System chassis, while the chassis is set as the persistent command environment, at the system> prompt, type
list -l a

The following example shows the information that might be returned when the command is run:

system> list -l a
system
blade[1] Server1
sp
cpu[1]
tap[1]
stgbkplane[1]
be[1]
addin[1]
hsec[2]
addin[2]
memory[1]
memory[4]
addin[1]
blower[1]
blower[2]
blower[5]
blower[6]
blower[7]
blower[10]
power[1]
blower[1]
power[2]
blower[1]
mm[1] standby
mm[2] primary
switch[1]
mt[1]
fanmux[1]
fanmux[2]
system>

The following table shows each target with its full path. This is the path that would be used if the persistent command environment was set to the Flex System chassis.

Table 2. Example system components and command paths
ComponentTarget path
Flex System chassissystem
Compute node, bay 1 (named Server1)system:blade[1]
Node system-management processor, compute node bay 1system:blade[1]:sp
Microprocessor, compute node bay 1system:blade[1]:cpu[1]
Alarm panel, compute node bay 1system:blade[1]:tap[1]
Storage backplane, compute node bay 1system:blade[1]:stgbkplane[1]
Expansion node 1, compute node bay 1system:blade[1]:be[1]
Add-in card 1, expansion node 1, compute node bay 1system:blade[1]:be[1]:addin[1]
High-speed expansion card 2, add-in card 1, expansion node 1, compute node bay 1system:blade[1]:be[1]:addin[1]hsec[2]
Add-in card 2, expansion node 1, compute node bay 1system:blade[1]:be[1]:addin[2]
Memory module 1, compute node bay 1system:blade[1]:memory[1]
Memory module 4, compute node bay 1system:blade[1]:memory[4]
Add-in card 1, compute node bay 1system:blade[1]addin[1]
Fan module 1system:blower[1]
Fan module 2system:blower[2]
Fan module 5system:blower[5]
Fan module 6system:blower[6]
Fan module 7system:blower[7]
Fan module 10system:blower[10]
Power supply 1system:power[1]
Fan module, power supply 1system:power[2]:blower[1]
Power supply 2system:power[2]
Fan module, power supply 2system:power[2]:blower[1]
Standby CMM, CMM bay 1system:mm[s] or system:mm[S] or system:mm[1]
Primary CMM, CMM bay 2system:mm[p] or system:mm[P] or system:mm[2]
I/O (switch) module, bay 1system:switch[1]
Rear LED cardsystem:mt[1]
Fan logic module 1system:fanmux[1]
Fan logic module 2system:fanmux[2]

The complete command target hierarchy for the example is shown in the following illustration.


Graphic illustrating an example Lenovo Flex System command target hierarchy.