dr.service(1m)

NAME | DESCRIPTION | CAUTION | SHELL COMMANDS | EXIT STATUS

NAME

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

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.

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 to 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 (refer to hostview(1M) in Sun Enterprise 10000 SSP 3.5 Reference Manual) is the preferred method of performing DR operations. Use the dr(1M) shell when the GUI-based Hostview application is unavailable.

---

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.

---

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 Guide, or by using the high-level DR commands (those without the dr_cmd prefix) described in this reference manual.

SHELL COMMANDS

The low-level shell commands are those that begin with dr_cmd. See Intro(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.

---

NAME | DESCRIPTION | CAUTION | SHELL COMMANDS | EXIT STATUS