Advanced Lights Out Management (ALOM) CMT v1.4 Guide

This chapter contains the following sections:

• ALOM CMT Command Shell Overview
• ALOM CMT Shell Commands
• ALOM CMT Shell Command Descriptions

---

ALOM CMT Command Shell Overview

The ALOM CMT command shell is a simple command-line interface (CLI). Through the ALOM CMT command shell, you can administer, diagnose, or control the host server, and you can configure and manage ALOM CMT.

You are in the ALOM CMT command shell when you see the sc> prompt. ALOM CMT supports a total of eight concurrent Telnet sessions and one serial session per server. This means that you can run nine command shell operations at once.

After you log in to your ALOM CMT account, the system controller shell prompt (sc>) appears, and you can enter ALOM CMT shell commands. See Logging In To ALOM CMT Accounts and ALOM CMT Shell Commands for assistance.

Entering Command Options

If the command you want to use has multiple options, you can either enter the options individually or grouped together, as shown in this example. These two commands are identical.

sc> poweroff -f -y 
sc> poweroff -fy 

Related Information

• ALOM CMT Shell Error Messages
• Logging In To ALOM CMT Accounts

---

ALOM CMT Shell Commands

The following table lists the ALOM CMT shell commands and briefly describes what these commands do.

Related Information

• Using ALOM CMT Configuration Variables

---

ALOM CMT Shell Command Descriptions

The following pages provide full descriptions of the ALOM CMT shell commands in alphabetical order.

bootmode

Use the bootmode command to control the behavior of the host server's firmware while the host server is initializing or after you reset the server.

The bootmode normal command option prepares the system controller firmware for reset, retaining the current settings of OpenBoot nonvolatile read-only memory (NVRAM) variables

The bootmode reset_nvram command option sets the OpenBoot NVRAM variables to default settings.

The bootmode command requires that you reset the host server within 10 minutes after issuing the command. If you do not issue the poweroff and poweron commands or the reset command within 10 minutes, the host server ignores the bootmode command. Refer to powercycle, poweron, and reset for more information.

  At the sc> prompt, type the following command:

sc> bootmode reset_nvram 
sc> reset 

  At the sc> prompt, type the following command:

sc> bootmode
sc> reset 

bootmode Command Options

The bootmode command uses the following options.

If you use the bootmode command with the reset_nvram option, it resets all of the parameters in the host system's OpenBoot PROM NVRAM settings to the factory default values. You must reset the server within 10 minutes. Refer to reset.

If you use the bootmode command without specifying any option, ALOM CMT displays the currently selected mode and the time when it will expire.

Related Information

• ALOM CMT Shell Commands
• reset
• Switching Between the System Console and ALOM CMT

break

Use the break command to bring the server to the OpenBoot PROM prompt (ok). If you have configured the kmdb debugger, then the break command brings the server into debug mode.

This command can also be used to force a panic core dump of the Solaris OS, if the server is running a version of Solaris that supports this feature.

Ensure that the system console is directed to ALOM CMT. SeePlatform-Specific Information for further information.

  At the sc> prompt, type the following command:

sc> break option 

where option is -D, -y, -c, or no option. These options can be combined in any way, none are mutually exclusive.

After you type the break command, the server returns the ok prompt.

break Command Options

The break command can have the following options:

Related Information

• ALOM CMT Shell Commands
• userperm

clearasrdb

Use the clearasrdb command to remove all entries from the Automatic System Recovery database (asr-db) blacklist, thereby re-enabling all devices regardless of whether they have been disabled manually or disabled through POST.

  At the sc> prompt, type the following command:

sc> clearasrdb

clearfault

The clearfault command enables the system administrator to repair a host-reported fault manually so that it is not displayed by the showfaults command.

In this example, the showfaults command identifies a host-detected fault:

sc> showfaults
    ID FRU               Fault
     0 MB/CMP0/CH0/R0/D0 Host detected fault, MSGID: SUN4U-8000-2S

Including the -v (verbose) option to the showfaults command,

sc> showfaults -v
    ID Time              FRU               Fault
     0 SEP 09 11:09:26   MB/CMP0/CH0/R0/D0 Host detected fault, MSGID: 
SUN4U-8000-2S  UUID: 7ee0e46b-ea64-6565-e684-e996963f7b86

Issuing the clearfault command without an argument causes ALOM CMT to display command usage information:

sc> clearfault
Error: Invalid command option
Usage: clearfault <UUID>

The clearfault command takes one argument, the universal unique identifier (UUID), a numerical string (displayed in the previous example). In this example, the UUID is supplied as an argument to the clearfault command:

sc> clearfault 7ee0e46b-ea64-6565-e684-e996963f7b86
Clearing fault from all indicted FRUs...
Fault cleared.

As a result of the successful use of the clearfault command, the showfault command no longer displays the host-detected fault:

sc> showfaults
No failures found in System

In this example, the showfru command indicates that a faulty component, HDD0 (shown initially in showfaults output), is proxied on SASBP.SEEPROM

sc> showfaults
   ID FRU               Fault
    9 HDD0              Host detected fault, MSGID: SUNW-TEST07

Use the showfru command to display the event status information.

sc> showfru SASBP.SEEPROM
... 
/Status_EventsR (1 iterations)
/Status_EventsR[0]
/Status_EventsR[0]/UNIX_Timestamp32:      FRI MAY 20 12:16:02 2005
/Status_EventsR[0]/Old_Status:            0x00 (OK)
/Status_EventsR[0]/New_Status:            0x10 (PROXIED FAULT)
/Status_EventsR[0]/Initiator:             0xE0 (FM)
/Status_EventsR[0]/Component:             0x20
/Status_EventsR[0]/Message (FM)
/Status_EventsR[0]/FM/fault_diag_time:    0x0000000000000000
/Status_EventsR[0]/FM/diagcode:           SUNW-TEST07
/Status_EventsR[0]/FM/uuid: 
66616b65-7575-6964-0000-000000000000
/Status_EventsR[0]/FM/DE_Name:            ALOM-DE
/Status_EventsR[0]/FM/DE_Version:         v1.0
...
SEGMENT: ST
/Status_Proxy1R/
/Status_Proxy1R/UNIX_Timestamp32: FRI MAY 20 12:16:02 2005
/Status_Proxy1R/version:          0x01
/Status_Proxy1R/StatusMap31: 
0x07000000000000000000000000000000000000000000000000000000000000
/Status_CurrentR/
/Status_CurrentR/UNIX_Timestamp32: FRI MAY 20 12:16:02 2005
/Status_CurrentR/status:           0x10 (PROXIED FAULT)

Once the faulty component (HDD0 in this example) has been replaced, you can run the clearfaults UUID command to remove the fault from the proxied SEEPROM.

console

Use the console command to enter console mode and to connect to the system console from the ALOM CMT command shell. To exit the system console and return to the ALOM CMT command shell, type #. (Hash-Period).

Although multiple users can connect to the system console from ALOM CMT, only one user at a time has write access to the console. Any characters that other users type are ignored. This situation is referred to as a write lock, and the other user sessions view the console session in read-only mode. If no other users have access to the system console, then the user entering the console session first obtains the write lock automatically by executing the console command. If another user has the write lock, you can use the -f option to force the console to give you the write lock. This action forces the other user's connection into read-only mode.

ALOM CMT controls the flow rate of the system console to match the flow rate of the user session holding the write lock. This functionality ensures that the user session with the write lock does not lose data. However, this arrangement can cause data loss for user sessions with read-only console access. For example, if the user session with the write lock is connected over the fast NET MGT port and a session with reader is connected over the slow serial management (SER MGT) port, the console can produce output at a rate that could overrun the capacity of the reader session. To reduce the likelihood of such console data loss, each console reader session is allocated 65535 characters of buffer space.

1. At the sc> prompt, type the following command:

sc> console option

where option is the option you want to use, if any.

2. To return to the sc> prompt from the Solaris system prompt, type the escape character sequence.

The default sequence is #. (Hash-Period).

If no session has the console in use, ALOM CMT displays the following information:

sc> showusers 
Username   Connection   Login Time   Client IP Addr  Console
-------------------------------------------------------------
admin      serial       Nov 13 6:19                  system 
jeff       net-1        Nov 13 6:20  xxx.xxx.xxx.xxx 
sc> console 
Enter #. to return to ALOM. 
%

If another session already has the write lock, ALOM CMT returns a different message at the console command as shown in this example:

sc> console 
Console session already in use. [view mode] 
Enter #. to return to ALOM. 
% 

If another session already has the write lock and you use the -f option with the console command, ALOM CMT returns a message at the console command that is similar to the following:

sc> console -f 
Warning: User <admin> currently has write permission to this
console and forcibly removing them will terminate any current write
actions and all work will be lost. Would you like to continue?
[y/n] 

console Command Option

The console command uses one option, -f. This option forces ALOM CMT to release the write lock from another user and assign it to your console session. This places the other user's console session in read-only mode. Using this option returns the following message:.

Warning: User username currently has write permission to this
console and forcibly removing them will terminate any current write
actions and all work will be lost. Would you like to continue
[y/n]? 

At the same time, the user who has the write lock receives the following message:

Warning: Console connection forced into read-only mode.

Related Information

• ALOM CMT Shell Commands
• Permission Levels
• Serial Management Port Variables

consolehistory

Use the consolehistory command to display system console messages logged in ALOM CMT buffers. You can read the following system console logs:

• boot log - Contains POST, OpenBoot PROM, and Solaris boot messages received from the host server from the most recent reset.
• run log - Contains the most recent console output from POST, OpenBoot PROM, and Solaris boot messages. In addition, this log records output from the host server's operating system.

Each buffer can contain up to 64 Kbytes of information.

If ALOM CMT senses a host server reset, it writes boot information and initialization data into the boot log buffer until ALOM CMT is notified by the server that the Solaris OS is up and running.

  At the sc> prompt, type the following command:

sc> consolehistory logname options 

where logname is the name of the log you want to display (boot or run). If you type the consolehistory command without an option, ALOM CMT returns the last 20 lines of the run log.

consolehistory Command Options

The consolehistory command uses the following options for both logs. You can use the -g option in combination with the -b, -e, or -v options. If you do not specify the -g option, the screen output will not pause.

Related Information

• ALOM CMT Shell Commands

disablecomponent

Use the disablecomponent command to add a component to the asr-db blacklist, thereby removing it from the system configuration. Using the disablecomponent command without any parameters causes ALOM CMT to display all asr-keys.

  At the sc> prompt, type the following command:

sc> disablecomponent asr-device

For example:

sc> disablecomponent MB/CMP0/CH3/R0/D1
sc> showcomponent
Keys:
MB/CMP0/CORE0
...
     MB/CMP0/P0
...
     MB/CMP0/CH0/R0/D0
     MB/CMP0/CH0/R0/D1
     MB/CMP0/CH0/R1/D0
     MB/CMP0/CH0/R1/D1
     MB/CMP0/CH1/R0/D0
     MB/CMP0/CH1/R0/D1
     MB/CMP0/CH1/R1/D0
     MB/CMP0/CH1/R1/D1
     MB/CMP0/CH2/R0/D0
     MB/CMP0/CH2/R0/D1
     MB/CMP0/CH2/R1/D0
     MB/CMP0/CH2/R1/D1
     MB/CMP0/CH3/R0/D0
     MB/CMP0/CH3/R0/D1
     MB/CMP0/CH3/R1/D0
     MB/CMP0/CH3/R1/D1
     IOBD/PCIEa
     IOBD/PCIEb
     PCIX1
     PCIX0
     PCIE2
     PCIE1
     PCIE0
     TTYA
 
 
ASR state:  Disabled Devices
     MB/CMP0/CH3/R0/D1 : <no reason>

enablecomponent

Use the enablecomponent command to remove a component from the asr-db blacklist, thereby adding the component back into the system configuration. Using the enablecomponent command without any parameters causes ALOM CMT to display all asr-keys currently blacklisted.

  At the sc> prompt, type the following command:

sc> enablecomponent asr-device

For example:

sc> enablecomponent MB/CMP0/CH3/R0/D1
sc> showcomponent
Keys:
     MB/CMP0/CORE0
...
     MB/CMP0/P0
...
     MB/CMP0/CH0/R0/D0
     MB/CMP0/CH0/R0/D1
     MB/CMP0/CH0/R1/D0
     MB/CMP0/CH0/R1/D1
     MB/CMP0/CH1/R0/D0
     MB/CMP0/CH1/R0/D1
     MB/CMP0/CH1/R1/D0
     MB/CMP0/CH1/R1/D1
     MB/CMP0/CH2/R0/D0
     MB/CMP0/CH2/R0/D1
     MB/CMP0/CH2/R1/D0
     MB/CMP0/CH2/R1/D1
     MB/CMP0/CH3/R0/D0
     MB/CMP0/CH3/R0/D1
     MB/CMP0/CH3/R1/D0
     MB/CMP0/CH3/R1/D1
     IOBD/PCIEa
     IOBD/PCIEb
     PCIX1
     PCIX0
     PCIE2
     PCIE1
     PCIE0
     TTYA
 
 
ASR state: clean

flashupdate

Use the flashupdate command to update all system firmware from a location that you specify. The values you enter for command options specify the IP address of the site from which you download and the path at which the firmware image is located.

To use this command, you need to know the following:

• IP address of the FTP server from which you want to download the firmware image
• Path at which the image is stored
• Username and password to enter at the prompts

If you do not have this information, ask your network administrator. Before you start, make sure that your virtual keyswitch setting is not in the LOCKED position. For more information about the virtual keyswitch, see setkeyswitch.

1. At the sc> prompt, type the flashupdate command.

Substitute the IP address of the server where the firmware image is stored for ipaddr, and the path name for pathname.

sc> flashupdate -s ipaddr -f pathname

2. When prompted, type your username and password.

The username and password are based on your UNIX or LDAP user name and password, and not your ALOM CMT username and password.

After you type your user name and password, the download process continues. As the download process progresses, a series of periods appear across your screen.

When the download process is finished, ALOM CMT displays the message:

Update complete. Reset device to use new image.

3. Type the resetsc command to reboot ALOM CMT.

See resetsc for details.

For example, (replace 123.45.67.89 with a valid IP address):

sc> flashupdate -s 123.45.67.89 -f filename
 
SC Alert: System poweron is disabled.
Username: username
Password: *******
 
................................................................
................................................................
.....................................
 
Update complete. Reset device to use new software.
 
SC Alert: SC firmware was reloaded

flashupdate Command Options

The flashupdate command uses the following options.

Related Information

• ALOM CMT Shell Commands

help

Use the help command to display a list of all ALOM CMT commands and the syntax for each command.

  Take one of the following actions:

• To display help for all available commands, at the sc> prompt type the following command:


sc > help


• To display help for a specific command, at the sc> prompt type help and the name of the command:


sc> help command-name

where command-name is the name of the specific command. For example:

sc> help poweroff 
This command shuts down the managed system to the powered off state.
sc>

• To display help for a system controller parameter, at the sc> prompt type
  help setsc and the name of the parameter:


sc> help setsc parameter

where parameter is the system controller parameter. For example:

sc> help setsc if_network
if_network
 
Enables or disables the SC network interface.  The default is true.
 
sc>

The following example shows the output you see when you type help without specifying a command:

sc> help
Available commands
------------------
Power and Reset control commands:
   powercycle [-y] [-f]
   poweroff [-y] [-f]
   poweron [-c] [FRU]
   reset [-y] [-c]
Console commands:
   break [-D] [-y] [-c]
   console [-f]
   consolehistory [-b lines|-e lines|-v] [-g lines] [boot|run]
Boot control commands:
   bootmode [normal|reset_nvram|config="configname"|bootscript="string"]
   setkeyswitch [-y] <normal|stby|diag|locked>
   showkeyswitch
Locator LED commands:
   setlocator [on|off]
   showlocator
Status and Fault commands:
   clearasrdb
   clearfault <UUID>
   disablecomponent [asr-key]
   enablecomponent [asr-key]
   removefru [-y] <FRU>
   setfru -c [data]
   showcomponent [asr-key]
   showenvironment
   showfaults [-v]
   showfru [-g lines] [-s|-d] [FRU]
   showlogs [-b lines|-e lines|-v] [-g lines] [-p logtype[r|p]]
   shownetwork [-v]
   showplatform [-v]
ALOM Configuration commands:
   setdate <[mmdd]HHMM | mmddHHMM[cc]yy][.SS]>
   setsc [param] [value]
   setupsc
   showdate
   showhost [version]
   showsc [-v] [param]
ALOM Administrative commands:
   flashupdate <-s IPaddr -f pathname> [-v]
   help [command]
   logout
   password
   resetsc [-y]
   restartssh [-y]
   setdefaults [-y] [-a]
   ssh-keygen [-l|-r] <-t {rsa|dsa}>
   showusers [-g lines]
   useradd <username>
   userdel [-y] <username>
   userpassword <username>
   userperm <username> [c][u][a][r]
   usershow [username] 

Related Information

• ALOM CMT Shell Commands

logout

Use the logout command to end your ALOM CMT session, and to close your serial or network connection.

  At the sc> prompt, type the following command:

sc> logout

Related Information

• ALOM CMT Shell Commands

password

Use the password command to change the ALOM CMT password for the account to which you are currently logged in. This command works like the UNIX passwd(1) command.

  At the sc> prompt, type password.

When you use this command, ALOM CMT prompts you for your current password. If you enter the password correctly, it prompts you twice to enter the new password.

For example:

sc> password 
password: Changing password for username 
Enter current password: ****** 
Enter new password: ****** 
Re-enter new password: ****** 
sc>

Password Restrictions

Passwords have the following restrictions:

• They must be between six and eight characters.
• They must contain at least two alphabetic characters (uppercase or lowercase letters), and at least one numeric or special character.
• They must differ from your login name, and any reverse or circular shift of your login name. For comparison purposes, uppercase and lowercase letters are equivalent.
• They must differ from the old password by at least three characters. For comparison purposes, uppercase and lowercase letters are equivalent.

Related Information

• ALOM CMT Shell Commands

powercycle

Performs a powercycle on the host system, where powercycle is defined as a poweroff followed by a poweron. ALOM CMT executes the poweroff command on the host system and waits for a specified number of seconds, then executes the poweron command.

  At the sc> prompt, type the following command:

sc> powercycle [-y] [-f]

poweroff

Use the poweroff command to power off the host server to standby mode. If the server is already powered off, this command has no effect. However, ALOM CMT is still available when the server is powered off, since ALOM CMT uses the server's standby power. Some environmental information is not available when the server is in standby mode.

  At the sc> prompt, type the following command:

sc> poweroff options

where option is the desired option, if any.

If you type the poweroff command without any options, the command initiates a graceful shutdown of the Solaris OS, similar to one of the Solaris commands shutdown, init, or uadmin.

It can take up to 65 seconds for the poweroff command to completely shut down the system. This is because ALOM CMT attempts to wait for a graceful shutdown to complete before the system is powered off.

SC Alert: Host system has shut down. 

Wait until you see this message before powering the system back on.

poweroff Command Options

The poweroff command uses the following options. You can use these two options together. Refer to Entering Command Options.

Related Information

• ALOM CMT Shell Commands
• bootmode
• poweron

poweron

Use the poweron command to power on the server. If the host server is already powered on, this command has no effect.

  At the sc> prompt, type the following command:

sc> poweron [fru] [-c]

SC Alert: Host system has shut down. 

Wait until you see the message before powering the system back on.

poweron Command Options

The poweron command uses the following options.

Related Information

• ALOM CMT Shell Commands
• bootmode
• poweroff
• removefru

removefru

Use the removefru command to prepare a FRU (field-replaceable unit) for removal.

  At the sc> prompt, type the following command:

sc> removefru fru 

where fru is the name of the FRU you want to prepare for removal.

For example, to prepare Power Supply 0 for removal, type:

sc> removefru PS0

sc> removefru PS0
Could not remove <PS0>.
System only has one power supply.

removefru Command Options

The removefru command uses the following options.

Specifying the fru option prepares the specified FRU for removal. ALOM CMT responds with a message indicating whether the FRU is ready for removal.

reset

Use the reset command to force the host server to reset immediately. The server reboots using the options you specified (if any) in the bootmode command. Refer to bootmode. Note that reset does not perform a graceful shutdown of the system, and you might lose data. When possible, reset the server through the Solaris OS instead.

If the OpenBoot PROM variable auto-boot? is set to false, you might need to boot the server into the Solaris OS to resume operation.

  At the sc> prompt, type the following command:

sc> reset options

reset Command Options

The reset command uses the following two options. You can use these two options together. Refer to ALOM CMT Command Shell Overview.

For example:

sc> reset -c
Are you sure you want to reset the system [y/n]?  n

sc> reset -yc
Enter #. to return to ALOM.
 
SC Alert: SC Request to Reset Host.

sc> reset -c
Are you sure you want to reset the system [y/n]?  y
Enter #. to return to ALOM.
 
SC Alert: SC Request to Reset Host.

Related Information

• ALOM CMT Shell Commands
• Permission Levels

resetsc

Use the resetsc command to perform a hard reset of the system controller. This terminates all current ALOM CMT sessions.

1. To perform a reset, type the following command:

sc> resetsc option

where option is -y, if desired.

ALOM CMT responds with the following message:

Are you sure you want to reset the SC [y/n]? 

2. Type y to proceed, or n to exit without resetting the system controller.

resetsc Command Options

The resetsc command uses one option: -y

If you use the -y option, the reset proceeds without first asking you to confirm the reset.

Related Information

• ALOM CMT Shell Commands
• Permission Levels

restartssh

Use the restartssh command to restart the SSH server after you have generated new hosts keys using the ssh-keygen command. This action reloads the keys into the server's dedicated data structure in memory.

  At the sc> prompt, type the following command:

sc> restartssh option

where option is the option shown in TABLE 7-11.

Command Options

The restartssh command uses the following options.

Related Information

• ssh-keygen

setdate

Use the setdate command to set the current ALOM CMT date and time.

If you use the setdate command while the server is starting or running, ALOM CMT returns the following error message:

sc> setdate 1200 
Error: Unable to set clock while managed system is running.

  At the sc> prompt, type the following command:

sc> setdate mmddHHMMccyy.SS 

This command accepts settings for the month, day, hour, minute, century, year, and second. If you omit the month, day, and year, ALOM CMT applies the current values as defaults. You can also omit the century value and the value for seconds in the time.

This example sets the time to September 12, at 9:45 PM of the current year (Coordinated Universal Time).

sc> setdate 09122145 
MON SEP 12 21:45:00 2005 UTC 

This example sets the time to 9:45 PM of the current month, day, and year (Coordinated Universal Time).

sc> setdate 2145 
MON SEP 12 21:45:00 2005 UTC

setdate Command Options

The setdate command uses the following options.

Related Information

• ALOM CMT Shell Commands

setdefaults

Use the setdefaults command to set all ALOM CMT configuration variables back to their factory default values. The -a option sets the ALOM CMT configuration and all user information back to the factory default values.

1. At the sc> prompt, type the following command:

sc> setdefaults options

where options are the desired options, if any.

For example:

sc> setdefaults 
Are you sure you want to reset the SC configuration [y/n]? y 

sc> setdefaults -a 
Are you sure you want to reset the SC configuration and users [y/n]? y 

2. Type the resetsc command to reboot ALOM.

When ALOM CMT reboots, it uses the factory default values.

setdefaults Command Options

The setdefaults command uses the following options.

Related Information

• ALOM CMT Shell Commands

setfru

Use the setfru command to store information in all FRU PROMs.

  At the sc> prompt, type the following command:

sc> setfru -c data

Using the -c option alone clears old data from all FRU PROMs. This information can be displayed using the showfru command. See showfru

setkeyswitch

Use the setkeyswitch command to control the virtual keyswitch position of the system.

  At the sc> prompt, type the following command:

sc> setkeyswitch option

setkeyswitch Command Options

The setkeyswitch command uses the following options:

setlocator

Use the setlocator command to turn the host server's Locator LED on or off. For more information about the Locator LEDs, refer to your system administration guide.

  At the sc> prompt, type the following command:

sc> setlocator option

Where option is either on or off.

For example:

sc> setlocator on 
sc> setlocator off

To show the state of the Locator LED, use the showlocator command. Refer to showlocator for more information.

setlocator Command Options

This setlocator command has two options: on and off.

Related Information

• ALOM CMT Shell Commands
• showlocator

setsc

The ALOM CMT software comes preinstalled on your host server, and is ready to run as soon as you apply power to the server. If you want to customize the ALOM CMT configuration, you set up the initial configuration with the setupsc command. If you need to update a setting after your initial ALOM CMT configuration, use the setsc command. For information about your configuration, see ALOM CMT Configuration Steps. For more about the setupsc command, see setupsc.

Ensure that you have your configuration table with you as you run the command, and that it includes your planned values for each of the configuration variables you plan to change. See Configuration Worksheet and Using ALOM CMT Configuration Variables for more information.

  At the sc> prompt, type the following command:

sc> setsc variable value 

Substitute the configuration variable and the variable's value for variable and value.

For example:

sc> setsc netsc_ipaddr xxx.xxx.xxx.xxx 

where xxx.xxx.xxx.xxx is a valid IP address.

If the variable you are configuring requires more than one value, type the values, using spaces to separate them. Because the setsc command can be used in scripts as well as at the command prompt, it does not return any information after you enter a value for a variable.

If you type setsc without including a configuration variable, ALOM CMT returns a list of the variables you can configure.

Related Information

• ALOM CMT Shell Commands

setupsc

Use the setupsc command to customize ALOM CMT.

Ensure that you have your configuration worksheet with you as you run the command, and that the worksheet includes your planned values for each of the configuration variables you plan to change. See Configuration Worksheet and Using ALOM CMT Configuration Variables for more information.

1. At the sc> prompt, type the following command:

sc> setupsc 

The setup script starts.

2. To exit the script, take one of the following actions:

• To exit the script and save the changes you have made, type Control-Z.
• To exit the script without saving any changes, type Control-C.

For example, the script starts as follows:

sc> setupsc 
Entering interactive script mode. To exit and discard changes to
that point, use Ctrl-C or to exit and save changes to that point,
use Ctrl-Z.

3. Answer the interactive questions to customize ALOM CMT.

The script asks you whether you want to enable each set of configuration variables. See Using ALOM CMT Configuration Variables for help.

• To enable a set of variables so that you can configure their settings, type y.
• To accept a default value shown in parentheses, press Return.
• To disable a set of variables and proceed to the next, type n.

For example:

Should the SC network interface be enabled [y]? 

If you type y or press Return to accept the default, the setupsc script then prompts you to enter values for the variables. The script helps you set up the following types of variables:

• Network Interface Variables
• Network Management and Notification Variables
• System User Variables

Related Information

• Using ALOM CMT Configuration Variables
• ALOM CMT Shell Commands
• Configuration Worksheet
• Configuring ALOM CMT

showcomponent

Use the showcomponent command to display system components and their test status. If you specify an asr-key, ALOM CMT displays only information for that key, otherwise ALOM CMT displays the entire asr database. The -h (Help) option lists all valid asr-keys as well as usage information.

  At the sc> prompt, type the following command:

sc> showcomponent

For example:

sc> showcomponent
Keys:
 
     MB/CMP0/P0
...
     MB/CMP0/CH0/R0/D0
     MB/CMP0/CH0/R0/D1
     MB/CMP0/CH0/R1/D0
     MB/CMP0/CH0/R1/D1
     MB/CMP0/CH1/R0/D0
     MB/CMP0/CH1/R0/D1
     MB/CMP0/CH1/R1/D0
     MB/CMP0/CH1/R1/D1
     MB/CMP0/CH2/R0/D0
     MB/CMP0/CH2/R0/D1
     MB/CMP0/CH2/R1/D0
     MB/CMP0/CH2/R1/D1
     MB/CMP0/CH3/R0/D0
     MB/CMP0/CH3/R0/D1
     MB/CMP0/CH3/R1/D0
     MB/CMP0/CH3/R1/D1
     IOBD/PCIEa
     IOBD/PCIEb
     PCIX1
     PCIX0
     PCIE2
     PCIE1
     PCIE0
     TTYA
 
 
ASR state: clean

showdate

Use the showdate command to show the current ALOM CMT date and time.

ALOM CMT time is expressed in Coordinated Universal Time (UTC) rather than local time. Note that the Solaris OS and ALOM CMT time are not synchronized.

  At the sc> prompt type the following command:

sc> showdate 

For example:

sc> showdate 
MON SEP 16 21:45:00 2002 UTC 

To change the ALOM CMT date and time, use the setdate command. See setdate.

Related Information

• ALOM CMT Shell Commands

showenvironment

Use the showenvironment command to display a snapshot of the server's environmental status.The information this command can display includes system temperatures, hard drive status, power supply and fan status, front panel LED status, voltage and current sensors, and so on. The output uses a format similar to the UNIX command prtdiag (1m).

  At the sc> prompt, type the following command:

sc> showenvironment

Some environmental information might not be available when the server is in standby mode.

The following example shows sample output when the host server is powered on. Note that some information shown in the following example might be different for your system, such as the number of power supplies and hard drives.

sc> showenvironment
 
 
=============== Environmental Status ===============
 
 
 
System Temperatures (Temperatures in Celsius):
 
Sensor           Status  Temp LowHard LowSoft LowWarn HighWarn HighSoft HighHard
 
PDB/T_AMB        OK        24    -10      -5       0      45       50     55
MB/T_AMB         OK        28    -10      -5       0      45       50     55
MB/CMP0/T_TCORE  OK        44    -10      -5       0      95      100    105
MB/CMP0/T_BCORE  OK        44    -10      -5       0      95      100    105
IOBD/IOB/TCORE   OK        43    -10      -5       0      95      100    105
IOBD/T_AMB       OK        29    -10      -5       0      45       50     55
 
--------------------------------------------------------
System Indicator Status:
--------------------------------------------------------
SYS/LOCATE           SYS/SERVICE          SYS/ACT
OFF                  OFF                  ON
--------------------------------------------------------
SYS/REAR_FAULT       SYS/TEMP_FAULT       SYS/TOP_FAN_FAULT
OFF                  OFF                  OFF
--------------------------------------------------------
 
--------------------------------------------
System Disks:
--------------------------------------------
Disk   Status            Service  OK2RM
--------------------------------------------
HDD0   OK                OFF      OFF
HDD1   NOT PRESENT       OFF      OFF
HDD2   NOT PRESENT       OFF      OFF
HDD3   NOT PRESENT       OFF      OFF
 
---------------------------------------------------
Fans Status:
---------------------------------------------------
Fans (Speeds Revolution Per Minute):
Sensor           Status           Speed   Warn    Low
----------------------------------------------------------
FT0/FM0          OK                3586     --   1920
FT0/FM1          OK                3525     --   1920
FT0/FM2          OK                3650     --   1920
FT2              OK                2455     --   1920
----------------------------------------------------------
 
 
------------------------------------------------------------------------------
Voltage sensors (in Volts):
------------------------------------------------------------------------------
Sensor          Status      Voltage LowSoft LowWarn HighWarn HighSoft
------------------------------------------------------------------------------
MB/V_+1V5       OK            1.48    1.27    1.35    1.65     1.72
MB/V_VMEML      OK            1.79    1.53    1.62    1.98     2.07
MB/V_VMEMR      OK            1.78    1.53    1.62    1.98     2.07
MB/V_VTTL       OK            0.89    0.76    0.81    0.99     1.03
MB/V_VTTR       OK            0.89    0.76    0.81    0.99     1.03
MB/V_+3V3STBY   OK            3.39    2.80    2.97    3.63     3.79
MB/V_VCORE      OK            1.31    1.18    1.20    1.39     1.41
IOBD/V_+1V5     OK            1.48    1.27    1.35    1.65     1.72
IOBD/V_+1V8     OK            1.79    1.53    1.62    1.98     2.07
IOBD/V_+3V3MAIN OK            3.36    2.80    2.97    3.63     3.79
IOBD/V_+3V3STBY OK            3.41    2.80    2.97    3.63     3.79
IOBD/V_+1V      OK            1.11    0.93    0.99    1.21     1.26
IOBD/V_+1V2     OK            1.17    1.02    1.08    1.32     1.38
IOBD/V_+5V      OK            5.15    4.25    4.50    5.50     5.75
IOBD/V_-12V     OK          -12.04  -13.80  -13.20  -10.80   -10.20
IOBD/V_+12V     OK           12.18   10.20   10.80   13.20    13.80
SC/BAT/V_BAT    OK            3.04      --    2.25    --       --
 
-----------------------------------------------------------
System Load (in amps):
-----------------------------------------------------------
Sensor           Status              Load     Warn Shutdown
-----------------------------------------------------------
MB/I_VCORE       OK                34.640   80.000   88.000
MB/I_VMEML       OK                 7.560   60.000   66.000
MB/I_VMEMR       OK                 6.420   60.000   66.000
-----------------------------------------------------------
 
 
----------------------
Current sensors:
----------------------
Sensor          Status
----------------------
IOBD/I_USB0      OK
IOBD/I_USB1      OK
FIOBD/I_USB      OK
 
 
------------------------------------------------------------------------------
Power Supplies:
------------------------------------------------------------------------------
Supply  Status          Underspeed  Overtemp  Overvolt  Undervolt Overcurrent
------------------------------------------------------------------------------
PS0     OK              OFF         OFF       OFF       OFF        OFF
PS1     OK              OFF         OFF       OFF       OFF        OFF

The following example shows sample output when the host server, a SPARC Enterprise T1000, is powered on:

sc> showenvironment
 
 
=============== Environmental Status ===============
 
------------------------------------------------------------------------------
System Temperatures (Temperatures in Celsius):
------------------------------------------------------------------------------
Sensor         Status    Temp LowHard LowSoft LowWarn HighWarn HighSoft HighHard
------------------------------------------------------------------------------
MB/T_AMB         OK        26    -10      -5       0      45       50       55
MB/CMP0/T_TCORE  OK        42    -10      -5       0      85       90       95
MB/CMP0/T_BCORE  OK        42    -10      -5       0      85       90       95
MB/IOB/T_CORE    OK        36    -10      -5       0      95      100      105
 
 
--------------------------------------------------------
System Indicator Status:
--------------------------------------------------------
SYS/LOCATE           SYS/SERVICE          SYS/ACT
OFF                  OFF                  ON
--------------------------------------------------------
 
----------------------------------------------------------
Fans (Speeds Revolution Per Minute):
----------------------------------------------------------
Sensor           Status           Speed   Warn    Low
----------------------------------------------------------
FT0/F0           OK                6653   2240   1920
FT0/F1           OK                6653   2240   1920
FT0/F2           OK                6653   2240   1920
FT0/F3           OK                6547   2240   1920
 
------------------------------------------------------------------------------
Voltage sensors (in Volts):
------------------------------------------------------------------------------
Sensor         Status      Voltage LowSoft LowWarn HighWarn HighSoft
------------------------------------------------------------------------------ 
MB/V_VCORE      OK            1.31    1.20    1.24    1.36     1.39
MB/V_VMEM       OK            1.78    1.69    1.72    1.87     1.90
MB/V_VTT        OK            0.89    0.84    0.86    0.93     0.95
MB/V_+1V2       OK            1.19    1.09    1.11    1.28     1.30
MB/V_+1V5       OK            1.49    1.36    1.39    1.60     1.63
MB/V_+2V5       OK            2.50    2.27    2.32    2.67     2.72
MB/V_+3V3       OK            3.29    3.06    3.10    3.49     3.53
MB/V_+5V        OK            5.02    4.55    4.65    5.35     5.45
MB/V_+12V       OK           12.18   10.92   11.16   12.84    13.08
MB/V_+3V3STBY   OK            3.31    3.13    3.16    3.53     3.59
 
-----------------------------------------------------------
System Load (in amps):
-----------------------------------------------------------
Sensor           Status              Load     Warn Shutdown
-----------------------------------------------------------
MB/I_VCORE       OK                21.520   80.000   88.000
MB/I_VMEM        OK                 1.740   60.000   66.000
-----------------------------------------------------------
 
 
----------------------
Current sensors:
----------------------
Sensor          Status
----------------------
MB/BAT/V_BAT     OK
 
 
------------------------------------------------------------------------------
Power Supplies:
------------------------------------------------------------------------------
Supply  Status          Underspeed  Overtemp  Overvolt  Undervolt  Overcurrent
------------------------------------------------------------------------------
PS0     OK              OFF         OFF       OFF       OFF        OFF

The following example shows sample output when the host server is powered off:

sc> showenvironment
 
 
=============== Environmental Status ===============
 
 
------------------------------------------------------------------------------
System Temperatures (Temperatures in Celsius):
------------------------------------------------------------------------------
Sensor           Status  Temp LowHard LowSoft LowWarn HighWarn HighSoft HighHard
------------------------------------------------------------------------------
CPU temperature information cannot be displayed when System power is off.
PDB/T_AMB        OK        24    -10      -5       0      45       50      55
 
--------------------------------------------------------
System Indicator Status:
--------------------------------------------------------
SYS/LOCATE           SYS/SERVICE          SYS/ACT
OFF                  OFF                  STANDBY BLINK
--------------------------------------------------------
SYS/REAR_FAULT       SYS/TEMP_FAULT       SYS/TOP_FAN_FAULT
OFF                  OFF                  OFF
--------------------------------------------------------
 
 
Disk Status information cannot be displayed when System power is off.
 
Fan Status information cannot be displayed when System power is off.
 
Voltage Rail Status information cannot be displayed when System power is off.
 
System Load information cannot be displayed when System power is off.
 
Current sensor information cannot be displayed when System power is off.
 
------------------------------------------------------------------------------
Power Supplies:
------------------------------------------------------------------------------
Supply  Status          Underspeed  Overtemp  Overvolt  Undervolt  Overcurrent
------------------------------------------------------------------------------
PS0     OK              OFF         OFF       OFF       OFF        OFF
PS1     OK              OFF         OFF       OFF       OFF        OFF

Related Information

• ALOM CMT Shell Commands

showfaults

Use the showfaults command to display current valid system faults. The standard output displays the fault ID, the faulted FRU device, and the fault message. This command also displays POST results.

The showfaults command uses the -v argument to supply more verbose output.

  At the sc> prompt, type the following command:

sc> showfaults
ID FRU               Fault
    0 MB/CMP0/CH0/R0/D0 Host detected fault, MSGID: SUN4U-8000-2S

Adding the -v argument:

sc> showfaults -v
ID Time                 FRU               Fault
    0 SEP 09 11:02:09   MB/CMP0/CH0/R0/D0 Host detected fault, MSGID: 
SUN4U-8000-2S  UUID: 7ee0e46b-ea64-6565-e684-e996963f7b86

Using the FRU ID reported in the showfaults output, you can get more information using the showfru command,

sc> showfru MB/CMP0/CH0/R0/D0
/SPD/Timestamp: MON JUN 27 12:00:00 2005
/SPD/Description: DDR2 SDRAM, 512 MB
/SPD/Manufacture Location:
/SPD/Vendor: Micron Technology
/SPD/Vendor Part No:   18HTF6472Y-53EB2
/SPD/Vendor Serial No: 751d9239
SEGMENT: ST
/Platform_Name:                    Sun-Fire-T1000
/Status_CurrentR/
/Status_CurrentR/UNIX_Timestamp32: FRI SEP 09 10:28:08 2005
/Status_CurrentR/status:           0x64 (MAINTENANCE REQUIRED, SUSPECT, 
DEEMED FAULTY)
/Event_DataR/
/Event_DataR/Initiator:            FM
/Event_DataR/Diagcode:            SUN4U-8000-2S
/Event_DataR/UUID:                7ee0e46b-ea64-6565-e684-e996963f7b86

Using the diagnostic code reported by the showfaults and showfru commands, (for example: SUN4U-8000-2S) you can go to

http://www.sun.com/msg/SUN4U-8000-2S 

for more information about the fault. You can also navigate to

http://www.sun.com/msg 

then enter SUN4U-8000-2S in the SUNW-MSG-ID window.

For further information about the showfru command see showfru. For further information about fault management tasks, see Chapter 5.

showfru

Use the showfru command to display the current status and fault history of all field-replaceable units programmable read-only memory (FRU PROMs) in the host server. The output uses a format similar to that of the Solaris OS prtfru command.

showfru Command Options

The showfru command uses the following options:

  At the sc> prompt, type the following command:

sc> showfru argument

The following example shows sample output for the showfru command on a SPARC Enterprise T2000 server, supplying an invalid argument:

sc> showfru x
No such FRU_PROM.  Valid arguments are:
SC/SEEPROM
IOBD/SEEPROM
MB/SEEPROM
PDB/SEEPROM
FIOBD/SEEPROM
SASBP/SEEPROM
PS0/SEEPROM
PS1/SEEPROM
MB/CMP0/CH0/R0/D0/SEEPROM
MB/CMP0/CH0/R0/D1/SEEPROM
MB/CMP0/CH0/R1/D0/SEEPROM
MB/CMP0/CH0/R1/D1/SEEPROM
MB/CMP0/CH1/R0/D0/SEEPROM
MB/CMP0/CH1/R0/D1/SEEPROM
MB/CMP0/CH1/R1/D0/SEEPROM
MB/CMP0/CH1/R1/D1/SEEPROM
MB/CMP0/CH2/R0/D0/SEEPROM
MB/CMP0/CH2/R0/D1/SEEPROM
MB/CMP0/CH2/R1/D0/SEEPROM
MB/CMP0/CH2/R1/D1/SEEPROM
MB/CMP0/CH3/R0/D0/SEEPROM
MB/CMP0/CH3/R0/D1/SEEPROM
MB/CMP0/CH3/R1/D0/SEEPROM
MB/CMP0/CH3/R1/D1/SEEPROM
PCIE0       (proxied on IOBD/SEEPROM) 
PCIE1       (proxied on IOBD/SEEPROM) 
PCIE2       (proxied on IOBD/SEEPROM) 
PCIX0       (proxied on IOBD/SEEPROM) 
PCIX1       (proxied on IOBD/SEEPROM) 
SC/BAT      (proxied on SC/SEEPROM) 
PS0         (proxied on PDB/SEEPROM) 
PS1         (proxied on PDB/SEEPROM) 
HDD0        (proxied on SASBP/SEEPROM) 
HDD1        (proxied on SASBP/SEEPROM) 
HDD2        (proxied on SASBP/SEEPROM) 
HDD3        (proxied on SASBP/SEEPROM) 
FT0/FM0     (proxied on FIOBD/SEEPROM) 
FT0/FM1     (proxied on FIOBD/SEEPROM) 
FT0/FM2     (proxied on FIOBD/SEEPROM) 
FT2         (proxied on SASBP/SEEPROM) 

The following example shows sample output for the showfru command on a SPARC Enterprise T1000 server, supplying an invalid argument:

sc> showfru x
No such FRU_PROM.  Valid arguments are:
MB/SEEPROM
PS0/SEEPROM
MB/CMP0/CH0/R0/D0/SEEPROM
MB/CMP0/CH0/R0/D1/SEEPROM
MB/CMP0/CH0/R1/D0/SEEPROM
MB/CMP0/CH0/R1/D1/SEEPROM
MB/CMP0/CH3/R0/D0/SEEPROM
MB/CMP0/CH3/R0/D1/SEEPROM
MB/CMP0/CH3/R1/D0/SEEPROM
MB/CMP0/CH3/R1/D1/SEEPROM
...

The following example shows sample output for the showfru command, supplying a valid FRU name and -s as arguments:

sc> showfru -s MB
SEGMENT: SD
/ManR
/ManR/UNIX_Timestamp32:      THU OCT 06 14:47:58 2005
/ManR/Description:           ASSY,Sun-Fire-T1000,Motherboard
/ManR/Manufacture Location:  Sriracha,Chonburi,Thailand
/ManR/Sun Part No:           5017302
/ManR/Sun Serial No:         000854
/ManR/Vendor:                Celestica
/ManR/Initial HW Dash Level: 01
/ManR/Initial HW Rev Level:  01
/ManR/Shortname:             T1000_MB
/SpecPartNo:                 885-0504-03

The following example shows sample output for the showfru command, supplying the name of a proxied component:

sc> showfru SC/BAT
SC/BAT dynamic data proxied on SC/SEEPROM:
SEGMENT: FD
/Status_EventsR (0 iterations)
/Status_Proxy1R/
/Status_Proxy1R/UNIX_Timestamp32: THU JAN 01 00:00:00 1970
/Status_Proxy1R/version:          0x00
/Status_Proxy1R/Status(decoded):  0x00 (OK) 

By default, the output of the showfru command can be very voluminous. For example:

sc> showfru MB
...
/Status_EventsR[2]
/Status_EventsR[2]/UNIX_Timestamp32:      FRI MAR 03 18:31:06 2006
/Status_EventsR[2]/Old_Status:            0x00 (OK)
/Status_EventsR[2]/New_Status:            0x64 (MAINTENANCE REQUIRED, SUSPECT, DEEMED FAULTY)
/Status_EventsR[2]/Initiator:             0xD3 (FM)
/Status_EventsR[2]/Component:             0x00
/Status_EventsR[2]/Message (FM)
/Status_EventsR[2]/FM/fault_diag_time:    0x0000000044088B69
/Status_EventsR[2]/FM/diagcode:           SUN4V-8000-8Q
/Status_EventsR[2]/FM/UUID:               61b9738d-2761-c3f6-a2ae-fcf11e99681c
/Status_EventsR[2]/FM/DE_Name:            cpumem-diagnosis
/Status_EventsR[2]/FM/DE_Version:         1.5
 
...
 
/Status_CurrentR/
/Status_CurrentR/UNIX_Timestamp32: FRI MAR 03 18:31:06 2006
/Status_CurrentR/status:           0x64 (MAINTENANCE REQUIRED, SUSPECT, DEEMED FAULTY) 

Related Information

• ALOM CMT Shell Commands

showhost

Use the showhost command to display version information about firmware supporting the host configuration.

  At the sc> prompt, type the following command:

sc> showhost
Host flash versions:
    Reset V1.0.0
    Hypervisor 1.0.0 2005/09/28 18:56
    OBP 4.19.0 2005/09/28 12:34
    MPT SAS FCode Version 1.00.37 (2005.06.13)>R
     Integrated POST 4.19.0 2005/09/28 12:52

showkeyswitch

Use the showkeyswitch command to display the current virtual keyswitch position of the system.

  At the sc> prompt, type the following command:

sc> showkeyswitch
Keyswitch is in the NORMAL position.
sc> 

showlocator

Use the showlocator command to view the state of the host server's Locator LED (on or off). For more information about the Locator LED, refer to your system administration guide.

  At the sc> prompt, type the following command:

sc> showlocator 

• If the Locator LED is on, ALOM CMT returns the following result:


sc> showlocator Locator LED is ON


• If the Locator LED is off, ALOM CMT returns the following result:


sc> showlocator Locator LED is OFF

To change the state of the Locator LED, use the setlocator command. Refer to setlocator.

Related Information

• ALOM CMT Shell Commands
• setlocator

showlogs

Use the showlogs command to display the history of events logged in the ALOM CMT event buffer. These events include server reset events and all ALOM CMT commands that change the state of the system (such as reset, poweroff, and poweron). See reset, poweroff, and poweron.

Each event recorded in the log has the following format:

date ID: message 

Where:

• date - the time at which the event occurred, as recorded by ALOM CMT.
• ID - a numerical identifier for the message type.
• message - a short description of the event.

If you use the showlogs command without any option, ALOM CMT displays the last 20 lines of the RAM event log.

  At the sc> prompt, type the following command:

sc> showlogs options

where options are the desired options, if any.

The command returns information similar to the following:

sc> showlogs
 
Log entries since AUG 27 03:35:12
----------------------------------
AUG 27 03:35:12: 00060003: "SC System booted."
AUG 27 03:37:01: 00060000: "SC Login: User admin Logged on."

This example shows the output of the showlogs command with the -p p option. The -p p option displays the persistent event log. The persistent event log is comprised of only Major and Critical severity events.

sc> showlogs -p p
Persistent event log
-------------------- 
JUN 07 04:16:44: 00060003: "SC System booted." 
JUN 07 04:17:12: 00040002: "Host System has Reset" 
JUN 07 04:48:03: 00040081: "Input power unavailable for PSU at PS1. 

showlogs Command Options

The showlogs command uses five options. You can use the -g and -p options in combination with the -b, -e, or -v options. If you do not specify the -g option, the screen output will not pause unless you have specified the -v option together with the -p p option (persistent log, in which case the display pauses after every 25 lines).

Related Information

• ALOM CMT Shell Commands
• consolehistory

shownetwork

Use the shownetwork command to display the current ALOM CMT network configuration.

  At the sc> prompt, type the following command:

sc> shownetwork option

where option is -v, if desired.

The command output appears similar to the following example, with the actual IP addresses, netmask, and Ethernet addresses in your network configuration in place of xxx.xxx.xxx.xxx.

sc> shownetwork 
SC network configuration is: 
IP Address: XXX.XXX.XXX.XXX
Gateway address: XXX.XXX.XXX.XXX
Netmask: XXX.XXX.XXX.XXX 
Ethernet Address: XX:XX:XX:XX:XX:XX

shownetwork Command Option

The shownetwork command uses one option: -v.

If you type shownetwork -v, ALOM CMT returns additional information about your network, including information about your DHCP (Dynamic Host Configuration Protocol) server, if you have one configured. See Configuring Your Network Using DHCP.

Related Information

• ALOM CMT Shell Commands

showplatform

Use the showplatform command to display information about the host server's platform ID and status.

  At the sc> prompt, type showplatform.

The command returns information similar to the following:

sc> showplatform
SUNW,Sun-Fire-T1000
Chassis Serial Number: 0529AP000882
 
Domain Status
------ ------
S0     OS Standby
 
sc>

Related Information

ALOM CMT Shell Commands

showsc

Use the showsc command to display information about the ALOM CMT software configuration and firmware version.

  Take one of the following actions:

• To display all configuration information for ALOM CMT, type the following command at the sc> prompt:


sc> showsc

For example:

sc> showsc -v
Advanced Lights Out Manager CMT v1.4
 
parameter                value
---------                -----
if_network               true
if_connection            ssh
if_emailalerts           false
if_snmp                  false
netsc_dhcp               false
netsc_ipaddr             129.148.57.109
netsc_ipnetmask          255.255.255.0
netsc_ipgateway          129.148.57.254
mgt_mailhost
mgt_mailalert
mgt_snmptraps            none
mgt_traphost
sc_customerinfo
sc_escapechars           #.
sc_powerondelay          false
sc_powerstatememory      false
sc_clipasswdecho         true
sc_cliprompt             wgs57-108-sc
sc_clitimeout            0
sc_clieventlevel         2
sc_backupuserdata        true
diag_trigger             power-on-reset error-reset
diag_verbosity           none
diag_level               min
diag_mode                off
sys_autorunonerror       false
sys_autorestart          reset
sys_eventlevel           2
ser_baudrate             9600
ser_parity               none
ser_stopbits             1
ser_data                 8
netsc_enetaddr           00:03:ba:d8:b2:ac
sys_enetaddr             00:03:ba:d8:b2:a4

  To display the values for a particular firmware version, type the following command at the sc> prompt:

sc> showsc version -v

For example

sc> showsc version -v
Advanced Lights Out Manager CMT v1.4
SC Firmware version: CMT 1.4.0
SC Bootmon version: CMT 1.4.0
 
VBSC 1.4.0
VBSC firmware built Feb 21 2007, 14:44:13
 
SC Bootmon Build Release: 01
SC bootmon checksum: 2265035F
SC Bootmon built Feb 21 2007, 14:35:07
 
SC Build Release: 01
SC firmware checksum: 7F694B4F
 
SC firmware built Feb 21 2007, 14:46:34
SC firmware flashupdate THU FEB 22 14:36:16 2007
 
SC System Memory Size: 32 MB
SC NVRAM Version = 14
SC hardware type: 4
 
FPGA Version: 4.2.2.7

  To display the values for a particular configuration variable, type the following command at the sc> prompt:

sc> showsc param

where param is the param option. For example,

sc> showsc if_network
true
sc> 

See Using ALOM CMT Configuration Variables for further information.

showsc Command Options

The showsc command uses the following options. If you type showsc without using any options, ALOM CMT displays all of its configuration variables.

Related Information

• ALOM CMT Shell Commands

showusers

Use the showusers command to display the list of users currently logged in to ALOM CMT. The list includes details such as the type of connection, the duration of each user's session, the IP address of the client (if the user is using a network connection), and whether the user has the host system console's write lock. Whether this is a write lock determines whether the user can type input in a console session, or just monitor the console stream in read-only mode.

  At the sc> prompt, type the following command:

sc> showusers option

where option is -g lines, if desired. For example:

sc> showusers
username connection  login time      client IP addr     console 
--------------------------------------------------------------
admin     serial     Sep 16 10:30
joeuser   ssh-1      Sep 14 17:24    123.123.123.123    
sueuser   ssh-2      Sep 15 12:55    123.223.123.223

If a user has more than one session running, each session is listed.

showusers Command Option

The showusers command uses one option: -g lines.

This option pauses the display after the number of lines you specify for lines. After each pause, ALOM CMT returns the message:

--pause-- Press 'q' to quit, any other key to continue 

If ALOM CMT encounters an alert condition or an event, it displays the information after this message. Press any key to continue, or press q to exit the display and return to the sc> prompt.

ssh-keygen

Use the ssh-keygen command to generate a new set of Secure Shell (SSH) host keys and display the host key fingerprint on the system controller. The default format (rsa) of the fingerprint is as follows:

md5 1024 a3:28:0d:45:01:e4:ba:21:c8:13:90:df:4e:69:7a.5e

  At the sc> prompt, type the following command:

sc> ssh-keygen options

where options are any of the options listed in TABLE 7-18.

ssh-keygen Command Options

The ssh-keygen command uses the following options.

Related Information

• restartssh

useradd

Use the useradd command to add a user account to ALOM CMT.

  At the sc> prompt, type the following command:

sc> useradd username 

where username is the name of the user whose account you want to add to ALOM CMT.

username has the following restrictions:

• Valid characters include alphabetic (letter) and numeric characters, period (.), underscore (_), and hyphen (-).
• The name can have a maximum length of 16 characters, at least one of which must be a lowercase alphabetic character.
• The first character must be alphabetic.

You can add a maximum of 15 unique user accounts to ALOM CMT.

To assign a password to a user name, use the userpassword command. See userpassword.

To set permission levels for a user name, use the userperm command. See userperm.

Related Information

• ALOM CMT Shell Commands

userdel

Use the userdel command to delete an ALOM CMT user account. Once the account is deleted, the deleted user's configuration information can never be recovered.

If the user name you specify is not on the list of ALOM CMT users, ALOM CMT returns an error message. Likewise, if there is only one user on the list, ALOM CMT will not delete that user account.

  At the sc> prompt, type the following command:

sc> userdel useracct

where useracct is the name of the user account you want to delete.

userdel Command Option

The userdel command uses one option: -y.

If you specify the -y option, userdel deletes the account without prompting the following confirmation question:

Are you sure you want to delete user username [y/n]?

Related Information

• ALOM CMT Shell Commands

userpassword

Use the userpassword command to change the password for the specified user account. This command is for administrators who need to change user passwords on ALOM CMT, but who might not know what the user account passwords are. If you are trying to change the password on your own ALOM CMT account, use the password command. See password.

  At the sc> prompt, type the following command:

sc> userpassword username 

where username is the name of the user account for which you want to change the password.

When you use this command, ALOM CMT does not prompt you for the existing password.

For example:

sc> userpassword username 
New password: 
Re-enter new password: 
sc>

Password Restrictions

Passwords have the following restrictions:

• They must contain between six and eight characters.
• They must contain at least two alphabetic characters (uppercase or lowercase letters) and at least one numeric or special character.
• They must differ from your login name, and any reverse or circular shift of your login name. For comparison purposes, uppercase and lowercase letters are equivalent.
• They must differ from the old password by at least three characters. For comparison purposes, uppercase and lowercase letters are equivalent.

Related Information

ALOM CMT Shell Commands

userperm

Use the userperm command to set or change permission levels for a specified user account. By default, the initial setup procedure creates the ALOM CMT admin account. This account cannot be deleted, nor can you change the user permissions for the account.

Permission Levels

All users can read ALOM CMT information, but you need authorization to perform ALOM CMT functions or change settings.

If you do not assign a permission level to the specified user (that is, you assign zero permission levels), then that user has read-only permission. This is the default level for a new ALOM CMT user account.

There are four permission levels that increase a user's authorization. You can specify zero through four permission levels.

To see a user's permission levels, use the usershow command. See usershow.

  At the sc> prompt, type the following command:

sc> userperm username permissions

where username is the name of the user to whom you want to assign permissions, and permissions are the permissions you want to assign to that user.

For example, to assign c and r user permissions to user msmith, type the following at the ALOM CMT command prompt:

sc> userperm msmith cr 

To see a user's permission levels, use the usershow command.

A user with no permissions (read-only) can use only the following commands:

• help
• logout
• password
• setlocator
• showdate
• showenvironment
• showfaults
• showfru
• showhost
• showkeyswitch
• showlocator
• showlogs
• shownetwork
• showplatform
• showsc
• showusers

A user who has read-only permissions would appear similar to the user jeremy in the following example:

sc> usershow
Username        Permissions       Password
--------------- ----------------- ------------ 
admin           cuar              Assigned 
jeremy          ----              Assigned

Related Information

• ALOM CMT Shell Commands

usershow

Use the usershow command to display a specified user's ALOM CMT account, along with each user's permissions and whether a password has been assigned. Refer to userperm and userpassword.

If you do not enter a username, usershow displays all of the ALOM CMT accounts.

  At the sc> prompt, type the following command:

sc> usershow username

where username is the name of the specified user.

For example:

sc> usershow
Username Permissions Password? 
admin     cuar       Assigned 
wwilson   cuar       Assigned 
jadams    --cr       None

sc> usershow wwilson
Username Permissions Password?
wwilson  cuar        Assigned

Related Information

• ALOM CMT Shell Commands

^{1 (TableFootnote) You need r permission to poweroff the server, whereas the setkeyswitch command requires a permission.}

Advanced Lights Out Management (ALOM) CMT v1.4 Guide

819-7991-10

Copyright © 2007, Sun Microsystems, Inc. All Rights Reserved.