ALOM commands

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.
To check all the available 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]?

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
# 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

(path of scadm command)

LOM commands
LOM commands (V1280/E2900)
The hardware models V1280/E2900 etc uses the Lights-out management to manage
the hardware. LOM is a set of software tools on the Sun Fire V1280/E2900 servers.
LOM is used to perform user maintenance and administrative activities.

Network Related Commands

Show the current network configuration
lom> shownetwork -v

To assign an IP address to ILOM

lom> setupnetwork
Network Configuration
--------------------Is the system controller on a network? [no]: yes
Use DHCP or static network settings? [DHCP]: static
Hostname []: somename

IP Address []: 129.xxx.xxx.xxx

Netmask [255.255.255.0]: 255.255.255.0
Gateway []: 129.xxx.xxx.xxx
DNS Domain []: somewhere.nowhere.com
Primary DNS Server []: 129.xxx.xxx.xxx
Secondary DNS Server []: 129.xxx.xxx.xxx
Rebooting the SC is required for changes in network settings to take effect.

Login and logout

To login to the OS console from ILOM
lom> console

To logout from the ILOM

lom> logout

To check the current escape character

lom> showescape
#.

To set a new escape character

lom> setescape ~.

To set/reset password of the current user

lom> password
Enter new password: admin
Enter new password again: admin

LOM Hardware Info

To see all the hardware

lom> showboards

To only see the CPUs

lom> showboards -p cpu

To only see the memory modules

lom> showboards -p memory

To only see the power supply units

lom> showboards -p power

To see the version of each individual component

lom> showboards -p version

To see individual component status of a system board

lom> showcomponent sb0

To check the various sensors

lom> showenvironment

To see the logs

lom> showlogs

Poweron/poweroff
To poweron the system and boot solaris OS
lom> poweron

To poweron only a specific component

lom> poweron sb2

To shutdown Solaris OS and poweroff the system to standby mode

lom> shutdown

To poweroff the entire system

lom> poweroff

To poweroff a specific hardware component

lom> poweroff sb2

SF 6800/E6900, 3800, 4800/E4900 SC commands

The hardware models Sun Fire 3800, 4800/E4900, 4810, and 6800/E6900 uses the
system controller to manage the hardware components of individual domains that may
have been created. So we have 2 login to a specific domain system controller from
platform shell in order to manage the hardware of that domain. The showplatform
command shows all the configured domains on the system.

To check all the domain and platform related information

schostname:SC> showplatform -v

To view system controller details

schostname:SC> showsc -v

To view SC logs
schostname:SC> showlogs -v

To view current SC connections

schostname:SC> connections

To reboot a system controller

schostname:SC> reboot

Hardware Related commands

To see all the hardware details of a domain
schostname:SC> showboards

To see only the CPUs in a specific domain

schostname:SC> showboards -p cpu

To see only the memory in a specific domain

schostname:SC> showboards -p memory

To see only the power supply unit in a specific domain

schostname:SC> showboards -p power

To see the version of each individual component

schostname:SC> showboards -p version

To see individual component status of a system board

schostname:SC> showcomponent sb0

Start/stop and power cycle a Domain

To start a domain (Domain A)
schostname:A> setkeyswitch on

To stop a domain (Domain A)

schostname:A> setkeyswitch off

To see the logs of a specific domain (Domain A)

schostname:A> showlogs

To test a CPU/memory board SB0 in domain A

schostname:A> testboard sb0

To reset a domain
schostname:A> reset

To send break to the OS from Domain SC

schostname:A> send break

To flash update the system

schostname:SC> flashupdate -y -f ftp://root:[email protected]/firmware scapp rtos

ILOM commands
Integrated Lights-out Manager (ILOM) helps to manage and troubleshoot the complete
hardware of a server. With the help of ILOM we can remotely manage a server. We can
power on and power off it remotely. Let us see some of the most commonly used
commands in the ILOM shell.
Login related commands
-> start /SP/console

-- start the SP-console

-> show /SP/sessions

-- see the currently active sessions

-> stop /SP/console

-- to stop any user session

Start and stop system

-> start /SYS

(start system)

-> stop [-force] /SYS

(stop system)

-> show /SYS

(shows the power status)

-> reset /SYS

(reset host)

-> reset /SP

(reset ILOM SP)

-> set /HOST send_break_action=break

(send break signal to the OS)

-> reset /CMM

(to reset CMM on a blade Chassis)

Locator commands
To set the locator on or off

-> set /SYS LOCATE=on

-> set /SYS LOCATE=off

Networking Commands To see the current network configuration of ILOM

-> show /SP/network

To set an IP address for ILOM

-> set pendingipdiscovery=static
-> set pendingipaddress=10.10.10.10
-> set pendingipnetmask=255.255.255.0
-> set pendingipgateway=10.10.10.1
-> set commitpending=true

To show SP MAC address

show /SP/network macaddress

If on a Blade chassis, to check the CMM IP :

-> show /CMM/network

User administration
-> show /SP/users

(Display all the ILOM users)

-> show /SP/user/admin

(Display configuration settings of a specific user)

-> create /SP/users/user_name password=PWD role=[administrator|operator]

(create

new user)
-> delete /SP/users/username

(Delete a user)

-> set /SP/users/admin01 role=administrator

-> set /SP/users/admin01

(set the role of a user)

(set or change password of user)

Monitoring and logs

-> show /SP/logs/event/list

(ILOM event log)

-> show -level all -output table /SP/faultmgmt

(List all hardware faults)

-> show -level all -output table /SYS type==Temperature value

(List all

temperature sensor readings)

hardware info
-> show -level all -output table /SYS type==DIMM

(show DIMMS)

-> show -level all -output table /SYS type=='Host Processor'

(show CPUs)

-> show -l all /SYS type=='Hard Disk'

(show disks)

XSCF commands
The eXtended System Control Facility Unit (XSCFU) is a service processor that
operates and administrates both midrange servers. The XSCFU diagnoses and starts
the entire server, configures domains, offers dynamic reconfiguration, as well as detects
and notifies various failures. The XSCFU enables standard control and monitoring
function through network. Using this function enables starts, settings, and operation
managements of the server from remote locations.
Connecting a domain
Check for the available domains on the servers :

XSCF> showdomainstatus -a
DID Domain

Status

00

Running

01

Running

02

Running

03

Now to connect to the domain with ID 00 :

XSCF> console -d 0

Power/reboot/reset/panic commands
Poweron all domains
XSCF> poweron -a

Poweron only domain 0

XSCF> poweron -d 0

Poweroff all domains

XSCF> poweroff -a

Poweroff domain 0
XSCF> poweroff -d 0

Reboot XSCF
XSCF> rebootxscf

The 3 modes to reset a domain are :

por: To reset the domain
panic: To panic the domain
xir: To reset the CPU in domain
XSCF> reset -d 0 por
XSCF> reset -d 0 panic
XSCF> reset -d 0 xir

Send a break signal to a domain (with ID 0)

XSCF> sendbreak -d 0

User Administration
Creating a New user
XSCF> adduser -u 345 admin

Delete a user
XSCF> deleteuser admin

Disable a user
XSCF> disableuser admin

Enable a user
XSCF> enableuser admin

Display user account information

XSCF> showuser -a

Set or change a User (admin) password

XSCF> password admin

Network related commands

Display complete network configuration
XSCF> shownetwork

-a

Set IP address for XSCF-LAN#0 in the XSCFU#0

XSCF> setnetwork xscf#0-lan#0 -m 255.255.255.0 192.168.1.10

We must apply the network settings and reboot the XSCF in order to the network
settings to take effect :
XSCF> applynetwork
XSCF> rebootxscf

Setup 2 NTP servers with IP 192.168.1.10 and 192.168.1.20

XSCF> setntp 192.168.1.10 192.168.1.20
Please reset the XSCF by rebootxscf to reflect the ntp settings.

To delete a NTP server 192.168.1.20

XSCF> setntp -c del 192.168.1.20
Please reset the XSCF by rebootxscf to reflect the ntp settings.

Hardware Related Commands

Show field replaceable units(FRU)
XSCF> showhardconf

Display degraded units

XSCF> showstatus

To display configured devices on XSBs

XSCF> showdevices

Fault Management configuration tool

To view fault management logs
XSCF> fmdump -v
TIME

UUID

Nov 30 20:44:55.1283

9f773e33-e46f-466c-be86-fd3fcc449935

100%

MSG-ID
FMD-8000-0W

defect.sunos.fmd.nosub

.....

Display Very Verbose Event Detail for a UUID

XSCF> fmdump -e -V -u 5f88d7d5-a107-4435-99c9-7c59479d22ed TIME CLASS

Logs
show the logs
XSCF> showlogs -v
XSCF> showlogs error
XSCF> showlogs power

Snapshots

We can take a snapshot of M series servers XSCF either on a remote server or on a

USB device locally connected. To take a snaphot on a remote system 192.168.1.10
(in /var/tmp directory) by using root user credentials :
XSCF> snapshot -L F -t [email protected]:/var/tmp

To take the snapshot on a Local USB device connected to the server :

XSCF> snapshot -L F -d usb0

Connect DVD Device to a domain

Run the following from the XSCF to connect the DAT & DVD to the needed port based
on the domain(s) configuration.
XSCF> cfgdevice -q -y -c attach -p 0-0

Confirm that the device is attached to domain and is enabled :

XSCF> cfgdevice -l

From the OS prompt configure the newly added DVD device and restart the volmgmt
service:
# cfgadm -c configure # c0
# /etc/init.d/volmgt start

Hostname Display current hostanems of XSCF units

XSCF> showhostname -a
xscf#0: hostname01.example.com
xscf#1: hostname02.example.com

To set hostname and DNS domain name for XSCF doamin respectively
XSCF> sethostname xscf#0 hostname01
XSCF> sethostname -d example.com

RSC commands
Connecting console and logging out
RSC> console
RSC> logout

Use ~. to come out of the OS login, back to RSC. In case the escape character ~.
doesnt work check for the escape character from OS :
# /usr/platform/`uname -i`/sbin/rscadm show escape_char
escape_char=#.

If the console is busy fire either of the command from RSC and OS respectively :

RSC> resetrsc
# /usr/platform/`uname -i`/sbin/rscadm resetrsc

User Administration
RSC> usershow

user_name

--- shows characteristics of user

RSC> useradd user_name

--- Add RSC user

RSC> userpassword user_name

--- Set/change user password

RSC> userdel user_name

--- Delete a RSC user

RSC> userperm user_name

--- Set authorization for a user

RSC> password

--- changes your password

Poweron/Poweroff/Break/Reset Commands
RSC> poweron

--- Power on the server

RSC> poweroff

--- Power off the server

RSC> break

--- Sends break signal to OS

RSC>resetrsc

--- Resets RSC immediately

RSC>reset

--- resets server immediately

Network related Commands

To set RSC IP address from OS rscadm command
# ./rscadm set ip_mode config
# ./rscadm set ip_addr 192.168.1.10
# ./rscadm set ip_netmask 255.255.255.0
# ./rscadm set ip_gateway 192.168.1.1
# ./rscadm resetrsc

We can also use the rsc-config script ( # /usr/platform/`uname -i`/rsc/rsc-config ) to

configure the IP address. To set the RSC IP address from RSC cli :
RSC> set ip_addr 192.168.1.10
RSC> set ip_netmask 255.255.255.0
RSC> set ip_gateway 192.168.1.1
RSC> resetrsc

Errors/logs capturing commands

RSC> help
RSC> showenvironment
RSC> consolehistory
RSC> consolehistory boot
RSC> consolehistory run

-- most recent POST and boot messages

---> most recent data received fro server OS

RSC> loghistory
RSC> show
RSC> showsc

Other Commands
RSC> showlocator

--- shows locator LED status (V480 only)

RSC> setlocator

--- Turn the system locator LED on or off (V480 only)

RSC> shownetwork

--- shows current RSC network configuration

RSC> date

--- Display/set current date and time

RSC> showdate

--- shows current date and time

RSC> version

--- Reports the RSC version

OS commands to manage RSC

Solaris rscadm subcommands: (path = # /usr/platform/`uname -i`/sbin/rscadm)
help

--- Displays a list of rscadm commands

date

--- Displays/sets the current time and date

set

--- Sets a configuration variable

show

--- Displays configuration variables

shownetwork

--- Shows current RSC network configuration

loghistory

--- shows log history

resetrsc

--- Resets RSC immediately

useradd

--- Adds an RSC user account

userdel

--- Deletes an RSC user account

usershow

--- Shows characteristics of an RSC user account

userpassword

--- Sets/changes a user's password

userperm

--- Sets the authorization for a user

version

--- Reports the RSC version on the host

status

--- Same as the version -v command

OBP commands
ok> rsc-hard-reset

--- perform a hard RSC reset

ok> rsc-soft-reset

--- perform a soft RSC reset

ok> .rsc

--- displays RSC info