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.
Component | Target path |
---|---|
Flex System chassis | system |
CMM (by bay number) | mm[x] |
CMM (primary) | mm[p] or mm[P] |
CMM (standby) | mm[s] or mm[S] |
Compute node | blade[x] |
Logical node grouping | bladegroup[x] |
System-management processor | sp |
Expansion adapter | exp[x] |
Compute node management card | mgmtcrd[x] |
Compute node microprocessor | cpu[x] |
Expansion node | be[x] |
Compute node high-speed expansion card | hsec[x] |
Compute node memory | memory[x] |
Compute node flash DIMM (Lenovo eXFlash Storage DIMM) | flashdimm[x] |
Storage expansion enclosure | bladeenclosure[x] |
Storage disk | disk[x] |
Alarm panel | tap[x] |
Storage backplane | stgbkplane[x] |
Add-in card | addin[x] |
Add-in card PCI-Express module | pciexpress[x] |
I/O (switch) module | switch[x] |
Power supply | power[x] |
Fan logic module | fanmux[x] |
Fan module | blower[x] |
Rear LED card | mt[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.
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.
Component | Target path |
---|---|
Flex System chassis | system |
Compute node, bay 1 (named Server1) | system:blade[1] |
Node system-management processor, compute node bay 1 | system:blade[1]:sp |
Microprocessor, compute node bay 1 | system:blade[1]:cpu[1] |
Alarm panel, compute node bay 1 | system:blade[1]:tap[1] |
Storage backplane, compute node bay 1 | system:blade[1]:stgbkplane[1] |
Expansion node 1, compute node bay 1 | system:blade[1]:be[1] |
Add-in card 1, expansion node 1, compute node bay 1 | system:blade[1]:be[1]:addin[1] |
High-speed expansion card 2, add-in card 1, expansion node 1, compute node bay 1 | system:blade[1]:be[1]:addin[1]hsec[2] |
Add-in card 2, expansion node 1, compute node bay 1 | system:blade[1]:be[1]:addin[2] |
Memory module 1, compute node bay 1 | system:blade[1]:memory[1] |
Memory module 4, compute node bay 1 | system:blade[1]:memory[4] |
Add-in card 1, compute node bay 1 | system:blade[1]addin[1] |
Fan module 1 | system:blower[1] |
Fan module 2 | system:blower[2] |
Fan module 5 | system:blower[5] |
Fan module 6 | system:blower[6] |
Fan module 7 | system:blower[7] |
Fan module 10 | system:blower[10] |
Power supply 1 | system:power[1] |
Fan module, power supply 1 | system:power[2]:blower[1] |
Power supply 2 | system:power[2] |
Fan module, power supply 2 | system:power[2]:blower[1] |
Standby CMM, CMM bay 1 | system:mm[s] or system:mm[S] or system:mm[1] |
Primary CMM, CMM bay 2 | system:mm[p] or system:mm[P] or system:mm[2] |
I/O (switch) module, bay 1 | system:switch[1] |
Rear LED card | system:mt[1] |
Fan logic module 1 | system:fanmux[1] |
Fan logic module 2 | system:fanmux[2] |
The complete command target hierarchy for the example is shown in the following illustration.