C H A P T E R  5

Using the ALOM Command Shell

This chapter contains the following sections:


Overview of the ALOM Command Shell

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

You are in the ALOM command shell when you see the sc> prompt. ALOM 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 account, the ALOM shell prompt (sc>) appears, and you can enter ALOM shell commands. See Logging In to Your ALOM Account and ALOM Shell Commands for assistance.


procedure icon  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 Shell Commands

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


TABLE 5-1 List of ALOM Shell Commands by Function

CLI Command

Summary

Full Description

Configuration Commands

password

Changes the login password of the current user.

password.

setdate [[mmdd]HHMM |mmddHHMM[cc]yy][.SS]

Sets ALOM date and time.

setdate

setdefaults [-y] [-a]

Resets all ALOM configuration parameters to their default values. The -y option enables you to skip the confirmation question. The -a option resets the user information to the factory default (one admin account only).

setdefaults

setkeyswitch [normal|stby|diag|
locked] [-y]

Set the status of the virtual keyswitch. Setting the virtual keyswitch to standby (stby) powers off the server. Before powering off the host server, ALOM asks for a confirmation. The -y flag answers yes to the confirmation.

setkeyswitch

setsc [param] [value]

Sets the specified ALOM parameter to the assigned value.

setsc

setupsc

Runs the interactive configuration script. This script configures the ALOM configuration variables.

setupsc

showplatform [-v]

Displays information about the host system's hardware configuration, and whether the hardware is providing service. The -v option displays verbose information about the displayed components.

showplatform

showfru [-g lines]
[-s|-d] [FRU]

Displays information about the field-replaceable units (FRUs) in a host server.

showfru

showusers [-g lines]

Displays a list of users currently logged in to ALOM. The display for this command has a similar format to that of the UNIX command who. The -g option pauses the display after the number of lines you specify for lines.

showusers

showhost [version]

Displays version information for host-side components

showhost

showkeyswitch

Display status of virtual keyswitch.

showkeyswitch

showsc [-v] [param]

Displays the current non-volatile read-only memory (NVRAM) configuration parameters. The -v option is needed for full version information.

showsc

showdate

Displays the ALOM date. The Solaris OS and ALOM time are synchronized, but ALOM time is expressed in Coordinated Universal Time (UTC) rather than local time.

showdate

usershow [username]

Displays a list of all user accounts, permission levels, and whether passwords are assigned.

usershow

useradd [username]

Adds a user account to ALOM.

useradd

userdel [-y] [username]

Deletes a user account from ALOM. The -y option enables you to skip the confirmation question.

userdel

userpassword [username]

Sets or changes a user password.

userpassword

userperm [username] [c] [u] [a] [r]

Sets the permission level for a user account.

userperm

Log Commands

 

 

showlogs
[-b lines|-e lines|-v]
[-g lines] [-p logtype [r|p]]

Displays the history of all events logged in the ALOM RAM event log or major and critical events in the persistent log. The -p option selects whether to display entries only from the RAM event log (logtype r) or the persistent event log (logtype p).

showlogs

consolehistory
[-b lines|-e lines|-v]
[-g lines] [boot|run]

Displays the host server console output buffers. The -v option displays the entire contents of the specified log.

consolehistory

Status and Control Commands

 

showenvironment

Displays the environmental status of the host server. This information includes system temperatures, power supply status, front panel LED status, hard disk drive status, fan status, voltage, and current sensor status.

showenvironment

shownetwork [-v]

Displays the current network configuration information. The -v option shows additional information about your network, including information about your DHCP server.

shownetwork

console [-f]

Connects to the host system console. The -f option forces the console write lock from one user to another.

console

break [-y] [-c]

Drops the host server from running the Solaris OS software into OpenBoot PROM or kmdb.

break

bootmode [normal] [reset_nvram] [bootscript=string]

Controls the host server OpenBoot PROM firmware method of booting.

bootmode

flashupdate -s IPaddr -f pathname [-v]

Downloads and updates system firmware (both host firmware and ALOM firmware).

flashupdate

reset [-y] [-c]

Generates a hardware reset on the host server. The -y option enables you to skip the confirmation question.

reset

powercycle [-f]

poweroff followed by poweron. The -f option forces an immediate poweroff, otherwise the command attempts a graceful shutdown.

powercycle

poweroff [-y] [-f]

Removes the main power from the host server. The -y option enables you to skip the confirmation question. ALOM attempts to shut the server down gracefully. The -f option forces an immediate shutdown.

poweroff

poweron [-c] [FRU]

Applies the main power to the host server or FRU.

poweron

setlocator [on/off]

Turns the Locator LED on the server on or off.

setlocator

showfaults [-v]

Displays current valid system faults.

showfaults

clearfault [UUID]

Manually repair system faults.

clearfault

showlocator

Displays the current state of the Locator LED as either on or off.

showlocator

FRU Commands

 

 

setfru -c data

The -c option enables you to store information (such as inventory codes) on all FRUs in a system.

setfru

showfru [-g lines]
[-s|-d] [FRU]

Displays information about the FRUs in a host server.

showfru

removefru [-y] [FRU]

Prepares a FRU (for example, a power supply) for removal. The -y option enables you to skip the confirmation question.

removefru

showfaults [-v]

Displays current valid system faults.

showfaults

clearfault [UUID]

Manually repair system faults.

clearfault

Automatic System Recovery (ASR) Commands

 

 

enablecomponent
asr-key

Removes a component from the asr-db blacklist.

enablecomponent

disablecomponent
asr-key

Adds a component to the asr-db blacklist.

 

disablecomponent

showcomponent asr-key

Displays system components and their test status (ASR state).

showcomponent

clearasrdb

Removes all entries from the asr-db blacklist.

clearasrdb

Other Commands

 

 

help [command]

Displays a list of all ALOM commands with their syntax and a brief description of how each command works. Specifying a command name as an option enables you to view the help for that command.

help

resetsc [-y]

Reboots ALOM. The -y option enables you to skip the confirmation question.

resetsc

showlogs
[-b lines|-e lines|-v]
[-g lines] [-p logtype [r|p]]

Displays the history of all events logged in the ALOM RAM event log or major and critical events in the persistent log. The -p option selects whether to display entries only from the RAM event log (logtype r) or the persistent event log (logtype p).

showlogs

usershow [username]

Displays a list of all user accounts, permission levels, and whether passwords are assigned.

usershow

useradd username

Adds a user account to ALOM.

useradd

userdel [-y] username

Deletes a user account from ALOM. The -y option enables you to skip the confirmation question.

userdel

userpassword username

Sets or changes a user password.

userpassword

userperm username [c] [u] [a] [r]

Sets the permission level for a user account.

userperm

logout

Logs out from an ALOM shell session.

logout


Related Information


ALOM Shell Command Descriptions

The following pages provide full descriptions of the ALOM 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 non-volatile read-only memory (NVRAM) variables

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


procedure icon  To Use the bootmode Command



Note - You must have a level user permission to use this command. Refer to userperm for more information.



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.

single-step bulletAt the sc> prompt, type the following command:


sc> bootmode reset_nvram 
sc> reset 


procedure icon  To View bootmode Settings

single-step bulletAt the sc> prompt, type the following command:


sc> bootmode
sc> reset 

Bootmode: reset_nvram

Expires WED MAR 05 21:18:33 2003

bootscript="setenv diagswitch? true"


bootmode Command Options

The bootmode command uses the following options.


TABLE 5-2 bootmode Command Options

Option

Description

normal

At next reset, retains current NVRAM variable settings

reset_nvram

At next reset, returns NVRAM variables to default settings

bootscript = string

Controls the host server OpenBoot PROM firmware method of booting. It does not affect the current bootmode setting. string can be up to 64 bytes in length. You can specify a bootmode setting and set the bootscript within the same command.

For example:

sc> bootmode reset_nvram bootscript = "setenv diag-switch? true"

SC Alert: SC set bootmode to reset_nvram, will expire

20030305211833

SC Alert: SC set bootscript to "setenv diag-switch? true"

After the server resets and OpenBoot PROM reads the values stored in the bootscript, it sets the OpenBoot PROM variable diag-switch? to the user requested value of true.

Note: If you set bootmode bootscript = "", ALOM sets the bootscript to empty.


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 displays the currently selected mode and the time when it will expire.

Related Information

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.

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


procedure icon  To Use the break Command



Note - You must have c level user permission to use this command. Refer to userperm for information on setting user permissions.



single-step bulletAt the sc> prompt, type the following command:


sc> break option 

Where option is -y, -c, or no option.

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

break Command Options

The break command can have the following options:


TABLE 5-3 break Command Options

Option

Description

-y

Instructs ALOM to proceed without first asking the confirmation question: Are you sure you want to send a break to the system [y/n]?

-c

Instructs ALOM to connect to the system console after performing the operation.


Related Information

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.


procedure icon  To Use the clearasrdb Command

single-step bulletAt 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 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



Note - Faults can be reported indirectly, by way of a FRU that acts as a proxy.



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 ASR database.

console

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

Although multiple users can connect to the system console from ALOM, only one user at a time has write access to the console. Any characters that other users type are ignored. This 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 forces the other user's connection into read-only mode.


procedure icon  To Use the console Command



Note - You must have c level user permission to use this command. Refer to userperm for information on setting user permissions.



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


sc> console option

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



Note - The Solaris system prompt that appears depends on the default Solaris shell on the host server. Refer to Shell Prompts



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

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

If no session has the console in use, ALOM 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 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 -f option with the console command, ALOM 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 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

consolehistory

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

Each buffer can contain up to 64 Kbytes of information.

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


procedure icon  To Use the consolehistory Command



Note - You must have c level user permission to use this command. See userperm for information on setting user permissions.



single-step bulletAt 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 returns the last 20 lines of the run log.



Note - Timestamps recorded in console logs reflect server time. These timestamps reflect local time, and ALOM event logs use UTC (Coordinated Universal Time). The Solaris OS synchronizes system time with ALOM time.



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


TABLE 5-4 consolehistory Command Options

Option

Description

-b lines

Specifies the number of lines to display from the beginning of the log buffer. For example:

consolehistory boot -b 10

-e lines

Specifies the number of lines to display from the end of the log buffer. If new data appears in the log while you are executing this command, the new data is appended to the screen output. For example:

consolehistory run -e 15

-g lines

Specifies the number of lines to display before pausing the output to the screen. After each pause, ALOM shows the following message: Paused: Press 'q' to quit, any other key to continue. For example:

consolehistory run -v -g 5

-v

Displays the entire contents of the specified log.

boot

Specifies the boot log.

run

Specifies the run log.


Related Information

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 to display all asr-keys currently enabled. The -h (help) option lists all valid asr-keys as well as usage information.



Note - The server continues to use the blacklisted component until the next server power cycle or reset.




procedure icon  To Use the disablecomponent Command

single-step bulletAt 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 to display all asr-keys currently blacklisted.



Note - The component does not return to use until the next server power cycle or reset.




procedure icon  To Use the enablecomponent Command

single-step bulletAt 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.

You can find the links to the download sites at: http://www.sun.com/downloads/


procedure icon  To Use the flashupdate Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.



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

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 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 displays the message:

Update complete. Reset device to use new image.

3. Type the resetsc command to reset ALOM.

See resetsc for details.

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


sc> flashupdate -s 123.45.67.89 -f 
/net/server/sysfw/System_Firmware-6_0_0-Sun_Fire_T1000.bin
 
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.


TABLE 5-5 flashupdate Command Options

Option

Description

-s ipaddr

Directs ALOM to download the firmware image from a server located at ipaddr. ipaddr describes an IP address in standard dot notation, such as 123.456.789.012.

-f pathname

Directs ALOM to the location of the image file. pathname is a full directory path, including the name of the image file, such as /files/sysfw/System_Firmware-6_0_0-Sun_Fire_T1000.bin.

-v

Displays verbose output. This option provides detailed information about the progress of the download process as it occurs.


Related Information

help

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


procedure icon  To Use the help Command



Note - You do not need user permissions to use this command.



single-step bulletTake one of the following actions:

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>

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


CODE EXAMPLE 5-1 Example of the help Command Output
sc> help
Available commands
------------------
poweron [-c] {FRU}
poweroff [-y] [-f]
powercycle [-y] [-f]
removefru [-y] {FRU}
reset [-y] [-c]
break [-y] [-c]
console [-f]
consolehistory [-b lines|-e lines] [-g lines] [-v] [boot|run]
bootmode [normal|reset_nvram|bootscript="string"]

showlogs [-b lines|-e lines|-v] [-g lines] [-p logtype [r|p]]

setkeyswitch [-y] <normal|stby|diag|locked>
showkeyswitch
setlocator [on|off]
showlocator
showenvironment
showfaults [-v]
clearfault <UUID>
showfru [-g lines] [-s|-d] [FRU]
setfru -c [data]
showplatform [-v]
showsc [-v] [param]
shownetwork [-v]
setsc [param] [value]
showhost [version]
setupsc
showdate
setdate [[mmdd]HHMM | mmddHHMM[cc]yy][.SS]
resetsc [-y]
flashupdate <-s IPaddr -f pathname> [-v]
setdefaults [-y] [-a]
useradd <username>
userdel [-y] <username>
usershow [username]
userpassword <username>
userperm <username> [c][u][a][r]
password
showusers [-g lines]
enablecomponent [asr-key]
disablecomponent [asr-key]
showcomponent [asr-key]
clearasrdb
logout
help [command]

Related Information

logout

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


procedure icon  To Use the logout Command



Note - You do not need user permissions to use this command.



At the sc> prompt, type the following command:


sc> logout

Related Information

password

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


procedure icon  To Use the password Command



Note - This command enables you to change the password for your own ALOM account. You do not need user permissions to use this command. If you are an administrator and want to change a user account's password, use the userpassword command. See userpassword for more information.



single-step bulletAt the sc> prompt, type password.

When you use this command, ALOM 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:

Related Information

powercycle

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


procedure icon  To Use the powercycle Command



Note - You must have r level user permission to use this command. See userperm for information on setting user permissions.



single-step bulletAt the sc> prompt, type the following command:


sc> powercycle [-f] [-y]

TABLE 5-6 powercycle Command Options

Option

Description

-y

Instructs ALOM to proceed without prompting.

-f

Forces an immediate shutdown regardless of the state of the host. If the Solaris OS shutdown fails for any reason, use this option to force the system to be powered off immediately. This command works like the Solaris OS command halt; that is, it does not perform a graceful shutdown of the system or synchronize the file systems.


 

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 is still available when the server is powered off, since ALOM uses the server's standby power. Some environmental information is not available when the server is in standby mode.


procedure icon  To Use the poweroff Command



Note - You must have r level user permission to use this command. See userperm for information on setting user permissions.



single-step bulletAt 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 attempts to wait for a graceful shutdown to complete before the system is powered off.



Note - After the poweroff command shuts down the system, ALOM issues the following message:




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.


TABLE 5-7 poweroff Command Options

Option

Description

-y

Instructs ALOM to proceed without prompting.

-f

Forces an immediate shutdown regardless of the state of the host. If the Solaris OS shutdown fails for any reason, use this option to force the system to be powered off immediately. This command works like the Solaris OS command halt; that is, it does not perform a graceful shutdown of the system or synchronize the file systems.


Related Information

poweron

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


procedure icon  To Use the poweron Command



Note - You must have r level user permission to use this command. Refer to userperm for information on setting user permissions.



single-step bulletAt the sc> prompt, type the following command:


sc> poweron [fru] [-c]



Note - If you have just used the poweroff command to power off the host server, ALOM issues the following message:




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.


TABLE 5-8 poweron Command Options

Option

Description

fru

No FRUs can be powered on independently. This option is reserved for future use

-c

Instructs ALOM to connect to the system console after performing the operation.


Related Information

removefru

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


procedure icon  To Use the removefru Command

single-step bulletAt 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



Note - On Sun Fire T1000 servers, attempting to use the removefru command on PS0 generates the following error message:




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

removefru Command Options

The removefru command uses the following options.


TABLE 5-9 removefru Command Options

Option

Description

fru

The name of the FRU you want to prepare for removal

-y

Instructs ALOM to proceed without prompting with a confirmation question.


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


TABLE 5-10 removefru FRU Values

Value

Description

PS0

Prepares Power Supply 0 in the host server for removal.

PS1

Prepares Power Supply 1 in the host server 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.


procedure icon  To Use the reset Command



Note - You must have r level user permission to use this command. Refer to userperm for information on setting user permissions.



single-step bulletAt 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 Overview of the ALOM Command Shell.


TABLE 5-11 reset Command Options

Option

Description

-c

Instructs ALOM to connect to the system console after performing the operation.

-y

Instructs ALOM to proceed without prompting.


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

resetsc

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


procedure icon  To Use the resetsc Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.



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


sc> resetsc option

Where option is -y, if desired.

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

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

setdate

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

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


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



Note - The setdate command works only when the server is powered off.




procedure icon  To Use the setdate Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.



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 applies the current values as defaults. You can also omit the century value and the value for seconds in the time.



Note - Your server uses local time, but ALOM uses Coordinated Universal Time (UTC). ALOM does not accept time zone conversions or daylight time changes..



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.


TABLE 5-12 setdate Command Options

Option

Description

mm

Month

dd

Day

HH

Hour (24-hour system)

MM

Minutes

.SS

Seconds

cc

Century (first two digits of the year)

yy

Year (last two digits of the year)


Related Information

setdefaults

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

To Use the setdefaults Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions. You need to set the password to execute permission-level commands.



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 reset ALOM.

When ALOM resets, it uses the factory default values.

setdefaults Command Options

The setdefaults command uses the following options.


TABLE 5-13 setdefaults Command Options

Option

Description

-a

Sets all ALOM configuration variables to their factory defaults and clears the user account and configuration information as well. The only account that remains on the system is the admin user account with no password.

-y

Instructs ALOM to proceed without first asking the confirmation question: Are you sure you want to reset the SC configuration?


Related Information

setfru

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


procedure icon  To Use the setfru Command

single-step bulletAt 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.


procedure icon  To Use the setkeyswitch Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions. You need to set the password to execute permission-level commands.



single-step bulletAt the sc> prompt, type the following command:


sc> setkeyswitch option

setkeyswitch Command Options

The setkeyswitch command uses the following options:


TABLE 5-14 setkeyswitch Command Options

Option

Description

normal

The system can power itself on and start the boot process.

stby

The system cannot power itself on.

diag

The system can power itself on using the preset values of diagnostic variables to provide thorough fault coverage (see Descriptions of Configuration Variables). This option overrides the values of diagnostic variables that you might have set. For information about user-configurable diagnostic control variables, see Diagnostic Control Variable.

locked

The system can power itself on, however you are prohibited from updating any of the flash devices (see flashupdate) or using the break command.

-y

Setting the virtual keyswitch to standby (stby) powers off the server. Before powering off the host server, ALOM asks for a confirmation. The -y flag answers yes to the confirmation.[1]


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.



Note - You do not need user permissions to use this command.



single-step bulletAt 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

setsc

The ALOM 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 configuration, you set up the initial configuration with the setupsc command. If you need to update a setting after your initial ALOM configuration, use the setsc command. For information about your configuration, see ALOM Configuration Steps. For more about the setupsc command, see setupsc.


procedure icon  To Use the setsc Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.



Make sure 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 Configuration Variables for more information.

single-step bulletAt 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 returns a list of the variables you can configure.

Related Information

setupsc

Use the setupsc command to customize ALOM.

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 Configuration Variables for more information.


procedure icon  To Use the setupsc Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.



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:

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.

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

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:



Note - You do not need to set or adjust the serial interface variables. These variables are automatically set for you by the host server.



Related Information

showcomponent

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


procedure icon  To Use the showcomponent Command



Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.



single-step bulletAt the sc> prompt, type the following command:


sc> showcomponent

For example,


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

showdate

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

Note that ALOM shows Coordinated Universal Time (UTC), and that your host server shows your local date and time.


procedure icon  To Use the showdate Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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 date and time, use the setdate command. See setdate.



Note - When the server boots, it synchronizes with the current ALOM date and time.



Related Information

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


procedure icon  To Use the showenvironment Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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 may be different for your system, such as the number of power supplies and hard drives


CODE EXAMPLE 5-2 Example of showenvironment Command Output for Sun Fire T2000 Server (Power On)
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.06      --    2.69      --       --
 
-----------------------------------------------------------
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 Sun Fire T1000, is powered on:


CODE EXAMPLE 5-3 Example of showenvironment Command Output for Sun Fire T1000 Server (Power 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


CODE EXAMPLE 5-4 Example of showenvironment Command Output (Power 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

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.


procedure icon  To Use the showfaults Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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:


TABLE 5-15 showfru Command Options

Option

Description

-g lines

Specifies the number of lines to display before pausing the output to the screen. After each pause, ALOM shows the following message: Paused: Press 'q' to quit, any other key to continue.

-s

Displays static information about system FRUs (defaults to all FRUs, unless one is specified).

-d

Displays dynamic information about system FRUs (defaults to all FRUs, unless one is specified).

FRU

Individual FRUs.



procedure icon  To Use the showfru Command



Note - You do not need user permission to use this command.



single-step bulletAt the sc> prompt, type the following command:


sc> showfru argument

The following example shows sample output for the showfru command on a Sun Fire T2000 server, supplying an invalid argument


CODE EXAMPLE 5-5 Example of showfru Command Output On Sun Fire T2000, Displaying Valid Arguments
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

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


CODE EXAMPLE 5-6 Example of showfru Command Output On Sun Fire T1000, Displaying Valid Arguments
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


CODE EXAMPLE 5-7 Example of showfru Command Output, Using a Valid Argument
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

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


sc> showfru FIOBD/SEEPROM
 
/Status_EventsR (1 iterations)
/Status_EventsR[0]
/Status_EventsR[0]/UNIX_Timestamp32:      FRI MAY 20 11:26:48 2005
/Status_EventsR[0]/Old_Status:            0x00 (OK)
/Status_EventsR[0]/New_Status:            0x64 (MAINTENANCE REQUIRED, 
SUSPECT, DEEMED FAULTY)
/Status_EventsR[0]/Initiator:             0xE0 (FM)
/Status_EventsR[0]/Component:             0x00
/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
 
...
 
/Status_Proxy1R/
/Status_Proxy1R/UNIX_Timestamp32: THU JAN 01 00:00:00 1970
/Status_Proxy1R/version:          0x00
/Status_Proxy1R/StatusMap31: 
0x00000000000000000000000000000000000000000000000000000000000000
/Status_CurrentR/
/Status_CurrentR/UNIX_Timestamp32: FRI MAY 20 11:26:48 2005
/Status_CurrentR/status:           0x64 (MAINTENANCE REQUIRED, SUSPECT, DEEMED FAULTY)

Related Information

showhost

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


procedure icon  To Use the showhost Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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.


procedure icon  To Use the showkeyswitch Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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.



Note - This command works only with servers that have the front panel Locator LED.




procedure icon  To Use the showlocator Command



Note - You do not need user permissions to use this command.



single-step bulletAt the sc> prompt, type the following command:


sc> showlocator 

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

Related Information

showlogs

Use the showlogs command to display the history of events logged in the ALOM event buffer. These events include server reset events and all ALOM 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 hostname: message 

Where:

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


procedure icon  To Use the showlogs Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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."



Note - Timestamps shown in the ALOM event log reflect UTC.



This example shows the output of the showlogs command with the -v option. The -v option displays the persistent event log. The persistent event log is comprised of the contents of NVRAM.


CODE EXAMPLE 5-8 Example of showlogs -v Command Output

sc> showlogs -v 
Persistent event log
-------------------- 
MAY 19 11:22:03 : 0004000e: "SC Request to Power Off Host Immediately." 
MAY 19 11:22:12 : 00040029: "Host system has shut down." 
MAY 19 11:22:43 : 00040002: "Host System has Reset" 
Log entries since MAY 19 14:57:08
---------------------------------- 
MAY 19 14:57:08 : 00060003: "SC System booted." 
MAY 19 14:57:35 : 00060000: "SC Login: User rich Logged on."

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 option (persistent log, in which case the display pauses after every 25 lines).


TABLE 5-16 showlogs Command Options

Option

Description

-v

Displays the entire contents of the buffer file and the contents of NVRAM (the persistent event log).

-b lines

Displays the events from the beginning of the buffer, where lines is the number of lines that you specify. For example, the following command displays the first 100 lines in the buffer:

showlogs -b 100

-e lines

Displays the events from the end of the buffer file, where lines is the number of lines that you specify. If new data appears in the log while you are executing this command, the new data is appended to the screen output. For example:

showlogs -e 10

-g lines

Controls the number of lines displayed on the screen at a given time, where lines is the number of lines that you specify.

After each pause, ALOM shows the following message:

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

If -g is set to 0 (zero), display does not pause.

-p logtype [r|p]

Controls whether to display entries only from the RAM event log (logtype r) or from the persistent event log (logtype p). The default option (if -p has not been specified) is to display entries only from the RAM log.


Related Information

shownetwork

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



Note - If you changed the ALOM network configuration since the last time you booted ALOM, the output from this command might not show the updated configuration information. Reboot ALOM to see the changed configuration. See Redirecting the System Console From ALOM to Other Devices for information on rebooting ALOM.




procedure icon  To Use the shownetwork Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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



Note - If networking is misconfigured, the shownetwork command shows 0.0.0.0 for the addresses.



shownetwork Command Option

The shownetwork command uses one option: -v.

If you type shownetwork -v, ALOM 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

showplatform

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


procedure icon  To Use the showplatform Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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 Shell Commands

showsc

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


procedure icon  To Use the showsc Command



Note - You do not need user permissions to use this command.



single-step bulletTake one of the following actions:

For example,


CODE EXAMPLE 5-9 Example of showsc Display of Configuration Information
sc> showsc
Advanced Lights Out Manager CMT v1.0
 
parameter                value
---------                -----
if_network               true
if_modem                 false
if_emailalerts           false
netsc_ipaddr             0.0.0.0
netsc_ipnetmask          255.255.255.0
netsc_ipgateway          0.0.0.0
mgt_mailhost
mgt_mailalert
sc_customerinfo
sc_escapechars           #.
sc_powerondelay          false
sc_powerstatememory      false
sc_clipasswdecho         true
sc_cliprompt             sc
sc_clitimeout            0
sc_clieventlevel         3
sc_backupuserdata        true
diag_trigger             error-reset
diag_verbosity           normal
diag_level               max
diag_mode                normal
sys_autorunonerror       false
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:a3

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


sc> showsc version -v
Advanced Lights Out Manager CMT v1.1
SC Firmware version: CMT 1.1.0
SC Bootmon version: CMT 1.1.0
 
VBSC 1.1.0.build_04
VBSC firmware built Nov 18 2005, 10:40:48
 
SC Bootmon Build Release: 04
SC bootmon checksum: 21F5458E
SC Bootmon built Nov 18 2005, 10:46:52
 
SC Build Release: 04
SC firmware checksum: C727DC4C
 
SC firmware built Nov 18 2005, 10:47:07
SC firmware flashupdate TUE NOV 08 15:45:42 2005
 
SC System Memory Size: 32 MB
SC NVRAM Version = f
SC hardware type: 4
 
FPGA Version: 4.1.9.7

Where param is the param option. For example,


sc> showsc if_network
true
sc> 

See Using ALOM Configuration Variables for further information.

showsc Command Options

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


TABLE 5-17 showsc Command Options

Option

Description

-v

When used with the param option, the -v option might display more detailed information about the specified configuration variables (depending on the variable). When used with the version option, the -v option might display more detailed information about the specified firmware version.

version

Directs the showsc command to display the version of the configuration variable or parameter you specified.

param

Directs the showsc command to display the value of the configuration variable or parameter you specified.


Related Information

showusers

Use the showusers command to display the list of users currently logged in to ALOM. 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 (this determines whether the user can type input in a console session, or just monitor the console stream in read-only mode).


procedure icon  To Use the showusers Command



Note - You do not need user permissions to use this command.



single-step bulletAt 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 
--------------------------------------------------------------
joeuser    serial   Sep 16 10:30
bigadmin   net-3    Sep 14 17:24    123.123.123.123       system
sueuser    net-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 returns the message:


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

If ALOM 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.

useradd

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


procedure icon  To Use the useradd Command



Note - You must have u level user permission to use this command. Refer to userperm for information on setting user permissions.



single-step bulletAt 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.

username has the following restrictions:

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

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

userdel

Use the userdel command to delete an ALOM 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 users, ALOM returns an error message. Likewise, if there is only one user on the list, ALOM will not delete that user account.



Note - ALOM will not delete the default admin user account.




procedure icon  To Use the userdel Command



Note - You must have u level user permission to use this command. Refer to userperm for information on setting user permissions.



single-step bulletAt 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

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, but who might not know what the user account passwords are. If you are trying to change the password on your own ALOM account, use the password command. See password.


procedure icon  To Use the userpassword Command



Note - You must have u level user permission to use this command. See userperm for information on setting user permissions.



single-step bulletAt 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 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:



Note - Passwords that do not pass the restrictions are accepted with a warning that such passwords do not meet the recommended guidelines for security.



Related Information

ALOM 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 admin account. This account cannot be deleted, nor can you change the user permissions for the account.

Permission Levels

All users can read ALOM information, but you need authorization to perform ALOM 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 user account.

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


TABLE 5-18 userperm Permission Levels

Permission Level

Description

a

Administrative. This user is authorized to change the state of ALOM configuration variables and reboot ALOM. Refer to Using ALOM Configuration Variables and resetsc.

u

User administration. This user is authorized to add users and delete users, change user permissions, and change the authorization level of other users. Refer to useradd and userdel.

c

Console permission. This user is authorized to connect to the host server system console. Refer to console.

r

Reset and power permission. This user is authorized to reset the host server, and power the server on and off.

Refer to reset, poweron, and poweroff.




Note - The default user permission for the account that you use when you start ALOM for the first time is read-only. After you set a password for the default admin account, the permissions change to cuar (full authorization).



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


procedure icon  To Use the userperm Command



Note - You must have u level user permission to use this command



single-step bulletAt 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 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:

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

usershow

Use the usershow command to display a specified user's ALOM 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 accounts.


procedure icon  To Use the usershow Command



Note - You must have u level user permission to use this command. See userperm for information on setting user permissions.



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


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