eXtended System Control Facility (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
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
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
#########################################################################
#. >>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
——————————————————————————–
TROUBLESHOOTING COMMAND:
-showhardconf >>displays information about each FRU
-showlogs
-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:
setdcl
setupfru
addboard
deleteboard
moveboard
———————————————————————————–
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
XSCF>
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
-----------------------------------------------------------------------------------
OTHER COMMAND:
adduser
applynetwork >reset XSCF to reflect information that has been set for the XSCF network
console
exit
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
deleteuser
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
fmadm faulty >>
fmdump >view fault management logs
Exp.
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
poweron
poweroff
prtfru
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
setautologout
setdate
setdate -u -s 012707592006.00 >>Sets “January 27 07:59:00 2006″ of UTC as the current time
setdomainmode
sethostname
sethttps
setnetwork
setntp
setroute
settelnet
setssh
XSCF> setssh -c enable
setprivileges
XSCF> setprivileges aziz filedeng
showconsolepath
showdate
showdevice
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
showdomainmode
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
showstatus
showmonitorlog >display the contents of monitoring messages in real time
shownetwork -a >display information of network interfaces for XSCF
showuser
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
————————————————————————————–
REPLACE INTERNAL TAPE:
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
————————————————————————–
NOTE:
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
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
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
#########################################################################
#. >>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
——————————————————————————–
TROUBLESHOOTING COMMAND:
-showhardconf >>displays information about each FRU
-showlogs
-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:
setdcl
setupfru
addboard
deleteboard
moveboard
———————————————————————————–
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
XSCF>
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
-----------------------------------------------------------------------------------
OTHER COMMAND:
adduser
applynetwork >reset XSCF to reflect information that has been set for the XSCF network
console
exit
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
deleteuser
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
fmadm faulty >>
fmdump >view fault management logs
Exp.
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
poweron
poweroff
prtfru
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
setautologout
setdate
setdate -u -s 012707592006.00 >>Sets “January 27 07:59:00 2006″ of UTC as the current time
setdomainmode
sethostname
sethttps
setnetwork
setntp
setroute
settelnet
setssh
XSCF> setssh -c enable
setprivileges
XSCF> setprivileges aziz filedeng
showconsolepath
showdate
showdevice
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
showdomainmode
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
showstatus
showmonitorlog >display the contents of monitoring messages in real time
shownetwork -a >display information of network interfaces for XSCF
showuser
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
————————————————————————————–
REPLACE INTERNAL TAPE:
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
————————————————————————–
NOTE:
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.
- Example:
Displays the settings of all PSBs.
XSCF> showfru -a sb
Device Location XSB Mode Memory Mirror Mode
sb 00 Quad no
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
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 255.255.255.0 10.10.10.5
XSCF> sethostname xscf#0 fire-xscf
XSCF> sethostname -h host.org
XSCF> setroute -h host.org
XSCF> setnameserver 10.10.10.2 10.10.10.3
XSCF> setroute -c add -n 10.10.10.1 -m 255.255.255.0 xscf#0-lan#
XSCF> snapshot -L F -t [username]@[hostname]:[directory_to_save_to]