XSCF commands/Cheat Sheet

Abbreviations:

• XSCF : eXtended System Control Facility
• IOU : I/O Unit

 The IOU includes PCI slots.

• PSB : Physical System Board

 The PSB includes at least 1 CPUM, 1 MEMB and 1 IOU on M4000 or M5000 server.

 A M4000 server includes 1 PSB (PSB#00) and a M5000 server includes 2 PSB(PSB#00 and PSB#01).

• XSB : Extended System Board

 The PSB is configured either in Uni-XSB mode or Quad-XSB mode.

 In uni-XSB mode, the XSB are named XSB#XX-0.

          In quad-XSB mode, the XSB are named XSB#XX-0, XSB#XX-1, XSB#XX-2 and XSB#XX-3

 XX represents the PSB number.

• LSB : Logical System Board

           Before adding an XSB to a domain, it is necessary to assign a number of LSB in the DCL         ).

• DCL : Domain Component List

                    Each domain has his own DCL. Each DCL contains 16 LSB.

• DCU : Domain Configuration Unit
• XCP : XSCF Control Package

Domain Administration:

List all domains on the frame:

XSCF> showdomainstatus -a

DID         Domain Status

00          Running

01          Running

02          -

03          -

Connecting to the console:

XSCF>  console -d [console #]

-f force connection to writable console session

-r read only connection

-y answer yes to all prompts

Exiting the console:

Press the Enter key and then enter "#.".

To see who has the console:

showconsolepath -d [domain #]

To display logs:

showlogs -d [domain #] console -> console log

showlogs -M -d [domain #] console -> console log paged

showlogs -r -M -d [domain #] console -> console log paged in reverse order

showlogs -d [domain #] panic -> panic log 

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

To send a break:

sendbreak -d [domain #]

If the sendbreak command does not work then you might need to turn off the domain's secure mode.

To check current setting, at the XSCF> prompt, type:

showdomainmode -d [domain #]

to change the security mode, at the XSCF> prompt, type:

setdomainmode -d [domain #] -m secure=off

To forcibly reset a hung domain:

reset -d [domain #]  level

Where level is "por", "panic" or "xir":

– "por" to reset the domain

– "panic" to panic the server and generate a core

– "xir" to reset the domains' CPUs

To see all the commands available:

[tab] [tab]

Man pages:

man [command]

To exit XSCF

exit or ctrl-D

XSCF Firmware upgrade

• Check current firmware level

            XSCF> version -c xcp -v 

•  Check version of staged firmware

             XSCF> getflashimage -l

• Download new firmware

             XSCF> getflashimage -y -v http://IP:PORT/firmware/FFXCP1120.tar.gz  or getflashimage -y -v -u <user>          ftp://IP:PORT/firmware/FFXCP1120.tar.gz 

            XSCF> getflashimage -l   

• Check upgrade is possible or not

            XSCF> flashupdate -c check -m xcp -s 1120

• Update the firmware

            XSCF> flashupdate -y -c update -m xcp -s 1120 

Login again

• Confirm that the XSCF firmware update has finished

            XSCF> showlogs monitor 

• Verify new version of firmware

            XSCF> version -c xcp -v

• Reboot the domains: The domains should be rebooted soon after firmware upgrade is performed.

User Administration

• Creating a New user

            XSCF> adduser -u  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

• Show the network configuration

XSCF> showssh

XSCF> showhostname -a

XSCF> shownetwork -a

XSCF> showroute -a

XSCF> showntp -a

XSCF> shownameserver

Domain Components FRU

• Display

XSCF> showfru -a sb              

Device  Location    XSB Mode        Memory Mirror Mode 

sb      00          Uni             no                 

sb      01          Uni             no 

XSCF> showfru sb 0

• Define

To Uni-XSB

  XSCF> setupfru -x 1 sb 0

To Quad-XSB

  XSCF> setupfru -x 4 sb 0

DCL

• Display

XSCF> showdcl -a -v

XSCF> showdcl -v -d 0

• Define a DCL number to a XSB

XSCF> setdcl -d 0 -a 0=00-0

The XSB 00-0 has the DCL number 0 on the domain 0.

• Suppress

XSCF> setdcl -d 0 -r 00

Board

• Display all boards

XSCF> showboards -a -v

• Add a board to a domain

XSCF> addboard -d 0 -c assign 00-0

We add the xsb 00-0 to the domain 0

• Suppress a board

XSCF> deleteboard -c unassign 00-0

Device Information

• Display a resume of hardware configuration

XSCF> showhardconf -u

• Display page by page

XSCF> showhardconf -M

• Display the attached device to a domain( The OS must run on the domain )

XSCF> showdevices -d 0

It is necessary to configure the dscp and also to start the SMF services else the command returns the follow error message :

Can't get device information from DomainID 1.

Display the hardware with degraded status

• XSCF> showstatus

MBU_B;

MEMB#0;

* MEM#0A; Status:Faulted;

• Replace the FRU (FAN and PSU for M4000/M5000)

XSCF> replacefru