M-SERIES eXtended System Control Facility (XSCF) Command Line Guide

Hi, sorry if this post is not easy to read, I just copy-paste from my notes:-). Enjoy it..

The Sun SPARC® Enterprise M-series server line is the newest addition to Sun Microsystem’s mid-range (M4000/M5000) and high-end server (M8000/M9000) families. Designed for the enterprise- class datacenter, all members of the server line offer a great deal of configuration flexibility in addition to high performance and reliability.

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

——————————————————————————–

UPDATE:
Oracle SPARC M-Series Servers Documentation:

(http://www.oracle.com/technetwork/documentation/sparc-mseries-servers-252709.html)

E19867-01    View Library    Download    Sun SPARC Enterprise M3000 Server Documentation
E19855-01    View Library    Download    Sun SPARC Enterprise M4000 Server Documentation
E19580-01    View Library    Download    Sun SPARC Enterprise M5000 Server Documentation
E19170-01    View Library    Download    Sun SPARC Enterprise M8000 Server Documentation
E19415-01    View Library    Download    Sun SPARC Enterprise M9000 Server Documentation

Advertisement

21 responses to “M-SERIES eXtended System Control Facility (XSCF) Command Line Guide

  1. Yo, thanks Aziz, v. useful. Just had 4 x M3000 16GB servers delivered that I have to rack out, install, set up single user logins through AD, file share to Win 2008 R2, system logging to a Windows event logging tool etc., etc.

  2. Hi Aziz,

    your command and help is very helpful in this blog,

    how ever do you have step by step prcedure to configure domain in uni-XSB and Quad XSB mode.

    if you send me or publish that in you blog then it will be very helpful to me and others.

    Regards
    Avinash

    • Hi! i have the instructions for configure a domain in Quad XSB mode and it´s something like this:

      In this case a have an Sun SE M5000 with 8 CPUs SPARC 64 VII+, and i have to create 2 domains, the first will have 6 CPUs and the second with only 2 CPUs, the Sun SE M5000 comes with 2 IO Units and each one Domain will take one of them.

      This are the instructions:

      Set the two SB on Quad-XSB mode
      XSCF> setupfru -x 4 sb 0
      XSCF> setupfru -x 4 sb 1

      Create the LD for Domain 0
      XSCF> setdcl -d 0 -a 0=00-0
      XSCF> setdcl -d 0 -a 1=00-1
      XSCF> setdcl -d 0 -a 2=00-2
      XSCF> setdcl -d 0 -a 3=00-3
      XSCF> setdcl -d 0 -a 4=01-02
      XSCF> setdcl -d 0 -a 5=01-03

      Note: We assigned 01-02 and 01-03 instead of 01-00 and 01-01 because the 01-00 CPU take´s the control of the Second IO Unit, remember that in the Sun SE M5000 only the 00-0 and 01-00 CPUs Can take´s control of both IO Units

      Create the LD for Domain 1
      XSCF> setdcl -d 1 -a 0=01-00
      XSCF> setdcl -d 1 -a 1=01-01

      Assign the LD to the domain 0
      XSCF> addboard -c assign -d 0 00-0 00-1 00-2 00-3 01-02 01-03

      Assign the LD to the domain 1
      XSCF> addboard -c assign -d 1 01-00 01-01

      Review the resources assigned to the domains
      XSCF> showdcl -v -d 0
      XSCF> showdcl -v -d 1

      Power On both Domains
      XSCF> poweron -d 0
      XSCF> poweron -d 1

      Connec to the console of the first domain
      XSCF>console -d 0

      Connec to the console of the first domain
      XSCF>console -d 1

      Once Solaris have booted, just check the resources of each domain with:
      root# prtdiag -v

      Regards
      AVA

      • Hi, i configure somain similar to this ,

        Set the two SB on Quad-XSB mode
        XSCF> setupfru -x 4 sb 0
        XSCF> setupfru -x 4 sb 1

        Create the LD for Domain 0
        XSCF> setdcl -d 0 -a 0=00-0
        XSCF> setdcl -d 0 -a 1=00-1
        XSCF> setdcl -d 0 -a 2=00-2
        XSCF> setdcl -d 0 -a 3=00-3
        XSCF> setdcl -d 1 -a 1=01-0
        XSCF> setdcl -d 1 -a 2=01-1
        XSCF> setdcl -d 1 -a 3=01-2
        XSCF> setdcl -d 1 -a 3=01-3

        addboard -c assign -d 0 00-00 00-01 00-02 00-03
        addboard -c assign -d 1 01-00 01-01 01-02 01-03

        it only assigns 00-00 to d0 and 01-00 to domain 1 rest of the resources throws the error not install in addboard command and showboard and dcl command shows (sp) unassigned and unmounted.status.

        could please let me know what wrong i am doing which assigning modules to domain.

        Regards
        Avinash

  3. Hi,

    I configure somain similar to this ,

    Set the two SB on Quad-XSB mode
    XSCF> setupfru -x 4 sb 0
    XSCF> setupfru -x 4 sb 1

    Create the LD for Domain 0
    XSCF> setdcl -d 0 -a 0=00-00
    XSCF> setdcl -d 0 -a 1=00-01
    XSCF> setdcl -d 0 -a 2=00-02
    XSCF> setdcl -d 0 -a 3=00-03

    Create the LD for Domain 1
    XSCF> setdcl -d 1 -a 1=01-00
    XSCF> setdcl -d 1 -a 2=01-01
    XSCF> setdcl -d 1 -a 3=01-02
    XSCF> setdcl -d 1 -a 3=01-03

    addboard -c assign -d 0 00-00 00-01 00-02 00-03
    addboard -c assign -d 1 01-00 01-01 01-02 01-03

    However it only assigns 00-00 to d0 and 01-00 to domain d1 rest of the resources throws the error” not install” in addboard assign command and showboard and dcl command shows (sp) unassigned and unmounted.status.

    can you please help me on this and let me know what wrong i am doing while configuring the domains

    Please ignore earlier post, I posted it accidently

    Regards
    Avinash

  4. Please ignore earlier comment,

    Set the two SB on Quad-XSB mode
    XSCF> setupfru -x 4 sb 0
    XSCF> setupfru -x 4 sb 1

    Create the LD for Domain 0
    XSCF> setdcl -d 0 -a 0=00-00
    XSCF> setdcl -d 0 -a 1=00-01
    XSCF> setdcl -d 0 -a 2=00-02
    XSCF> setdcl -d 0 -a 3=00-03

    Create the LD for Domain 1
    XSCF> setdcl -d 1 -a 1=01-00
    XSCF> setdcl -d 1 -a 2=01-01
    XSCF> setdcl -d 1 -a 3=01-02
    XSCF> setdcl -d 1 -a 3=01-03

    addboard -c assign -d 0 00-00 00-01 00-02 00-03
    addboard -c assign -d 1 01-00 01-01 01-02 01-03

    However it only assigns 00-00 to d0 and 01-00 to domain d1 rest of the resources throws the error” not install” in addboard assign command and showboard and dcl command shows (sp) unassigned and unmounted.status.

    can you please help me on this and let me know what wrong i am doing while configuring the domains

    Please ignore earlier post, I posted it accidently

    Regards
    Avinash

  5. again one more typo mistake

    Create the LD for Domain 1
    XSCF> setdcl -d 1 -a 0=01-00
    XSCF> setdcl -d 1 -a 1=01-01
    XSCF> setdcl -d 1 -a 2=01-02
    XSCF> setdcl -d 1 -a 3=01-03

  6. Could you check from your side and please let me know if i am doing something wromg in this,

    showboards shows 00-00 and 01-00 assigned and remainings resorces are showing unmount and unassigned with SP
    status.

    Set the two SB on Quad-XSB mode
    XSCF> setupfru -x 4 sb 0
    XSCF> setupfru -x 4 sb 1

    Create the LD for Domain 0
    XSCF> setdcl -d 0 -a 0=00-00
    XSCF> setdcl -d 0 -a 1=00-01
    XSCF> setdcl -d 0 -a 2=00-02
    XSCF> setdcl -d 0 -a 3=00-03

    Create the LD for Domain 1
    XSCF> setdcl -d 1 -a 0=01-00
    XSCF> setdcl -d 1 -a 1=01-01
    XSCF> setdcl -d 1 -a 2=01-02
    XSCF> setdcl -d 1 -a 3=01-03

    addboard -c assign -d 0 00-00 00-01 00-02 00-03
    addboard -c assign -d 1 01-00 01-01 01-02 01-03

    However it only assigns 00-00 to d0 and 01-00 to domain d1 rest of the resources throws the error” not install” in addboard assign command and showboard and dcl command shows (sp) unassigned and unmounted.status.

    can you please help me on this and let me know what wrong i am doing while configuring the domains

    Please ignore earlier post, I posted it accidently

    Regards
    Avinash

  7. hai,

    could you please give me the steps to reboot my m4000 server… we have two domains in this 1- reporting server 2- application server.. how to reboot only my reporting server?

    • I Always use the poweroff and poweron command, if you know Which doman it´s the reporting server… if where the domain 0 you could use the next commands

      First:
      XSCF> poweroff -d 0
      later Review the domain status
      XSCF> showdcl -v -d 0
      And later power on again
      XSCF> poweron -d 0

  8. mas Azis sedikit tanya dunk. untuk penggunaan alom di mesin type T3 gimana ya, saya ada kesulitan dalam mereset Alom nya, khususnya untuk menghilangkan lampu amber…

    terima kasih

    • Halo Audi, untuk seri T-Series, kurang lebih commandnya seperti ini:
      -> set /SYS/ clear_fault_action=true

      contoh:
      -> set /SYS/MB/CMP0/BR0/CH0/D0 clear_fault_action=True

  9. Can anyone tell me how to set the m5000 hardware configuration back to default where all the hardware is configured under domain 0? I received a used m5000 and I see by running the command showdcl -a that domain 01 is configured and I don’t want this.

    Thanks!
    Jeff

    XSCF> showdcl -a
    DID LSB XSB Status
    00 Running
    00 00-0
    01 01-0
    —————————
    01 Powered Off
    00 01-0

Leave a Reply to Armando Cancel reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.