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

Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual

complete_attach(1m)

NAME

complete_attach- complete a DR Attach operation

SYNOPSIS

complete_attach

sb

DESCRIPTION

Execute this command at the dr(1M) shell prompt to complete an attempt to DR Attach a board after successful execution of the of the init_attach(1M) command. complete_attach causes the operating system running on the target domain to dynamically add the resources (processors, memory, and I/O devices) from the specified board to the running system. If a problem that prevents attachment of any device present on the board occurs, that problem is logged in the system message buffer of the target domain. To display a list of the devices that were successfully attached, execute the drshow(1M) command to display the current system configuration for the board.

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 operand is supported.

sb: The board number (0 to 15) of the system board to be attached to the target domain.

EXAMPLES

Example 1 Using `complete_detach`(1M)

dr> complete_attach 5
Completing attach for board 5
Board attachment completed successfully.

DIAGNOSTICS

The following diagnostics are supported:

Failed during final state transition

The operation failed during the final stage of attachment. Check that the DR daemon is still running on the target domain, and that the network is operational. To recover from the failure, repeat the complete_attach operation or execute an abort_attach(1M).

Failed to complete attach board

The operating system on the target domain was unable to attach the board. Repeat the complete_attach operation at a later time or execute the abort_attach(1M) command.

EXIT STATUS

If successful, complete_attach 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).