Chapter 1 OpenBoot Commands

This chapter describes the OpenBoot(TM) commands for Sun Enterprise 6x00/5x00/4x00/3x00 servers.

Environmental Monitoring

The following commands are used for environmental monitoring:

Table 1-1 Environmental Monitoring Commands

Command	Usage	Purpose
disable-environmental-monitor	disable-environmental-monitor ( -- )	To stop monitoring power supply status, board temperatures, and board hot plug while the screen displays the ok prompt.
enable-environmental-monitor	enable-environmental-monitor ( -- )	To start monitoring power supply status, board temperatures, and board hot plug while the screen displays the ok prompt.

Externally Initiated Reset XIR

If a hard failure occurs, use XIR to reset the system and get information about the system state at the time of the hard failure.

To Initiate an XIR

1. Use either the XIR button on the clock board or the remote console XIR sequence.

   When an XIR occurs, memory is cleared but some CPU state is saved.

To Display this XIR Information

1. Type the following command at the ok prompt immediately after the XIR:

   ---

   ok .xir-state-all
   

   ---

   The output displays the CPU state for each CPU:

   #1 ok .xir-state-all

   TL=1 TT=3

   CPU ID#1

   TPC=e0028688 TnPC=e0028688 TSTATE=9900001e06

   CPU ID#5

   TL=1 TT=3

   TPC=e002755c TnPC=e0027560 TSTATE=4477001e03

   #1 ok .xir-state-all

   TL=1 TT=3

---

Note -

The XIR does not override the NVRAM auto-boot? variable.

---

Where:

TL	Trap level
TT	Trap type
TPC	Trap program counter
TState	Trap state

Hardware Watchdog

The Sun Enterprise xx00 family of servers provide the ability to enable a hardware timer that will hard-reset the system if it times out. To enable the use of this feature, watchdog_enable must be set to 1 in /etc/system.

Flash PROM Management

The following OpenBoot 3.x commands are used in flash PROM management:

Table 1-2 Environmental Monitoring Commands

Command	Usage	Purpose
flash-update-system	flash-update-system ( -- )	To download the default flash images on all the boards in the system.
prom-copy	prom-copy ( src dst -- )	To copy a flash PROM from board src to board dst. Source (src) and Destination (dst) are specified by slot number.
update-proms	update-proms ( -- )	To synchronize the latest copy of each type of PROM on all other boards of the same type.

System Configuration and Diagnostic Information

To print system configuration and diagnostic information, use prtdiag instead of using an OpenBoot command. The diagnostic information displayed lists the failed field-replaceable units (FRUs) in the system. For more information on prtdiag, see the prtdiag man page.

prtdiag(1M) Options

-v lists the most recent AC Power failure, the most recent hardware fatal error information, and, if applicable, environmental status.

-l logs its output to syslogd(1M) only if failures or errors exist in the system.

TOD Clock Management

The following commands are used for time-of-day (TOD) clock management, which includes NVRAM.

Table 1-3 Environmental Monitoring Commands

Command	Usage	Purpose
copy-clock-tod-to-io-boards	flash-update-system ( -- )	To download the default flash images on all the boards in the system.
prom-copy	prom-copy ( src dst -- )	To copy a flash PROM from board src to board dst. Source (src) and Destination (dst) are specified by slot number.
update-proms	update-proms ( -- )	To synchronize the latest copy of each type of PROM on all other boards of the same type.

Specific NVRAM Variables

The following table lists specific NVRAM variables and their values::

Table 1-4 Specific NVRAM Variables

Variable Name	Value	Default Value
configuration-policy	component	component
disabled-board-list
memory-interleave	max	max
sbus-probe-default	d3120	N/A
sbus-specific-probe	1:d120	N/A