Dynamic Reconfiguration User's Guide 2.5.1

3.1 drc(1M)

NAME

drc - executes DR operation

SYNOPSYS

/opt/FJSVhwr/sbin/drc -connect sbXY | sbXY-N [-reset]
/opt/FJSVhwr/sbin/drc -disconnect sbXY | sbXY-N [-reset]
/opt/FJSVhwr/sbin/drc -disconnect sbXY | sbXY-N -next PID [-reset]
/opt/FJSVhwr/sbin/drc -disconnect sbXY | sbXY-N -keep
/opt/FJSVhwr/sbin/drc -abort

AVAILABILITY

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

DESCRIPTION

drc(1M) executes DR attach/detach, or assists system board hotswap or system board movement between partitions.
drc(1M) command can be used only for a system board of the current partition or undefined ("-").

OPTIONS

The following options are available:

Status, PID, Next_PID, Board_Type, CPU(MHz) on the specified system board: sbXY or sbXY-N is shown by drcstat(1M) command.

-connect

Attach the system board specified with sbXY or sbXY-N to the current partition (the partition where this command is invoked).
This option is specified to execute DR attach or dynamical system board replacement.

• For GP7000F model 1000/2000, PRIMEPOWER800/1000/2000

  Both Board_Type and CPU(MHz) of the system board must match those of the current partition.

• For PRIMEPOWER900/1500/2500

  When Board_Type is 0x2X, both Board_Type and CPU(MHz) of the system board must match those of the current partition. And, when Board_Type is 0x3X, only Board_Type must match those of the current partition.

Other options	Conditions before drc(1M) is invoked			Conditions after drc(1M) is terminated			Note
	Status	PID	Next_PID	Status	PID	Next_PID
none	Waiting	current	current	Configured	current	current
	Disconnected	-	-
	Disconnected	-	current
-reset	Configured	current	dest	Configured	current	current	1.
	Configured	current	--				2.
	Disconnected	-	-	Disconnected	-	current	3.

current : The current partition id

dest : The destination partition id

- : undefined

1. These conditions are generated after running "drc -disconnect sbXY(or sbXY-N) -next PID -reset"
2. These conditions are generated after running "drc -disconnect sbXY(or sbXY-N) -reset"
3. After this command terminates and reboots the current partition, the conditions of the system board are changed as follows.
   Status of the system board is Configured; PID and Next_PID are for the current partition ID

-disconnect

Detach the system board specified with sbXY or sbXY-N from the current partition.
This option is specified to remove the system board for one of the following purposes.

• Just detach the system board
• Detach the system board and specify the destination partition id where the system board is to be moved to.
• Detach the system board to hotswap the system board

other options	Conditions before drc(1M) is invoked			Conditions after drc(1M) is terminated			Note
	Status	PID	Next_PID	Status	PID	Next_PID
None	Configured	current	Current	Disconnected	-	-
	Waiting	current	Current
-next	Configured	current	Current	Waiting or Unconfigured	dest	dest	1. 5.
	Waiting	current	Current
-keep	Configured	current	Current	Unconfigured	current	current
-reset	Configured	current	Current	Configured	current	-	2.
	Disconnected	-	Current	Disconnected	-	-	3.
-next -reset	Configured	current	Current	Configured	current	dest	1. 4.

current : The current partition id

dest : The destination partition ID specified with -next option

-- : undefined

1. When you specify the -next option and Board_Type of the system board which does disconnect is 0x1X or 0x2X, both Board_Type and CPU(MHz) of the system board must match those of the destination partition.
   When Board_Type of the system board that does disconnect is 0x3X, Board_Type of the system board only must match those of the destination partition.
2. After this command terminates and reboots the current partition, the conditions of the system board are changed as follows.
   Status of the board is Disconnected; PID and Next_PID are undefined ("-").
3. These conditions are generated after running "drc -connect sbXY(or sbXY-N) -reset"
4. After this command terminates and reboots the current partition, the conditions of the system board are changed as follows.
   Status of the system board is Disconnected/Unconfigured, PID is undefined ("-") and Next_PID is the destination partition id
5. Status of the system board is Unconfigured, when the destination partition is power-off state

-abort

abort the operation of DR attach/detach.
This option can be specified only for the following purposes.

• drc(1M) stops with the following message displayed.
  "Execute connection script ####"
• drc(1M) is not completed with the following message displayed.
  "Waiting the completion of memory releasing. ( XXXX / YYYY )"

When the command is executed specifying this option by conditions except the above-mentioned, operation afterwards is not guaranteed.
When the system becomes abnormal, it is necessary to reboot the system.

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.

-next PID

The destination partition id (0-14) where the system board moves after the system board is detached.
When Board_Type of the system board which does disconnect is 0x1X or 0x2X, both Board_Type and CPU(MHz) of the system board must match those of the destination partition.
When Board_Type of the system board that does disconnect is 0x3X, Board_Type of the system board only must match those of the destination partition.

-keep

This option is specified for system board hotswap.
This option can be specified together with -disconnect.
To cancel the system board hotswap, execute the cancel operation on SMC.
See "System Console Software User's Guide" for detail.

-reset

This option is specified to take the actual DR action at the next reboot.
When this option is omitted, the DR operation immediately starts.
When the command is invoked with both -reset and -next, the DR operation should be executed in the following order.

1. Command execution (drc -disconnect sbXY(or sbXY-N) -next PID -reset)
2. reboot the current partition
3. reboot the destination partition

EXAMPLES

Attach the system board "sb02" to the current partition.
# drc -connect sb02

Attach the system board "sb02" to the current partition at the next boot.
# drc -connect sb02 -reset

Detach the system board "sb02" from the current partition.
# drc -disconnect sb02

Detach the system board "sb02" from the current partition at the next reboot.
# drc -disconnect sb02 -reset

Remove the system board "sb02" from the current partition and set Next_PID to partition #2. The removed system board will belong to partition #2 when "drc -connect sb02" is run on the partition #2.
<the current partition>
# drc -disconnect sb02 -next 2
<partition #2>

# drc -connect sb02

Remove the system board "sb02" from the current partition and set Next_PID to partition #2 at the next reboot. The removed system board will belong to partition #2 after both of the partition #2 and the current partition is rebooted next time.
# drc -disconnect sb02 -next 2 -reset
<reboot the current partition>
<reboot the partition #2>

Detach the system board "sb02" for system board hotswap.
To complete the hotswap operation, run "drc -connect sb02" to after replacing the board.
# drc -disconnect sb02 -keep

When XPAR is used, attach the system board "sb02-1" to the current partition.
# drc -connect sb02-1

When XPAR is used, detach the system board "sb02" from the current partition.
# drc -disconnect sb02

EXIT STATUS

This command returns the following values:

0

No failures or errors detected on the system.

>0

Failures or errors detected on the system.

SEE ALSO

drcstat(1M), adrc(1M)

NOTES

• Confirm Status of the system board by drcstat(1M) before this command is invoked.
• The recovery procedure is as follows when the system board is moved into the partition which installed either Solaris 2.6 OS or Solaris 7 OS (DR feature doesn't work).
  
  After running "drc -disconnect sbXY -next PID"

1. Reboot the destination partition
2. Remove the system board by using "System Board Removal from Partition" menu on SMC
3. Reboot or shutdown the destination partition
4. Run "drc -connect sbXY" in the current partition

   
   After running "drc -disconnect sbXY -next PID -reset", run "drc -connect sbXY".

• The following WARNING message is displayed when the drc command is invoked on two or more partitions at the same time for the same system board.
  In this case, this message does not mean hard error.

    FJSVscf: WARNING: /pci@#,#/#@#/FJSV,scfc@#,#(scfc#),SCF command (0x11a2) error. Status register = 0xXXXX

The value of the status register varies on the model.

• GP7000F model 1000/2000, PRIMEPOWER800/1000/2000

  Status register = 0xXXX9

• PRIMEPOWER900/1500/2500

  Status register = 0xXX9X

When messages not listed above or Status register values are displayed, refer to "Enhanced Support Facility users guide".