Basic Commands
showdate
showsc
showsc version -v
showenvironment
showfaults -v
showfru
showplatform -v
shownetwork
showusers
showlogs -v
showkeyswitch
showcomponent
consolehistory -v
Advanced Lights Out Manager (ALOM) Commands
Become familiar with ALOM commands to assist with troubleshooting
Commands |
Options |
Descriptions |
|
poweron |
None |
Applies power to the managed system |
|
poweroff |
-y, -f |
Shuts down the managed system to the powered off state |
|
reset |
-y, -x |
Resets the managed system |
|
break |
-y |
Causes the SC to send a break to the managed system OS which causes Solaris OE to drop into either kadb or OBP depending on the mode in which Solaris OE was booted. |
|
bootmode |
normal |
Provides control over the managed system OBP firmware behavior during system initialization |
|
reset_nvram |
|||
diag |
|||
skip_diag |
|||
console |
-f |
Connects this user session to the managed system. |
|
consolehistory |
-b lines |
Displays the contents of the selected OS console output buffer for the managed system. |
|
-e lines |
|||
-g lines |
|||
-v |
|||
boot|run |
|||
showlogs |
-b lines |
Displays the contents of the managed system eventlog |
|
-e lines |
|||
-g lines |
|||
-v |
|||
setlocator |
on, off |
Causes SC to turn the managed system locator indicator on or off |
|
showlocator |
None |
Displays the managed system locator indicator current state |
|
showenvironment |
-v |
Displays the environmental status information available to the SC for the managed system |
|
showfru |
None |
Prints out the FRU-ID data stored in the FRU PROM |
|
showplatform |
-v |
Displays the details from the SC of the hardware configuration of the platform and whether that hardware is providing service |
|
showsc |
-v, param |
Displays the details of the SC software configuration |
|
shownetwork |
-v |
Displays the current network configuration parameters |
|
setsc |
param, value |
Allows the user to individually configure SC parameters |
|
showdate |
None |
Display the current SC date and time |
|
setdate |
mmdd|HHMM |
Allows the user to set the current SC date and time |
|
mmddHHMM |
|||
cc|yy |
|||
.SS |
|||
resetsc |
-y |
Reset the SC that is active and to which the user is interacting through the CLI |
|
flashupdate |
-s IPaddr |
Downloads a new firmware image to the active SC |
|
-f pathname |
|||
-v |
|||
setdefaults |
-y |
Sets all the user settable SC configuration parameters to their default value as they were set when the system was shipped out |
|
useradd |
username |
Adds a new user to the SC's user database |
|
userdel |
username |
Removes an exsisting user from the SC's user database |
|
usershow |
username |
Displays the configuration details for a user account, if no argument is supplied, the details for all accounts in the database ars displyed |
|
userpassword |
username |
Allows an administrator to set an initial password for a user or to change an existing password without knowing the existing password. |
|
userperm |
username c, u, a, r |
Sets the permissions for the specified user for the managed system. |
|
password |
None |
Allows user to change their own login password |
|
showusers |
None |
Displays a list of users currently logged into the SC |
|
logout |
None |
Logs the current user out from his session with the CLI and presents the login prompt over the interface |
|
help |
None |
Provides assistance to the user of the CLI by listing the commands available and their syntax and also by providing a short description of the capabilities of each command. |
Solaris "scadm" command:
Note: The 'scadm' command is not available on the SUN4v systems.
# /usr/platform/`uname -i`/sbin/scadm help
USAGE: scadm <command> [options]
For a list of commands, type "scadm help"
scadm - COMMANDS SUPPORTED
help, date, set, show, resetrsc, download, send_event, modem_setup,
useradd, userdel, usershow, userpassword, userperm, shownetwork,
consolehistory, fruhistory, loghistory, version
scadm - COMMAND DETAILS
scadm help => this message
scadm date [-s] | [[mmdd]HHMM | mmddHHMM[cc]yy][.SS] => print or set date
scadm set <variable> <value> => set variable to value
scadm show [variable] => show variable(s)
scadm resetrsc [-s] => reset SC (-s soft reset)
scadm download [boot] <file> => program firmware or [boot] monitor
scadm send_event [-c] "message" => send message as event (-c CRITICAL)
scadm modem_setup => connect to modem port
scadm useradd <username> => add SC user account
scadm userdel <username> => delete SC user account
scadm usershow [username] => show user details
scadm userpassword <username> => set user password
scadm userperm <username> [cuar] => set user permissions
scadm shownetwork => show network configuration
scadm consolehistory [-a] => show SC console log
scadm fruhistory [-a] => show SC FRU log
scadm loghistory [-a] => show SC event log
scadm version [-v] => show SC version (-v verbose)
Most Commonly used ALOM commands (Cheat Sheet)
The ALOM (advanced light-outs manager) command shell enables you to administer, diagnose, or control the host server. Below are some of the most commonly used ALOM commands.
sc> help Available commands ------------------ poweron [-c] {FRU} poweroff [-y] [-f] removefru [-y] {FRU} reset [-y] [-x] [-c] break [-y] [-c] bootmode [normal|reset_nvram|diag|skip_diag|bootscript="string"] console [-f] consolehistory [-b lines|-e lines] [-g lines] [-v] [boot|run] showlogs [-b lines|-e lines] [-g lines] [-v] setlocator [on|off] showlocator showenvironment showfru showplatform [-v] showsc [-v] [param] shownetwork [-v] setsc [param] [value] setupsc showdate setdate [[mmdd]HHMM | mmddHHMM[cc]yy][.SS] resetsc [-y] flashupdate [-s IPaddr -f pathname] [-v] setdefaults [-y] [-a] useradd userdel [-y] usershow [username] userpassword userperm [c][u][a][r] password showusers [-g lines] logout help [command]
Connecting console
To login into the console from ALOM
SC> console
To take the console forcefully if already someone else has logged into console.
SC> console -f
To come out of the console use the escape character set. For example :
#.
To set the escape character to #.
sc> setsc sc_escapechars #.
To logout from the ALOM
SC> logout
Show commands to gather system info
To check the sensor values
SC> showenvironment
To check the hardware model and domain status
SC> showplatform
To print the FRU-ID data stored in the FRU PROM
SC> showfru
To display the details of the SC software configuration
SC> showsc
Network commands
There are 2 ways to set the ALOM IP address. Using the setupsc to set all the network configuration variables or using the setsc command to set the network configuration variables separately.
To setup the ALOM IP address manually using setsc
sc> setsc set if_network true sc> setsc netsc_dhcp false sc> setsc netsc_ipaddr 192.168.1.10 sc> setsc netsc_ipnetmask 255.255.255.0 sc> setsc netsc_ipgateway 192.168.1.1 sc> resetsc Are you sure you want to reset the SC [y/n]? y
To display current network configuration
SC> shownetwork -v
User administration
Below are the commands used for adminstrating user accounts on system controller (SC).
SC> usershow user_name -- shows configuration details of a user SC> useradd user_name -- add new user SC> userdel user_name -- delete the user SC> userpassword user_name -- set/reset user password SC> userperm user_name -- Sets the permissions SC> password -- change your own password SC> showusers -- Displays currently logged in users
Poweron/poweroff/break Commands
To poweron the system
SC> poweron
To poweroff the system
SC> poweroff
To reset the system
SC> reset
To send break signal to solaris OS
SC> break
To set the bootmode to [ normal|reset_nvram|diag|skip_diag ]
SC> bootmode boot_mode
Logs and history
SC> showlogs -v SC> consolehistory
Locator commands
To Display the locator indicator current state and to set it on/off
SC> showlocator SC> setlocator [on|off]
OS commands to view ALOM info (sun4u system only)
# cd /usr/platform/`uname -i`/sbin/scadm (path of scadm command) # scadm resetrsc [-s] [ -s for soft reset ] # scadm set# scadm show [variable] # scadm useradd user_name # scadm userdel user_name # scadm usershow user_name # scadm userpassword user_name # scadm userperm user_name # scadm shownetwork # scadm consolehistory -a # scadm loghistory -a # scadm version -v