Dynamic Reconfiguration User's Guide 2.5.1

3.3 adrc(1M)

NAME

adrc - executes automated DR operation

SYNOPSYS

/opt/FJSVhwr/sbin/adrc -connect sbXY | sbXY-N [-reset]
/opt/FJSVhwr/sbin/adrc -disconnect sbXY | sbXY-N [-reset]
/opt/FJSVhwr/sbin/adrc -disconnect sbXY | sbXY-N -next PID [-reset]

AVAILABILITY

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

DESCRIPTION

Executes DR attach/detach, or assists system board hotswap or system board movement between partitions.
adrc(1M) command can be used only for a system board of the current partition or undefined("-").
DR operation can be completed automatically by executing this command.
adrc(1M) will automatically answer questions asked by the dr_query(1M) command by defining answers in reply files. (See section 3.6.2 "Reply File")

OPTIONS

The following options are available:

Status, PID, Next_PID, Board_Type, CPU(MHz) on the specified system board. Cabinet and slot numbers (sbXY or sbXY-N) are show by running the drcstat(1M) command.

-connect

Attach the system board specified with sbXY to the current partition (the partition where this command is invoked).
This option is specified to execute a DR attach.

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

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
-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 which 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

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 where the system board moved to 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.

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

FILES

/etc/opt/FJSVhwr/adrc.conf

LOG_FILE_NAME=/dev/stdout
RETRY_TIME=600
RETRY_CNT=3

LOG_FILE_NAME	specify the file name that holds logging information on adrc(1M). default value is /dev/stdout. <examples> /tmp/logfile , /dev/null , /dev/stdout , /dev/console
RETRY_TIME	specify interval time(sec) for adrc to retry DR operation in case of error.
RETRY_CNT	specify the number of times for retry.

EXAMPLES

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

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

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

Detach the system board "sb02" from the current partition at the next reboot.
# adrc -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 "adrc -connect sb02" is run on the partition #2.
<the current partition>
# adrc -disconnect sb02 -next 2
<partition #2>
# adrc -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 partition #2 and the current partition is rebooted next time.
# adrc -disconnect sb02 -next 2 -reset

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

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

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)