complete_detach(1m) (Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual)

Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual

complete_detach(1m)

NAME

complete_detach- complete a DR detach operation

SYNOPSIS

complete_detach

sb

DESCRIPTION

Execute this command at the dr(1M) shell prompt to complete an attempt to DR Detach a board. The drain(1M) must have been previously executed and the drain operation must have completed before complete_detach can proceed. You can use the drshow(1M) command to check the status of the domain operation.

A board can be detached only after all use of its devices has ceased. DR automatically terminates the use of memory and network devices and, in almost all cases, processors; but you must terminate use of the board's I/O devices. You can use the drshow(1M) command to list the devices in use on the board.

If the detaching board contains non-pageable kernel or OBP memory, the domain is quiesced during the complete_detach operation. The quiesce operation may fail due to forcible conditions. Refer to the Sun Enterprise 10000 Dynamic Reconfiguration User Guide for a description of such conditions. You can use the force argument to force the quiesce in such situations.

Note -

This command is available only for DR 2.0 domains (that is, domains that use the DR daemon) on the Sun Enterprise 10000 server. You can use domain_status(1M) to determine the DR version running on the domain.

OPERANDS

The following operands are supported.

sb: The board number (0 to 15) of the system board to be detached
force: Force the domain quiesce operation. Refer to the Sun Enterprise 10000 Dynamic Reconfiguration User Guide for a description of such conditions. You can use the force argument to force the quiesce in such situations.

EXAMPLES

Example 1 Using `complete_detach`(1M)

dr> complete_detach 5
Completing detach of board 5.
Operating System has detached the board.
Processors on board 5 reset.
Board 5 placed into loopback.
Board detachment completed successfully.

DIAGNOSTICS

The following diagnostics are supported:

Cannot COMPLETE detach until drain completes

The drain operation is still in-progress. Use drshow(1M) to monitor the drain. After it has completed, repeat the complete_detach command.

Board detachment failed

Retry the COMPLETE or ABORT the operation

A condition in the operating system on the domain prevented the detach from completing. Retry the operation at a later time, or use abort_detach(1M) to abort the detach.

EXIT STATUS

If successful, complete_detach returns a 0 in the dr_return global variable; if not, it returns a 1, along with one or more diagnostic messages.

NOTES

If DR detects a usage syntax error, it immediately aborts the dr(1M) command, displays the dr(1M) shell prompt, and leaves dr_return unmodified. See dr(1M).