Sun XSCF cheat sheat

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

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                                    MSG-ID
Nov 30 20:44:55.1283    9f773e33-e46f-466c-be86-fd3fcc449935   FMD-8000-0W
100%  defect.sunos.fmd.nosub

Display Very Verbose Event Detail for a UUID

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

show the logs

XSCF> showlogs -v
XSCF> showlogs error
XSCF> showlogs power


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 (in /var/tmp directory) by using root user credentials :

XSCF> snapshot -L F -t root@

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

#.  >>switch the prompt from domain console to XSCF console

XSCF>console -d 0    >>swith from XSCF console to domain console
XSCF>console -d 0 -f    >>swith from XSCF console to domain console with force option
XSCF>reset -d 0 xir    >>reset/restart domain 0 console
XSCF>poweroff -d 0    >>power off domain ID 0
XSCF>poweroff -f -d 0    >>forcibly power off domain ID 0

XSCF>poweroff -a    >>power off all domain together
XSCF>poweron -a        >>power on all domain
XSCF>poweron -d 0    >>power on domain ID 0

XSCF>version -c xcp    >>to determine firmware version
XSCF>switchscf -t Standby

XSCF>snapshot -d usb0    >>save/collect log to USB flash disk
XSCF>showlogs power

XSCF> setdomainmode -d 0 -m autoboot=on
XSCF> showdomainmode -d 0
Host-ID             : 85289956
Diagnostic Level    : min
Secure Mode         : on
Autoboot            : on
CPU Mode            : auto

-showhardconf        >>displays information about each FRU
-showstatus        >>Displays the information concerning the units failed or degraded
-fmdump            >>to display the contents of any log files associated with the Solaris fault manager
-fmadm faulty

Command used for ADDING & REMOVING DOMAIN:


XSCF> set
setaltitude        setdualpowerfeed   setntp             setsnmp
setapcs            setemailreport     setpasswordpolicy  setsnmpusm
setarchiving       sethostname        setpowerupdelay    setsnmpvacm
setaudit           sethttps           setprefetchmode    setssh
setautologout      setldap            setprivileges      setsunmc
setcod             setlocale          setrci             settelnet
setdate            setlocator         setrcic            settimezone
setdcl             setloginlockout    setroute           setupfru
setdomainmode      setlookup          setservicetag      setupplatform
setdomparam        setnameserver      setshutdowndelay
setdscp            setnetwork         setsmtp
XSCF> set
setaltitude        setdualpowerfeed   setntp             setsnmp
setapcs            setemailreport     setpasswordpolicy  setsnmpusm
setarchiving       sethostname        setpowerupdelay    setsnmpvacm
setaudit           sethttps           setprefetchmode    setssh
setautologout      setldap            setprivileges      setsunmc
setcod             setlocale          setrci             settelnet
setdate            setlocator         setrcic            settimezone
setdcl             setloginlockout    setroute           setupfru
setdomainmode      setlookup          setservicetag      setupplatform
setdomparam        setnameserver      setshutdowndelay
setdscp            setnetwork         setsmtp
Display all 145 possibilities? (y or n)
addboard            setdate             showdomainmode
addcodlicense       setdcl              showdomainstatus
addfru              setdomainmode       showdscp
adduser             setdomparam         showdualpowerfeed
applynetwork        setdscp             showemailreport
cfgdevice           setdualpowerfeed    showenvironment
clockboard          setemailreport      showfru
confdidr            sethostname         showhardconf
console             sethttps            showhostname
deleteboard         setldap             showhttps
deletecodlicense    setlocale           showldap
deletefru           setlocator          showlocale
deleteuser          setloginlockout     showlocator
disablemodes        setlookup           showloginlockout
disableuser         setnameserver       showlogs
dumpconfig          setnetwork          showlookup
enableescalation    setntp              showmodes
enableservice       setpasswordpolicy   showmonitorlog
enableuser          setpowerupdelay     shownameserver
escalation          setprefetchmode     shownetwork
exit                setprivileges       shownotice
flashupdate         setrci              showntp
fmadm               setrcic             showpasswordpolicy
fmdump              setroute            showpowerupdelay
fmstat              setservicetag       showprefetchmode
getflashimage       setshutdowndelay    showresult
ioxadm              setsmtp             showroute
man                 setsnmp             showservicetag
moveboard           setsnmpusm          showshutdowndelay
nslookup            setsnmpvacm         showsmtp
password            setssh              showsnmp
ping                setsunmc            showsnmpusm
poweroff            settelnet           showsnmpvacm
poweron             settimezone         showssh
prtfru              setupfru            showstatus
rebootxscf          setupplatform       showsunmc
replacefru          showaltitude        showtelnet
reset               showapcs            showtimezone
resetdateoffset     showarchiving       showuser
restoreconfig       showaudit           snapshot
restoredefaults     showautologout      switchscf
sendbreak           showboards          testsb
service             showcod             traceroute
setaltitude         showcodlicense      unlockmaintenance
setapcs             showcodusage        version
setarchiving        showconsolepath     viewaudit
setaudit            showdate            who
setautologout       showdcl
setcod              showdevices

applynetwork         >reset XSCF to reflect information that has been set for the XSCF network

cfgdevice                    >connect the CD-RW/DVD-RW drive unit and the tape drive unit to the port, disconnect it from the port, or display the status of the drive
XSCF> cfgdevice -l
XSCF> cfgdevice -c attach -p 0-0
XSCF> cfgdevice -f -c detach -p 0-0    >Disconnects the DVD drive/tape drive unit from the port 0-0.

XSCF> cfgdevice -y -c attach -p 0-0    >Connects the DVD drive/tape drive unit to port 0-0 when the system is being powered on.  Automatically answers “y” to all prompts.
XSCF> cfgdevice -q -y -c attach -p 0-0    >answer ‘y’ to all prompts without displaying message

dumpconfig/restoreconfig            >>save/restore XSCF configuration
XSCF> dumpconfig file:///media/usb_msd/backup-file.txt
XSCF> dumpconfig ftp://server/backup/backup-sca-ff2-16.txt
XSCF> restoreconfig file:///media/usb_msd/backup-file.txt
fmadm faulty                >>
fmdump                        >view fault management logs
XSCF> fmdump
Sep 29 15:09:25.4335 8cec9a83-e2a3-4dc3-a7cd-de01caef5c63 FMD-8000-4M
Sep 29 15:10:09.6151 5f88d7d5-a107-4435-99c9-7c59479d22ed FMD-8000-58

[Display Very Verbose Event Detail for the Last UUID:
XSCF> fmdump -e -V -u 5f88d7d5-a107-4435-99c9-7c5947 9d22ed

XSCF> fmdump  -m -M            >>Displaying Contents of the Fault Manager syslog Message

flashupdate    >update firmware
getflashimage    >download a firmware image file
XSCF> getflashimage http://imageserver/images/FFXCP1041.tar.gz
XSCF> getflashimage ftp://imageserver/images/FFXCP1041.tar.gz
moveboard    >move XSB from current domain to another
XSCF> prtfru -c system-board

rebootxscf        >reset the XSCF

replacefru        >

reset            >reset the specific domain; use this command only for the purpose of recovery, such as if OS hang
senddbreak        >send a break signal to the specified domain
XSCF> sendbreak -d 0
setdate -u -s 012707592006.00    >>Sets “January 27 07:59:00 2006″ of UTC as the current time

XSCF> setssh -c enable

XSCF> setprivileges aziz filedeng

showdevice -d 0

showboards        >check the XSB number, domain ID, LSB number, XSB status
XSCF>showboards -a

showdcl            >check domain ID, LSB number, configuration policy
XSCF>showdcl -va

showdomainstatus -a    >check the power status of the system
showenvironment        >display the intake air temperature and humidity, temperature sensor information, voltage sensor
showfru            >display the hardware settings of specified device
showhardconf        >display information about field replaceable unit (FRU)
showlogs        >display the specific log
XSCF>showlogs event
XSCF>showlogs error -v
XSCF>showlogs power
XSCF>showlogs monitor
XSCF>showlogs console

showmonitorlog        >display the contents of monitoring messages in real time
shownetwork -a         >display information of network interfaces for XSCF
snapshot        >collect and transfer environtment, log, error, and FRUID data
switchscf        >switch the XSCF unit between the active and standby states
testsb             >perform an initial diagnosis of the specified physical system board (PSB


1. unconfigure tape drive from OS
# cfgadm -a
c0::rmt/0 tape connected configured unknown
# cfgadm -c unconfigure c0::rmt/0

Stop the connection to the CD-RW/DVD-RW drive unit on the same controller
as the target tape drive unit

#cfgadm -a
c0::dsk/c0t4d0 CD-ROM connected configured unknown
#cfgadm -c unconfigure c0::dsk/c0t4d0
# cfgadm -a
c0::dsk/c0t4d0 CD-ROM connected unconfigured unknown
c0::rmt/0 tape        connected unconfigured unknown

2. Detach the target tape drive unit from the port
XSVF> cfgdevice -c detach -p <port no.> command
3. Confirm that the target tape drive unit is unconfigured from the domain.
cfgdevice -l
4. Remove the tape drive unit
5. Mount the replacement tape drive unit
6. Attach the tape drive unit to the port
XSCF> cfgdevice -c attach -p <port no.>
7. Confirm that the target tape drive unit is configured from the domain.
XSCF> cfgdevice -l

8. from OS, execute command ‘cfgadm -c configure TAPE_Ap_Id’ to configure tape drive
#cfgadm -c configure c0::rmt/0

9. from OS< execute command ‘cfgadm -c configure DVD_Ap_Id’ to configure DVD drive
#cfgadm -c configure c0::dsk/c0t4d0

10. execute ‘cfgadm -al’ to verify the status of tape drive and DVD drive

PSB (Physical System Board)
XSB (Extended System Board)

A PSB that is logically divided into one part (no division) is called a Uni-XSB, and a PSB that is logically divided into four parts is called a Quad-XSB. On Quad-XSB configuration; ONE XSB CONTAIN TWO PCI SLOT

XSCF Command Cheat Sheet

adduser – Creates an XSCF user account.
deleteuser – Deletes an XSCF user account.
disableuser – Disables an XSCF user account
enableuser – Enables an XSCF user account.
showuser – Displays XSCF user account information
password – Changes an XSCF user account password.
setpasswordpolicy – Configures the XSCF password policy.
showpasswordpolicy – Displays the XSCF password policy.
setprivileges – Assigns user privileges.
setloginlockout – Configures the lockout of user accounts.
showloginlockout – Displays the lockout setting of user accounts.
setnetwork – Configures the XSCF network.
shownetwork – Displays the XSCF network settings and XSCF-LAN network status.
setroute – Configures the XSCF-LAN route.
showroute – Displays XSCF-LAN route settings.
sethostname – Specifies the XSCF-LAN host name and domain name.
showhostname – Displays the XSCF-LAN host name and domain name.
setnameserver – Sets a name server (DNS) with XSCF.
shownameserver – Displays the XSCF name server(s).
applynetwork – Applies the network settings.
setdscp – Configures DSCP.
showdscp – Displays the DSCP settings.
nslookup – Checks for the name resolution of a host name.
ping – Checks the response for a host.
traceroute – Displays the network path to the host by list.
settimezone – Specifies the time zone.
showtimezone – Displays the time zone setting.
setdate – Sets the XSCF time.
showdate – Displays the XSCF time.
setntp – Configures the NTP server.
showntp – Displays the SSH settings and fingerprint.
resetdateoffset – Resets the time subtraction between the XSCF and the domain.
showdateoffset – Displays the time subtraction between the XSCF and the domain.
setssh – Configures SSH, Generates RSA and DSA keys for SSH2 host authentication.
showssh – Displays the SSH settings.
settelnet – Configures telnet.
showtelnet – Displays the telnet settings.
setautologout – Sets the session timeout time of the XSCF Shell.
showautologout – Displays the session timeout time of the XSCF Shell.
setsmtp – Configures the SMTP server.
showsmtp – Displays the the SMTP server settings.
setemailreport – Configures mail notification.
showemailreport – Displays the mail notification settings.
setlookup – Enables or disables the use of an LDAP server.
showlookup – Displays information about whether an LDAP server is used.
setldap – Configures LDAP client settings.
showldap – Displays LDAP client settings.
sethttps – Configures the https settings.
showhttps – Displays the https settings.
setupplatform – Configures the log archiving function of XSCF.
showarchiving – Displays the settings of the log archiving function of XSCF.
setaudit – Configures the auditing of XSCF.
showaudit – Displays the settings of the audit of XSCF.
viewaudit – Displays the audit records (Audit trail) of XSCF.
setsnmp – Configures the SNMP Agent.
showsnmp – Displays the SNMP Agent settings.
setsnmpusm – Configures the USM management information for the SNMP agent.
showsnmpusm – Displays the USM management information for the SNMP agent.
setsnmpvacm – Configures the VACM management information for the SNMP agent.
showsnmpvacm – Displays the VACM management information for the SNMP agent.
setsunmc – Start or stop the Sun Management Center agent and make changes to its configuration.
showsunmc – Show setup information and status of Sun Management Center agent.
setdcl – Specifies the domain configuration information (DCL).
showdcl – Displays the domain configuration information.
showboards – Displays the component information and the COD information about a system board.
showdevices – Displays the domain information specified for a system board.
showdomainstatus – Displays the domain status.
setupfru – Specifies the number of XSB partitions of the system board and sets the memory mirror mode.
showfru – Displays the specified number of XSB partitions of the system board and the memory mirror mode that is set.
Displays the settings of all PSBs.
XSCF> showfru -a sb
Device Location XSB Mode Memory Mirror Mode
sb 00 Quad no

testsb – Diagnoses the system board.
addboard – Adds a system board to a domain.
deleteboard – Deletes a system board from a domain.
moveboard – Moves a system board to another domain.
replacefru – Replaces a CPU/Memory Board unit, I/O unit, fan unit, PSU, or XSCFi.
addfru – Installs a CPU/Memory Board unit, I/O unit, fan unit, or PSU.
deletefru – Removes a CPU/Memory Board unit or I/O unit.
setdomainmode – Sets a hardware initial diagnostic level (No, standard, maximum).
Enables or disables break signal sending, host watchdog, automatic boot, and sets CPU operation mode.
showdomainmode – Displays the domain host ID, the hardware initial diagnostic level, information of enabled or disabled status on break signal sending, Host watchdog, automatic boot, and displays CPU operation mode, ethernet address, mac address.
sendbreak – Sends a break signal to the server.
showresult – Displays the exit status of the most recently executed command.
setlocale – Sets locale.
showlocale – Displays locale.
setaltitude – Sets altitude.
showaltitude – Displays altitude.
cfgdevice – Sets/Displays the connection destination/status of the DVD drive, tape drive.
addcodlicense – Applies the obtained COD license key to the system.
deletecodlicense – Deletes the license key applied to the system.
showcodlicense – Displays the license keys applied to the system.
showcodusage – Displays license usage information.
setcod – Configures COD settings.
showcod – Displays COD settings.
console – Connects to a domain console.
showconsolepath – Displays the operating status of the main console.
showenvironment – Displays the temperature, humidity, voltage, fan rotation speed, power consumption, and exhaust airflow.
showstatus – Lists degraded components.
showhardconf – Displays all components mounted in the server.
poweron – Turns on power to all domains or the specified domain.
poweroff – Turns off power to all domains or the specified domain.
reset – Resets the specified domain.
The following three reset modes are available:
por: Domain system reset
request: Domain panic instruction
xir: Domain CPU reset

setpowerupdelay – Sets the warm-up time and the air-conditioning wait time.
showpowerupdelay – Displays the warm-up time and the air-conditioning wait time settings.
setshutdowndelay – Sets the UPS shutdown delay time at power failure.
showshutdowndelay – Displays the UPS shutdown delay time at power failure.
setdualpowerfeed – Sets the dual power feed.
showdualpowerfeed – Displays the dual power feed.
setlocator – Enables or disables the CHECK LED blinking.
showlocator – Displays the LED status.
switchscf – Switches the XSCF Unit state (Active/Standby).
ioxadm – Configures/Displays the External I/O Expansion Unit settings(IOBOX).
clockboard – Sets/Displays the number of clock unit (CLKU) used when the next platform is powered on.
setdomparam – Rewrites the OpenBoot PROM environment variable that is compulsory.
getflashimage – Gets the firmware update program.
flashupdate – Updates the firmware program.
version – Displays XCP, XSCF, and OpenBoot versions.
prtfru – Displays the FRU-ROM data.
dumpconfig – Saves XSCF configuration information to the specified destination.
restoreconfig – Restores XSCF configuration information from the specified destination.
restoredefaults – Initialises the server or XSCF to the factory defaults.
snapshot – Saves log information to the specified destination.
showmonitorlog – Displays the XSCF monitoring messages on console in real time.
showlogs – Displays the error log, power log, event log, console log, panic log, IPL log, temperature/humidity log, and monitor message log.
fmadm – Monitors/controls the Fault Management Diagnosis Engines (FMDE).
fmdump – Dumps the fault event log containing FM diagnosis results.
fmstat – Displays the FMDE status.
unlockmaintenance – Forcibly release the locked status of the XSCF.
rebootxscf – Reboots/Resets the XSCF.
who – Displays users who login to the XSCF.
man – Displays the man page of the specified command.
You can see this list of commands by executing man intro.
exit – Ends the XSCF Shell.

Useful Commands

The Sun SPARC Enterprise M4000/M5000/M8000/M9000 Servers XSCF useful console commands:

XSCF> console -d 0
XSCF> console -f -d 0
XSCF> showstatus
XSCF> showversion -c xcp -v [shows xcp firmware, version, openboot prom version
XSCF> showenvironment
XSCF> showenvironment temp
XSCF> showenvironment volt
XSCF> showhardconf
XSCF> showdcl -va [check domain id…]
XSCF> showdomainstatus -a
XSCF> showboards -a
XSCF> poweron -a [powers up all domains]
XSCF> poweroff -a [powers off all domains]
XSCF> poweron -d 0 [powers on domain 0]
XSCF> poweroff -d 0 [powers off domain 0]
XSCF> poweroff -f -d 0 [forces a power off domain 0]
XSCF> reset -d 0 por [resets domain 0]
XSCF> reset -d 0 xir [resets domain 0 with XIR reset]
XSCF> sendbreak -d 0 [sends break command to domain 0]
XSCF> setautologout -s 60 [sets autologout to 60 minutes]
XSCF> showautologout
XSCF> shownetwork -a
XSCF> setnetwork xscf#0-lan#0 -m
XSCF> sethostname xscf#0 fire-xscf
XSCF> sethostname -h
XSCF> setroute -h
XSCF> setnameserver
XSCF> setroute -c add -n -m xscf#0-lan#
XSCF> snapshot -L F -t [username]@[hostname]:[directory_to_save_to]