NAME

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

SYNOPSIS

dr (to open the DR shell)

DESCRIPTION

Caution:

Customers should not use these low-level commands, but should access DR through the DR GUI, as described in the Dynamic

Reconfiguration User's Guide, or via the high-level DR commands, which are described in man Pages(1M): DR Administration Commands .

The low-level commands described here, which are available only in the DR shell, are for use by service providers only, who 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.

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 man Pages(1M): Ultra Enterprise 10000 SSP Administration Commands )is the preferred method of performing DR operations. Use the dr (1M)shell when the GUIbased Hostview application is unavailable.

SHELL COMMANDS

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

DR Administration Commands..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.