dr(1m)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | NOTES | SEE ALSO

NAME

dr- initiate dynamic reconfiguration shell

SYNOPSIS

dr

DESCRIPTION

The dr command initiates the Dynamic Reconfiguration (DR) shell, a Tcl application (see NOTES, below) with DR command extensions. You can use the dr shell to logically attach or detach a system board to or from a Sun Enterprise 10000 domain from the command line or by using a script.

---

Note -

Whenever possible, use the DR GUI in Hostview to execute Dynamic Reconfiguration operations. Use the dr shell when you cannot run Hostview; for example, if you need to run DR over a dial-up connection. For more information, see the Sun Enterprise 10000 Dynamic Reconfiguration User Guide and hostview(1M) in the Sun Enterprise 10000 SSP 3.5 Reference Manual.

---

When executed on the command line, dr connects to the domain specified by the SUNW_HOSTNAME environment variable. After this connection is established, dr displays the dr> prompt, which accepts the DR commands.

To see the list of DR commands if you not using AnswerBook2, execute man Intro on the SSP while logged in as user ssp.

---

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.

---

You can quit the dr shell at any time by typing exit or Control-d.

Caution: Do not execute any of the DR commands that begin with dr_cmd_; these are low-level commands that are for use only by authorized service personnel under special circumstances, as described in dr.service.

To minimize the risk of unintended DR operations, start this shell only when you are ready to execute DR commands and exit it as soon as you are done.

The DR commands return error status in the global Tcl variable dr_return. Normally, Tcl commands return both output and status together, which can be confusing and difficult to parse from within scripts. You can, however, execute the DR command set dr_return to display dr_return after executing each DR command, to determine command success or failure. Though, under most circumstances, the diagnostic messages output by the dr shell clearly indicate success or failure.

---

Note -

Type help at the dr shell prompt (dr>) to access DR quick-reference help guide.

---

EXAMPLES

---

Example 1 Using dr(1M)




The following example performs a DR Attach of Board 2 to the domain named "e100001". After complete_attach(1M) has successfully completed dr displays the result code stored in dr_return

e100001-ssp% domain_switch e100001 e100001-ssp% dr Checking environment... Initializing SSP SNMP MIB... Establishing communication with DR daemon... e100001: System Status - Summary BOARD #: 2 3 5 6 physically present. BOARD #: 0 1 4 being used by the system. dr> init_attach 2 Initiate attaching board 2 phase init_reset: Initial system resets... phase jtag_integ: JTAG probe and integrity test... phase mem_probe: Memory dimm probe... phase jtag_bbsram: JTAG basic test of bootbus sram... phase procl: Initial processor module tests... phase pc/cic_reg: PC and CIC register tests... phase dtag: CIC DTAG tests... phase mem: MC register and memory tests... phase procmem: Processor vs. memory tests... phase xcall: Interprocessor interrupt tests... phase io: I/O controller tests... Skipping phase ecc: Proc ecc vs. memory tests... phase final_config: Final configuration... Creating OBP handoff structures... Configured in 3F with 3 processors, 0 SBus cards, 1024 MBytes memory. Boot processor is 4.0 = 8 POST execution time 1:23 hpost is complete. /opt/SUNWssp/bin/obp_helper Master cpu is 8 Slave cpus initialization: Slave cpus initialization OK board debut utility complete. Board attachment initiated successfully. Ready to COMPLETE board attachment. dr> complete_attach 2 Completing attach for board 2 Board attachment completed successfully. dr> set dr_return 0 dr> exit e100001-ssp%

---

NOTES

Tcl (Tool command language) is a simple scripting language forr controlling and extending applications. You do not need Tcl knowledge to use the dr shell.

As a Tcl application, dr checks for certain types of syntax errors and, if it finds one, aborts without executing the dr shell command. For example, if you specify an argument with a command that does not require one, dr prints a usage error message and aborts. dr updates dr_return only upon completion of a dr command. If the command does not complete, as in our example above, dr does not update dr_return.

SEE ALSO

Sun Enterprise 10000 Dynamic Reconfiguration User Guide

Sun Enterprise Server Alternate Pathing 2.3 User Guide

Sun Enterprise 10000 SSP 3.5 User Guide

domain_switch(1M), hostview(1M) in the Sun Enterprise 10000 SSP 3.5 Reference Manual

dr(7) in man pages section 7: Device and Network Interfaces

add_drv(1M), drvconfig(1M), devlinks(1M), disks(1M), inetd(1M), ports(1M), prtconf(1M), tapes(1M) in man pages section 1M: System Administration Commands

syslog(3C) in man pages section 3: Basic Library Functions

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | NOTES | SEE ALSO