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,Any

rack,Any,Any

r*i*

rack,upos,Any,IRURTR+IRUCOMP

rack,upos,IRU

r*q*

rack,upos,Any, QCRRTR

rack,u, QCR

r*i*b*

rack,upos,slot,IRUCOMP

N/A

r*i*r*

rack,upos,slot,IRURTR

N/A

r*q*r*

rack,upos,slot,QCRRTR

N/A

*c

N/A

Any,Any,Any

r*i*c

N/A

rack,upos,IRU

r*q*c

N/A

rack,upos, QCR

allb,allc

Any,Any,Any,IRUCOMP

N/A

allbi,allci

ANY,ANY,ANY,IRUIO

N/A

allr

Any,Any,Any,IRURTR+QCRRTR

N/A

allri

Any,Any,Any,IRUCOMP+IRURTR

N/A

allrq

Any,Any,Any,QCRRTR

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).

IRUIO - IRU computer blades with an IO riser (blade slots 0 through 15 on Altix UV 1000, or 0 through 2 on Altix UV 100)

IRURTR - IRU router blades (router slots 0 through 3)

QCRRTR - Quad Compact Router (QCR) router blades (slots 0 through 3)

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
        console    access system consoles
        help       list available commands
        hel        access hardware error logs
        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.


auth

The auth command is currently only used to set the APPWT limit for export compliance. You need to obtain the key and reset the limit if needed.

You can get a usage statement, as follows:

CMC:r014i01c> auth --help

usage: auth  [-ard] [-s <SSN>] <key> [<key>]... [--help] [TARGET]...
-s, --ssn=<SSN>           system serial number change
-a, --appwt               APPWT change
-r, --reset               set learn mode
-d, --disable             disable authentication
<key>                     authentication keys
--help                    display this help and exit


bios

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

CMC:r1i1c> bios
==== 4/4 BMC(s) ====
Last booted: SGI BIOS Version 2 Revision 0 built in 20101012_1502 by ajm on Oct 12 2010 at 15:08:29

You can get a usage statement, as follows:

CMC:r1i1c> bios --help

usage: bios  [-rsuv] [--help] [TARGET]...
-r, --revision            display last BIOS revision banner
-s, --state               display current BIOS state
-u, --uptime              display time since last BIOS reset
-v, --verbose             verbose output
--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 [-t] exec <command> [--timeout=<seconds>] [TARGET]...
exec                      executes command on BMC(s)
<command>                 command to execute
--timeout=<seconds>       timeout value
-t, --terse               terse mode

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 [-v] runtime [TARGET]...
runtime                   show daemon run time
-v, --verbose             verbose mode

usage: bmc reboot [TARGET]...
reboot                    initiates controller reboot

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 [-t] exec <command> [--timeout=<seconds>] [TARGET]...
exec                      executes command on CMC(s)
<command>                 command to execute
--timeout=<seconds>       timeout value
-t, --terse               terse mode

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 [-v] runtime [TARGET]...
runtime                   show daemon run time
-v, --verbose             verbose mode

usage: cmc reboot [TARGET]...
reboot                    initiates controller reboot

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

config

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

CMC:r1i1c> config -v

CMCs:            1
        r001i01c UV1000 SMN

BMCs:            4
        r001i01b00 IP93-BASEIO
        r001i01b01 IP93-DISK
        r001i01b02 IP93
        r001i01b03 IP93

Partitions:      1
        partition000 BMCs:    4

Accessories:     0

You can get a usage statement, as follows:

CMC:r1i1c> config --help 
usage: config  [-v] [-a <ip>@<location>] [--pcheck] [<TARGET>]... [--help]
-v, --verbose             verbose output
-a, --acc=<ip>@<location>
                configure accessory location
                <location> is <rack>.<uposition> for IO
                <location> is <rack>.<0|1> for PDUs (0=left, 1=right)

--pcheck                  check for targets crossing partitions
--help                    display this help and exit

console (uvcon)

The console (uvcon) 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:

CMC:r014i01c> console --help

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

 escape codes:                              
    ctrl-] s    steal console               
    ctrl-] r    release console             
    ctrl-] ?|h  this help                   

usage: console -d[band23cCft] [-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 cached output after dumping
-C, --CLEAR                    clear cached output without dumping
-f, --full                     full dump (default is since last reset)
-t, --tag                      prefix each line with source
TARGET                         console target

usage: console [-bnd23] -i <input> [TARGET]...
-i, --input=<input>            backdoor console input
-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)
TARGET                         console target

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 [-vchosw] on|up [bmc] [--noio] [TARGET]...
on|up                     turn power on
bmc                       turn aux power on
--noio                    do not power on accessories (IO)
-v, --verbose             verbose output
-c, --clear               clear EFI variables (system/partition targets only)
-h, --hold                hold in reset
-o, --override            override partition check
-s, --single              single node boot
-w, --watch               watch boot progress

usage: power [-vo] off|down [bmc] [--noio] [--nochassis] [TARGET]...
off|down                  turn power off
bmc                       turn aux power off
--noio                    do not power off accessories (IO)
--nochassis               do not power off chassis power
-v, --verbose             verbose output
-o, --override            override partition check

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

usage: power [-vchosw] cycle [bmc] [--noio] [--nochassis] [TARGET]...
cycle                     cycle power off on
bmc                       cycle aux power
--noio                    do not power cycle accessories (IO)
--nochassis               do not power cycle chassis power
-v, --verbose             verbose output
-c, --clear               clear EFI variables (system/partition targets only)
-h, --hold                hold in reset
-o, --override            override partition check
-s, --single              single node boot
-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 cancel [TARGET]...
cancel                    cancel outstanding power action

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 is now just an alias to the console command. See “console (uvcon)”.