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

Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual

dr_cmd_init_attach(1m)

NAME

dr_cmd_init_attach- initiate DR attach system board operation

SYNOPSIS

dr_cmd_init_attach

sb

CAUTION

Do not use this command, which runs in the DR shell; it is dangerous, and is included here only for completeness. Instead, use init_attach(1M), which performs the same functions, but with the added security of safeguards and checks.

DESCRIPTION

dr_cmd_init_attach begins a DR attach board operation. DR does not screen the target domain for intermediate system boards as it does with the init_attach(1M) command and through Hostview.

dr_cmd_init_attach is a low-level command for use only by trained service personnel for diagnosing DR-related system problems. The designated system board should be present, powered-on, and currently in no domain. dr_cmd_init_attach diagnoses, then debuts the system board to the target domain specified in the SUNW_HOSTNAME environment variable.

dr_cmd_init_attach adds the system board to the system board list in the SSP domain_config file. (Refer to the domain_config(4) man page in the Sun Enterprise 10000 SSP 3.5 Reference Manual.) DR then prepares the resources (processors, memory, and I/O controllers) for attachment by the operating system, and the centerplane is reconfigured such that the board is visible to the target domain.

After dr_cmd_init_attach completes successfully, you can execute dr_cmd_c_attach(1M) to complete the attach operation, or dr_cmd_a_attach(1M) to abort it.

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

DIAGNOSTICS

See DIAGNOSTICS on the init_attach(1M) man page.

EXIT STATUS

If dr_cmd_init_attach succeeds it returns a 0 result code in the dr_return global variable. If it fails, it returns a 1 and displays diagnostic messages.

Note -

Tcl parsing errors prevent DR commands from running which, in turn, leaves dr_return uninitialized. In such cases, the dr_return error code is meaningless. See dr(1M) for more information concerning return codes.