NAME

dr.service - low-level DR commands for service providers

AVAILABILITY

Sun Enterprise 10000 servers only.

DESCRIPTION

The low-level commands described here, which begin with dr_cmd, are available only in the DR shell, and are for use by service providers only. Service providers should use them only when they need a finer level of control to debug failing DR operations, or when they cannot access the DR GUI.

Caution:

Customers should not use these low-level commands, but should access DR through the DR GUI, as described in the Sun Enterprise 10000 Dynamic Reconfiguration User's Guide, or via the high-level DR commands (those without the dr_cmd prefix) described in this reference manual.

The DR shell provides commands that directly map to libdr.so function calls. Executing this command set gives the caller a finer level of control over DR operations, but introduces additional risk of error due to fewer safeguards.

Note that DR operations can fail or be denied by the operating system for numerous reasons. Often, specific user action is required to complete a DR sequence. For this reason, Sun cautions against the use of automated DR scripts. The Hostview interface (see hostview(1M) in Ultra Enterprise 10000 SSP Reference Manual) is the preferred method of performing DR operations. Use the dr (1M)shell when the GUI-based Hostview application is unavailable.

SHELL COMMANDS

The low-level shell commands are those that begin with dr_cmd_ . See Intro(1M).

dr.service ( 1M ) EXIT STATUS

The DR shell low-level command set generally returns an exit code in the dr_return global variable. Upon return from each of the DR commands, this variable can be tested for success or failure.

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.

DR

1M-11