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 an Enterprise 10000 domain from the command line or via a script.

Note:

Whenever possible, use the DR GUI via 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 Dynamic Reconfiguration User's Guide and hostview(1M) in man Pages(1M): Ultra Enterprise 10000 SSP Administration Commands .

When executed on the command line, dr displays the dr> prompt, which accepts the DR commands listed in Intro(1M).

Note:

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

es.PP 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(1M).

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's quickreference help guide.

EXAMPLE

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

e100001-ssp% dr

dr> drinit e100001

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 proc1: 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 for controlling and extending applications. You do not need Tcl knowledge to use the dr shell. However, if you wish to write Tcl scripts or just want more information about Tcl, a good reference is Tcl and the Tk Toolkit by John K. Ousterhout, published by Addison-Wesley Publishing Company.

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

Dynamic Reconfiguration User's Guide

Alternate Pathing 2.0 User's Guide

Ultra Enterprise 10000 SSP 3.0 User's Guide

hostview(1M) in the man Pages(1M): Ultra Enterprise 10000 SSP Administration Commands

dr (7)in the Solaris Reference Manual for SMCC-Specific Software

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

syslog(3) in the man Pages(3): Library Routines