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

Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual

abort_attach(1m)

NAME

abort_attach- abort a DR Attach operation

SYNOPSIS

abort_attach

sb

DESCRIPTION

Execute this command at the dr(1M) shell prompt to return the specified board to its original condition after completion of an init_attach(1M) operation. abort_attach leaves the board present, powered-on, and in no domain. It instructs the operating system running on the target domain specified by the SUNW_HOSTNAME environment variable to abandon the in-progress attach operation, then removes the board from the domain_config file and resets the Enterprise 10000 centerplane cluster mask registers and board domain mask registers. Refer to domain_config(4) in the Sun Enterprise 10000 SSP Reference Manual.

You should run abort_attach after init_attach(1M) has successfully completed, and instead of the complete_attach(1M) command.

If executing abort_attach fails to abort the operation, try repeating the attempt at a later time, or contact your service provider.

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 not to be attached

EXAMPLES

Example 1 Using `abort_attach`(1M)

dr> abort_attach 5
Aborting attach board 5 to domain ts4.
Processors on board 5 reset.
Removing board 5 from domain_config file.
Board 5 placed into loopback.
Abort attach board successful.
dr>

DIAGNOSTICS

The following diagnostics are supported:

Failed to abort board attachment

Repeat the abort_attach command at a later time, or contact your service provider.

EXIT STATUS

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