Dynamic Reconfiguration User's Guide 2.5.1

3.2 drcstat(1M)

NAME

drcstat - displays current information of the system board

SYNOPSYS

/opt/FJSVhwr/sbin/drcstat -board [sbXY | sbXY-N | all] [-xpar]
/opt/FJSVhwr/sbin/drcstat -system [sbXY | sbXY-N] [-xpar]
/opt/FJSVhwr/sbin/drcstat -device [sbXY | sbXY-N] [-e] [-xpar]

AVAILABILITY

This command can only be executed by the super user.
For requirements of this command, please refer to "1.2 DR Requirements".

DESCRIPTION

Displays the current information about system boards.
When sbXY or sbXY-N is specified, displays the information on the specified system board.
When all is specified, displays the information on all the system boards including other partitions.
When options are not specified, displays the information on the current system board.

OPTIONS

-board

display the current system board information.

SB: system board number (cabinet number + system board slot number, when -xpar is specified, + logical number in system board)

BN: system board number (Serial number from 0 to 31 which DR driver displays)
Status: system board status
Detail: detail status of the system board
PID: partition id
Next_PID: partition ID that will be effective after reboot

Board_Type: system board type

0xX0 : normal mode
0xX2 : extended system board (XSB) 2-split
0xX4 : extended system board (XSB) 4-split

CPU(MHz): cpu clock speed

When Board_type is 0x3X, the cpu clock speed of fastest CPU installed on the system board is displayed.

Status	(Detail)	Descriptions
Configured	none	The system board's resources are completely configured into the partition
	(PC)	The system board's resources are partially configured into the partition This state will occur when drc terminates abnormally
Waiting	none	The system board is physically connected and waiting to be logically connected
Unconfigured	none	Resetting state: The system board is logically disconnected from the partition
	(##)	Resetting state: Some error occurred on the system board. DR processing cannot be continued. Please contact our customer service, and exchange the system board.
Disconnected	none	Resetting state: The system board does not belong to any partition

-system

display the system information regarding DR operation
The system board whose status is "Suspend is required" is kernel memory board.
GP7000F model 1000/2000 and PRIMEPOWER 800/1000/2000 don't support detaching kernel memory board.
PRIMEPOWER 900/1500/2500 support detaching kernel memory board. (See section 2.1.3.1 "Two types of memory and restrictions")

-device

display the list of attached devices.

sbXY

The number of the system board.
X represents the cabinet number (0-3), and Y represents the system board slot number (0-7) in the cabinet.

sbXY-N

The number of the system board. When XPAR is used, this option is effective.
X represents the cabinet number (0-3), Y represents the system board slot number (0-7) in the cabinet and N represents offset number (0-3) in the system board.

all

specify all the system boards on the entire system including other partitions.
When "-board" is specified, this option can be specified.

-e

display the edit list of attached devices. When "-device" is specified, this option can be specified.

-xpar

When the system board number for XPAR (XY-N : cabinet number + system board slot number + logical number in system board) is displayed, this option can be specified.
The model for whom the XPAR environment can be used can specify this option.
When this option is not specified, the usual system board number display (XY : cabinet number + system board slot number) is done.

EXAMPLES

• display all the system boards

     # drcstat -board all
     SB BN Status (Detail)   PID Next_PID Board_Type CPU(MHz)
     -- -- ----------------- --- -------- ---------- --------
     00  0 Configured         00       00         10      300
     01  1 Unconfigured       00       00         10      300
     02  2 Configured         00       00         10      300
     03  3 Unconfigured (84)  00       00         10      300
     04  4 Unconfigured (84)  00       00         10      300
     05  5 Unconfigured (84)  00       00         10      300
     06  6 Waiting            00       00         10      300
     07  7 Disconnected       --       --         10      300
     10  8 Configured         00       00         10      300
     11  9 Configured         01       01         20      450
     12 10 Configured         01       01         20      450
     13 11 Configured         01       01         20      450
     14 12 Disconnected       --       01         20      450
     15 13 Disconnected       --       01         20      450
     16 14 Disconnected       --       --         20      450
     17 15 Disconnected       --       --         20      450
     20 16 ---                --       --        ---      ---
     21 17 ---                --       --        ---      ---
     22 18 ---                --       --        ---      ---
     23 19 ---                --       --        ---      ---
     24 20 ---                --       --        ---      ---
     25 21 ---                --       --        ---      ---
     26 22 Waiting            02       02         10      300
     27 23 Disconnected       --       --         10      300
     30 24 Configured         02       02         10      300
     31 25 Configured         02       02         10      300
     32 26 Configured         03       03         20      450
     33 27 Configured         03       03         20      450
     34 28 Disconnected       --       03         20      450
     35 29 Disconnected       --       03         20      450
     36 30 Disconnected       --       --         20      450
     37 31 Disconnected       --       --         20      450

• display the system board information on sb02

     # drcstat -board sb02
     SB BN Status (Detail)   PID Next_PID Board_Type CPU(MHz)
     -- -- ----------------- --- -------- ---------- --------
     02  2 Configured         00       00         10      300

• display information on all boards belonging to the current partition.

     # drcstat -board
     SB BN Status (Detail)   PID Next_PID Board_Type CPU(MHz)
     -- -- ----------------- --- -------- ---------- --------
     10  8 Configured         01       01         20      450
     11  9 Configured         01       01         20      450
     12 10 Configured         01       01         20      450
     13 11 Disconnected       --       01         20      450
     14 12 Disconnected       --       01         20      450
     20 16 Configured         01       01         20      450
     21 17 Configured         01       01         20      450
     22 18 Configured         01       01         20      450
     23 19 Disconnected       --       01         20      450
     24 20 Disconnected       --       01         20      450

• display the system information on sb01.

     # drcstat -system sb01
     kernel cage is enabled.
  
     SB BN Status     
     -- -- -------------------
     01  1 Suspend is required

• display the system information on the current partition.

     # drcstat -system
     kernel cage is enabled.
  
     SB BN Status     
     -- -- -------------------
     10  8 Suspend is required 
     11  9 --         
     12 10 --         
     25 21 --         
     26 22 --         
     27 23 --         

• display the list of all attached devices on sb00
  • For GP7000F model 1000/2000, PRIMEPOWER800/1000/2000

          # drcstat -device sb00
          00-PCI#0B  "/pci@80,4000/scsi@2" 0 "glm"
          00-PCI#0B  "/pci@80,4000/scsi@2,1" 1 "glm"
          00-PCI#0B  "/pci@80,4000/scsi@2/sd@1,0" 1 "sd"
          00-ONBOARD "/pci@83,4000/ebus@1/FJSV,scfc@14,200000" 0 "FJSVscf2"
          00-ONBOARD "/pci@83,4000/ebus@1/FJSV,se@14,400000" 0 "se"
          00-ONBOARD "/pci@83,4000/network@1,1" 0 "hme"

  • For PRIMEPOWER900/1500/2500

          # drcstat -device sb00
          00-ONBOARD   "/pci@87,2000/scsi@1" 0 "glm"
          00-ONBOARD   "/pci@87,2000/scsi@1,1" 1 "glm"
          00-ONBOARD   "/pci@87,2000/scsi@1/sd@0,0" 0 "sd"
          00-ONBOARD   "/pci@87,4000/ebus@1/FJSV,panel@14,280030" 0 "FJSVpanel"
          00-ONBOARD   "/pci@87,4000/ebus@1/FJSV,scfc@14,200000" 0 "FJSVscf3"
          00-ONBOARD   "/pci@87,4000/ebus@1/FJSV,se@14,400000" 0 "se"
          00-ONBOARD   "/pci@87,4000/network@1,1" 0 "hme"

• Specified "-e", and display the edit list of all attached devices on sb00
  • For GP7000F model 1000/2000, PRIMEPOWER800/1000/2000

      # drcstat -device sb00 -e
      SB Sub name           physical-name instance-number driver-binding-name
      -- --- -------------- ----------------------------------------------------------
      00     PCI#0B         "/pci@80,4000/scsi@2" 0 "glm"
      00     PCI#0B         "/pci@80,4000/scsi@2,1" 1 "glm"
      00     PCI#0B         "/pci@80,4000/scsi@2/sd@1,0" 1 "sd"
      00     ONBOARD        "/pci@83,4000/ebus@1/FJSV,scfc@14,200000" 0 "FJSVscf2"
      00     ONBOARD        "/pci@83,4000/ebus@1/FJSV,se@14,400000" 0 "se"
      00     ONBOARD        "/pci@83,4000/network@1,1" 0 "hme"

  • For PRIMEPOWER900/1500/2500

      # drcstat -device sb00 -e
      SB Sub name           physical-name instance-number driver-binding-name
      -- --- -------------- ----------------------------------------------------------
      00     ONBOARD        "/pci@87,2000/scsi@1" 0 "glm"
      00     ONBOARD        "/pci@87,2000/scsi@1,1" 1 "glm"
      00     ONBOARD        "/pci@87,2000/scsi@1/sd@0,0" 0 "sd"
      00     ONBOARD        "/pci@87,4000/ebus@1/FJSV,panel@14,280030" 0 "FJSVpanel"
      00     ONBOARD        "/pci@87,4000/ebus@1/FJSV,scfc@14,200000" 0 "FJSVscf3"
      00     ONBOARD        "/pci@87,4000/ebus@1/FJSV,se@14,400000" 0 "se"
      00     ONBOARD        "/pci@87,4000/network@1,1" 0 "hme"

• When XPAR is used and "-xpar" is not specified, display all the system boards.

     # drcstat -board all
     SB BN Status (Detail)   PID Next_PID Board_Type CPU(MHz)
     -- -- ----------------- --- -------- ---------- --------
     00  0 Configured         00       00         34     1350
     00  4 Configured         01       01         34     1350
     00  8 Configured         02       02         34     1350
     00 12 Configured         03       03         34     1350
     01  1 Unconfigured       00       00         34     1350
     01  5 Waiting            01       01         34     1350
     01  9 Configured         02       02         34     1350
     01 13 Disconnected       --       03         34     1350
     02  2 Configured         04       04         30     1350
     03  3 Disconnected       --       --         30     1350

• When XPAR is used and "-xpar" is specified, display all the system boards

     # drcstat -board all -xpar
     SB   BN Status (Detail)   PID Next_PID Board_Type CPU(MHz)
     ---- -- ----------------- --- -------- ---------- --------
     00-0  0 Configured         00       00         34     1350
     00-1  4 Configured         01       01         34     1350
     00-2  8 Configured         02       02         34     1350
     00-3 12 Configured         03       03         34     1350
     01-0  1 Unconfigured       00       00         34     1350
     01-1  5 Waiting            01       01         34     1350
     01-2  9 Configured         02       02         34     1350
     01-3 13 Disconnected       --       03         34     1350
     02    2 Configured         04       04         30     1350
     03    3 Disconnected       --       --         30     1350

• When XPAR is used and "-xpar" is specified, display the system board information on sb01

     # drcstat -board sb01 -xpar
     SB   BN Status (Detail)   PID Next_PID Board_Type CPU(MHz)
     ---- -- ----------------- --- -------- ---------- --------
     01-0  1 Unconfigured       00       00         34     1350
     01-1  5 Waiting            01       01         34     1350
     01-2  9 Configured         02       02         34     1350
     01-3 13 Disconnected       --       03         34     1350

• When XPAR is used and "-xpar" is specified, display the system board information on sb01-2

     # drcstat -board sb01-2 -xpar
     SB   BN Status (Detail)   PID Next_PID Board_Type CPU(MHz)
     ---- -- ----------------- --- -------- ---------- --------
     01-2  9 Configured         02       02         34     1350

• When XPAR is used and "-xpar" is specified, display the system information on sb00-1

     # drcstat -system sb00-1 -xpar
     kernel cage is enabled.
  
     SB   BN Status     
     ---- -- -------------------
     00-1  1 Suspend is required

• When XPAR is used and "-xpar" is specified, display information on all boards belonging to the current partition.

     # drcstat -system -xpar
     kernel cage is enabled.
  
     SB   BN Status     
     ---- -- -------------------
     00-1  1 Suspend is required 
     01-1  5 --          

• When XPAR is used, and "-e" and "-xpar" are specified, display the list of all attached devices on sb00-1

   # drcstat -device sb00-1 -e -xpar
   SB   Sub name           physical-name instance-number driver-binding-name
   ---- --- -------------- --------------------------------------------------------
   00-1     ONBOARD        "/pci@a2,2000/scsi@1" 0 "glm"
   00-1     ONBOARD        "/pci@a2,2000/scsi@1,1" 1 "glm"
   00-1     ONBOARD        "/pci@a2,2000/scsi@1/sd@0,0" 0 "sd"
   00-1     ONBOARD        "/pci@a2,4000/ebus@1/FJSV,panel@14,280030" 0 "FJSVpanel"
   00-1     ONBOARD        "/pci@a2,4000/ebus@1/FJSV,scfc@14,200000" 0 "FJSVscf3"
   00-1     ONBOARD        "/pci@a2,4000/ebus@1/FJSV,se@14,400000" 0 "se"
   00-1     ONBOARD        "/pci@a2,4000/network@1,1" 0 "hme"

EXIT STATUS

This command returns the following values.

0: display information successfully

>0: An error occurred.

Please refer to drcstat error messages or console messages in Chapter 6, "Messages and DR Error Conditions on Solaris 8 OS" and Chapter 7 "Messages and DR Error Conditions on Solaris 9 OS and Solaris 10 OS"

SEE ALSO

drc(1M), adrc(1M)

NOTES

This command sometimes fails while executing a DR process.

See "5.2.3 drcstat(1M) failed" for detail.