Chapter 3. Altix UV CMC Software Commands

You can use SGI Altix UV controller commands to monitor and manage SGI Altix UV systems. 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

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

You can get a usage statement, as follows:

CMC:r1i1c> power --help

usage: power [-vco] on|up [TARGET]...
on|up                     turn power on
-v, --verbose             verbose output
-c, --clear               clear EFI variables
-o, --override            override partition check

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

usage: power [-vcho] reset [TARGET]...
reset                     toggle reset
-v, --verbose             verbose output
-c, --clear               clear EFI variables
-h, --hold                hold reset high
-o, --override            override partition check

usage: power [-v] ioreset [TARGET]...
ioreset                   toggle I/O reset
-v, --verbose             verbose output

usage: power [-vcho] cycle [TARGET]...
cycle                     cycle power off on
-v, --verbose             verbose output
-c, --clear               clear EFI variables
-h, --hold                hold reset high
-o, --override            override partition check

usage: power [-vo] status [TARGET]...
status                    show power status
-v, --verbose             verbose output
-o, --override            override partition check

usage: power [-v] nmi|debug [TARGET]...
nmi|debug                 issue NMI
-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 --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

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.