Chapter 3. Altix UV CMC Software Commands

You can use SGI Altix UV controller commands to monitor and manage SGI Altix UV systems. You can use them from the SGI Management Node command line interface (CLI) or the chassis manager controller (CMC) CLI.

Typically, commands available from the SMN or CMC command line are in the form of:

command [options] [targets]

For available commands see below or type "help" at the SMN/CMC prompt. Commands are located in /sysco/bin on both the SMN and CMC. For options available with each command, type "command -help".

CMC Command Targets

Multiple targets may be specified, if no targets are specified, all BMCs or CMCs (as appropriate for a command) are assumed. Some targets may need to be quoted to avoid wildcard expansion by the SMN/CMC shell.

Table 3-1. CMC Command Targets

Command Target

BMCs (rack,upos,slot,BMC type)

CMCs (rack,upos,CMC type)

*,all

Any,Any,Any,Any

Any,Any,Any

r*

rack,Any,Any

rack,Any,Any

r*i*

rack,upos,Any,IRUCOMP

rack,upos,IRU

r*q*

rack,upos,Any,

rack,u,

r*i*b*

rack,upos,slot,IRUCOMP

N/A

r*i*r*

rack,upos,slot,

N/A

r*q*r*

rack,upos,slot,

N/A

*c

N/A

Any,Any,Any

r*i*c

N/A

rack,upos,IRU

r*q*c

N/A

rack,upos,

allb,allc

Any,Any,Any,IRUCOMP

N/A

allr

Any,Any,Any

N/A

allri

Any,Any,Any

N/A

allrq N/A

Any,Any,Any,IRUCOMP

N/A

p*

all IRUCOMP with matching partition

N/A

An asterisk references all values in that position such that r* references all racks, i* references all IRUs, etc. A decimal number can replace any asterisk to narrow the target selection. Ranges are not support but a space separated list of targets is supported.

BMC Types

IRUCOMP - IRU computer blades (blade slots 0 through 15 on Altix UV 1000, or 0 through 1 on Altix UV 100).

CMC Types 

IRU - Altix UV 1000 or Altix UV 100


Note: Most of the commands (bios, bmc, cmc, config, hwcfg, log, power, uvcon (console)) are available at both the CMC prompt (as user root), as well as, the system management node (SMN) prompt (as user sysco).

The available commands on the CMC are, as follows:

CMC:r1i1c> help
available commands are:

        auth       authenticate SSN/APPWT change
        bios       perform bios actions
        bmc        access BMC shell
        cmc        access CMC shell
        config     show system configuration
        help       list available commands
        hwcfg      access hardware configuration variable
        leds       display system LED values
        log        display system controller logs
        power      access power control/status

type '<cmd> --help' for help on individual command.

bios

Use the bios command to get BIOS information for your system after it is powered on, as follows:

CMC:r1i1c> bios
==== r001i01b00 ====
SGI BIOS Version 1 Revision 2 built in 20100506_1553 by ajm on May  6 2010 at 16:02:59
==== r001i01b01 ====
SGI BIOS Version 1 Revision 2 built in 20100506_1553 by ajm on May  6 2010 at 16:02:59
==== r001i01b02 ====
SGI BIOS Version 1 Revision 2 built in 20100506_1553 by ajm on May  6 2010 at 16:02:59
==== r001i01b03 ====
SGI BIOS Version 1 Revision 2 built in 20100506_1553 by ajm on May  6 2010 at 16:02:59
==== r001i01b04 ====
SGI BIOS Version 1 Revision 2 built in 20100506_1553 by ajm on May  6 2010 at 16:02:59
==== r001i01b05 ====
SGI BIOS Version 1 Revision 2 built in 20100506_1553 by ajm on May  6 
				 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	....	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	

You can get a usage statement, as follows:

CMC:r1i1c> bios --help

usage: bios  [-v] [--help] [TARGET]...
-v, --version             display last BIOS version/banner
--help                    display this help and exit

bmc

Allows you to send a command to one or more board management controllers (BMCs). It is a shell command similar in behavior to the ssh command.

You can get a usage statement, as follows:

CMC:r1i1c> bmc --help

usage: bmc exec <command> [-t <seconds>] [TARGET]...
exec                      executes command on BMC(s)
<command>                 command to execute
-t, --timeout=<seconds>   timeout value

usage: bmc list [TARGET]...
list                      list active shells on BMC(s)

usage: bmc kill [TARGET]...
kill                      kill all active shells on BMC(s)

usage: bmc --help
--help                    display this help and exit


cmc

Allows you to send a command to one or more chassis manager controllers (CMCs). It is a shell command similar in behavior to the ssh command.

CMC:r1i1c> cmc --help

usage: cmc exec <command> [-t <seconds>] [TARGET]...
exec                      executes command on CMC(s)
<command>                 command to execute
-t, --timeout=<seconds>   timeout value

usage: cmc list [TARGET]...
list                      list active shells on CMC(s)

usage: cmc kill [TARGET]...
kill                      kill all active shells on CMC(s)

usage: cmc --help
--help                    display this help and exit

config

The CMC cofig command shows your system configuration, as follows:

CMC:r1i1c> config -v

CMCs:            1
        r001i01c UV1000 

BMCs:            2
        r001i01b00 IP93-BASEIO 
        r001i01b01 IP93-DISK 

Partitions:      1
        partition000 BMCs:    2

Time since last update: 1:23:53

You can get a usage statement, as follows:

CMC:r1i1c> config --help 

usage: config  [-v] [--help]
-v, --verbose             verbose output
--help                    display this help and exit

console (uvcon)

The console (uncon) command allows allows you to open a console window on the CMC or BMC or even a compute blade. Use CTRL -] q to exit. A usage statement is, as follows:

usage: console [-bnd23] [--steal] [--spy] [--kill] [--notty] [--nocache] [--clrcache] [TARGET]
   -b, --baseio                   specifies baseio bmc console
   -n, -0, --normal               specifies node BMC console (normal channel)
   -d, -1, --debug                specifies node BMC console (debug channel)
   -2, --chan2                    specifies node BMC console (channel 2)
   -3, --chan3                    specifies node BMC console (channel 3)
   --steal                        steal the console
   --spy                          spy the console
   --kill                         kill all other uvcon sessions
   --notty                        disables tty interventions
   --nocache                      don't return cached output
   --clrcache                     clear cached output
   TARGET                         console target
                                  
   NOTE: When tty mode is enabled, use 'CTRL-]' 'q' to exit.
   
   usage: console -d[band23c] [-l <count>] [TARGET]...
   -d, --dump                     dump cached console output
   -b, --baseio                   specifies baseio bmc console
   -a, --all                      all node BMC consoles
   -n, -0, --normal               specifies node BMC console (normal channel)
   -d, -1, --debug                specifies node BMC console (debug channel)
   -2, --chan2                    specifies node BMC console (channel 2)
   -3, --chan3                    specifies node BMC console (channel 3)
   -l, --lines=<count>            limit output to last <count> lines
   -c, --clear                    clear after dumping (-cc to clear without dumping)
   TARGET                         console target(s)
   
   usage: console --help
   --help                         display this help and exit

flashbios

Use the flashbios command to flash the latest BIOS located in the /work/bmc/common directory on your CMC. For an example of how this command is used, see “Upgrading System BIOS” in Chapter 2.

You can get a usage statement, as follows:

CMC:r1i1c> flashbios --help
Illegal option --
NAME
        flashbios -- Flash UV BIOS from CMC

SYNOPSIS
        flashbios [-e] [-n] [flashfile]

DESCRIPTION
        The file specified by flashfile is flashed into the flash devices
        on all nodes of the UV system.  By default the system will be
        automatically reset after the flash completes.

        The flash file must be located in the CMC directory /work/bmc/common
        on the CMC.  The default name of the flash file is 'bios.latest.fd'.

        The following options are available:

        -e      Erase BIOS variables and BIOS scratch space while
                resetting the system.  This option will be ignored
                if '-n' is also specified.

        -n      Do not automatically reset the system.

hwcfg

The hwcfg command can be used to access hardware override variables.

CMC:r1i1c> hwcfg -a -v
BLADE_DISABLE=no
DEBUG_SW=0x0
HUB_CORE_SPEED=400
ICH_DISABLE=no
IORISER_DISABLE=no
MAX_CORES=0
NL5_CABLE_ENABLE=yes
NL5_ENABLE=yes
NL5_HUB2_WAR=no
NL5_NEAR_LB=no
NL5_RATE=6.25
NL5_SCRAMBLE=0x0
PARTITION=0
SMT_ENABLE=no
SOCKET_DISABLE=no

Here is an example showing a system with four partition.

uv32-cmc CMC:r1i1c> hwcfg -a -v
NL5_RATE=5.0
PARTITION=1 ................................................ 16/64 BMC(s)
PARTITION=2 ................................................ 16/64 BMC(s)
PARTITION=3 ................................................ 16/64 BMC(s)
PARTITION=4 ................................................ 16/64 BMC(s)

You can use hwcfg -c to clear the four partitions, as follows:

uv32-cmc CMC:r1i1c> hwcfg -c partition
PARTITION=0 <PENDING RESET>

You can get a usage statement, as follows:

CMC:r1i1c> hwcfg --help

usage: hwcfg  [-dv] [var[=val]]... [--help] [TARGET]...

var[=val]                 variable [and value to set]
-d, --default             reset variable(s) to default value
-v, --verbose             show variable(s) regardless of override state
--help                    display this help and exit, use with variable(s) to get specific help

log

Provides a log of various operations performed on the CMC.

power

The CMC power command allows you to power on, power off, reset, cycle, get status and invoke the kernel debugger (KDB). When using the power command, you no longer have to power up the individual rack unit (IRU). When you issue the power command, it checks to see if the IRU is powered on, if not, it will power it up first and then the compute blades.

You can get a usage statement, as follows:

CMC:r1i1c> power --help

usage: power [-vcow] on|up [bmc] [TARGET]...
on|up                     turn power on
bmc                       turn aux power on
-v, --verbose             verbose output
-c, --clear               clear EFI variables (system and partition targets only)
-o, --override            override partition check
-w, --watch               watch boot progress

usage: power [-vo] off|down [bmc] [TARGET]...
off|down                  turn power off
bmc                       turn aux power off
-v, --verbose             verbose output
-o, --override            override partition check

usage: power [-vchow] reset [bmc|iobmc] [TARGET]...
reset                     system reset
bmc|iobmc                 BMC reset
-v, --verbose             verbose output
-c, --clear               clear EFI variables (system and partition targets only)
-h, --hold                hold reset high
-o, --override            override partition check
-w, --watch               watch boot progress

usage: power [-vhow] cycle [bmc] [TARGET]...
cycle                     cycle power off on
bmc                       cycle aux power
-v, --verbose             verbose output
-h, --hold                hold reset high
-o, --override            override partition check
-w, --watch               watch boot progress

usage: power [-v10ud] [status] [TARGET]...
status                    show power status
-v, --verbose             verbose output
-1, --on                  show only blades with on status
-0, --off                 show only blades with off status
-u, --unknown             show only blades with unknown status
-d, --disabled            show only blades with disabled status

usage: power [-ov] nmi|debug [TARGET]...
nmi|debug                 issue NMI
-o, --override            override partition check
-v, --verbose             verbose output

usage: power [-v] margin [high|low|norm|<value>] [TARGET]...
margin                    power margin control
high|low|norm|<value>     margin state
-v, --verbose             verbose output

usage: power on|off|cycle|reset all|c|<slot#>
on|off|cycle|reset        control aux power or BMC reset
all|c|<slot#>             blade slot

usage: power --help
--help                    display this help and exit

sensor

Only valid for CMC data in this form. Use the sensor command to get system temperatures, fan speed, and voltage information and so on, as follows:

CMC:r1i1c> sensor

Use the command from the cmc or bmc, as follows:

cmc sensor
bmc sensor

showbios

Use the showbios command to show the latest BIOS version used on your system, as follows:

CMC:r1i1c> showbios
Flashed on Sat May  1 14:14:45 UTC 2010 was bios.latest.fd (20100429_1603)

uvcon

The uvcon command allows you to open a console window on the CMC or BMC or even a compute blade. Use CTRL -] q to exit.

You can get a usage statement, as follows:

CMC:r1i1c> uvcon --help
usage: uvcon [-bnd23] [--smn=<hostname>] [--cmc=<hostname>] [--steal] [--spy] [--kill] [--dump] [--notty] [--nocache] [--help] [TARGET] Note:
--smn=<hostname>               SMN hostname
--cmc=<hostname>               CMC hostname
-b, --baseio                   specifies baseio bmc console
-n, --normal                   specifies nbmc console (normal channel)
-d, --debug                    specifies nbmc console (debug channel)
-2, --chan2                    specifies nbmc console (channel 2)
-3, --chan3                    specifies nbmc console (channel 3)
--steal                        steal the console
--spy                          spy the console
--kill                         kill all other uvcon sessions
--dump                         dump the cached console, exit
--notty                        disables tty interventions
--nocache                      don't return cached output
--help                         display this help and exit
TARGET                         console target
                               
Note: When tty mode is enabled, use 'CTRL-]' 'q' to exit.