Hardware manual

OBP Variables
(Following is a partial list of OBP configuration variables. These vary based on
machine types and PROM versions.)
Variable Typical
Default
Description
asr-disable (no default) Auto System Recovery “hard” disable
subsystem component. Options are
available from the list generated by
running asr-disable with no arguments.
asr-disable-list (no default) Auto System Recovery list of device
tree paths separated by spaces which
will be ignored at boot due to a failed
or disabled status. (Soft deconfigure)
asr-enable (no default) Auto System Recovery “hard” enable
subsystem component. Options are
available from the list generated by
running asr-enable with no arguments.
auto-boot? true If true, boot automatically after power
on or reset.
auto-boot-on-error? true Controls whether the system will
attempt a degraded boot when a
subsystem failure is detected. Both the
auto -boot? and auto-boot-on-error?
switches must be set to true to enable a
degraded boot.
ansi-terminal? true Configuration variable used to control
the behavior of the terminal emulator.
The value false makes the terminal
emulator stop interpreting ANSI
escape sequences, instead just
echoing them to the output device.
boot-command boot Command executed if auto-boot? Is
true.
boot-device disk net Device from which to boot.
boot-file (empty
string)
Arguments passed to booted program.
comX-noprobe (no default) Where X is the number of the serial
port, prevents device probe on serial
port X.
diag-continue? false If true, run all subtests even if an error
occurs. If false, stop diagnostics at the
first error.
diag-device net Diagnostic boot source device.
diag-file (empty
string)
Arguments passwd to booted program
in diagnostic mode.
diag-level max Level of diagnostic information.
(options: off, min, med or max)
diag-passes 1 Repeats each test the number of times
specified by n. Works with the test,
except, and test -all commands.
diag-switch? false If true, run in diagnostic mode.
diag-targets none none-Runs internal tests only, no I/O
testing.
iopath -Extends testing to external
device interfaces (connectors/cables).
media -Extends testing to external
devices and media, if present.
device-Invokes built-in self-test (BIST)
on PCI cards and external devices.
loopback-Runs external loopback tests
on the parallel, serial, keyboard, mouse
and TPE ports.
loopback2-Runs an external loopback
test on MII port.
loopbacks-Runs external loopback tests
on the parallel, serial, keyboard, mouse,
TPE, and MII ports.
nomem-Performs tests without testing
system memory.
diag-trigger power-reset power-reset-Runs diagnostics only on
power-on resets.
error-reset-Runs diagnostics only on
power-on resets, fatal hardware errors,
and watchdog reset events.
soft-reset-Runs diagnostics on all resets
(except XIR).
diag-verbosity 0 0-Prints one line that indicates the
device being tested and its pass/fail
status.
1-Prints more detailed test status, which
varies in content from test to test.
2-Prints subtest names.
4-Prints debug messages.
8-Prints back trace of callers on error.
disk-led-assoc 0 Disk slot association setting which can
be used to set up the proper
associations between disk slot numbers
and the physical and logical device
names used to identify the disk drives
installed in each slot.
Ex: setenv disk-led-assoc 0 x y
where: x is an integer identifying the
rear panel PCI slot number where the
lower UltraSCSI controller is installed
and y is an integer identifying the rear
panel PCI slot number where the upper
UltraSCSI controller is installed.
env-monitor enabled enabled-In response to an over
temperature condit ion or a fan failure in
either the CPU or disk fan tray, OBP
issues a warning and automatically
shuts down the system after 30 seconds.
advise- OBP issues a warning only,
without shutting down the system.
disable- OBP takes no action at all;
environmental monitoring at the OBP
level is disabled.
error-reset -recovery boot Recovery action after an error reset
CPU trap (options: none, sync, or boot)
fcode-debug? false If true, include name fields for plug-in
Fcodes.
hardware-revision (no default) Variable t o store hardware revision
info.
input-device keyboard Console input device (usually
keyboard, ttya, or ttyb).
keyboard-click? false If true, enable keyboard click.
keymap (no default) Keymap for custom keyboard.
last-hardware-update (no default) System update information.
load-base 16384 Default load address for client
programs.
local-mac-address? false If true, network devices use their own
MAC addresses.
memory-interleave auto auto -Determines best memory
interleaving based on number of slots
and memory types in those slots.
max-size-
max-interleave-Enables the maximum
level of interleaving possible for a
given memory configuration, but some
memory capacity remains unused if
DIMMs of different capacities are
installed.
1-Disables interleaving; uses all of the
available memory capacity.
2-Forces two-way interleaving.
4-Forces four-way interleaving.
mfg-mode off Manufacturing mode argument for
POST. Possible values include off or
chamber. The value is passed as an
argument to POST.
mfg-switch? false If true, repeat system self-test until
interrupted with STOP -A.
nvramrc (empty) Contents of NVRAMRC.
oem-banner (empty
string)
Custom OEM banner (enabled by oem-
banner? true).
oem-banner? false If true, use custom OEM banner.
oem-logo (no default) Byte array custom OEM logo (else use
Sun logo).
oem-logo? false If true, use custom OEM logo (enabled
by oem -logo? true).
output -device screen Console output device (usually screen,
ttya, or ttyb).
pci0 -probe-list 1,3,2,4
0
-
UPA
-
PCI bus bridge (not pro
bed)
1-EBus/Ethernet interface (always
probed, never included in probe list)
probed, never included in probe list)
2- On-board SCSI controller for
removable media devices and external
SCSI port
3- On-board SCSI controller for 4-slot
UltraSCSI backplane
4- Back panel PCI slot 10
pci-slot-skip -list none Used to exclude back panel slots from
the PCI probe list. Values are slot
numbers separated by commas or none.
pcia-probe-list 1, 2, 3, 4 Controls probe order of plug-in devices
under pcia.
pcib-probe-list 1, 2, 3 Controls probe order of plug-in devices
under pcib.
#power-cycles (no default) Counter for number of system power
cycles performed.
redmode-reboot? true Specify true to reboot after a redmode
reset trap. (Enterprise 10000 only)
redmode-sync? false Specify true to invoke OpenBoot
PROM's sync word after a redmode
reset trap. (Enterprise 10000 only)
sbus-probe-list 0123 Which Sbus slots to probe and in what
order.
screen-#columns 80 Number of on-screen columns
(characters/line).
screen-#rows 34 Number of on-screen rows (lines).
scsi-initiator-id 7 SCSI bus address of host adapter, range
0-f.
sd-targets 31204567 Map SCSI disk units which means that
unit 0 maps to target 3, unit 1 maps to
target 1, and so on. (OBP 1.x only).
security-#badlogins (no default) Number of incorrect security password
attempts.
security-mode none Firmware security level (options are
none, command, or full)
security-password (no default) Firmware security password (never
displayed)
selftest -#megs 1 Megabytes of RAM to test. Ignored if
diag-switch? is true.
sir-sync? false Specify true to invoke OpenBoot
PROM's sync word after a software-
initiated reset (SIR) trap. Defaults to
false. (Sun Enterprise 10000 only.)
skip-vme-loopback? false If true, POST does not do VMEbus
loopback tests.
sunmon-compat? false If true, display Restricted Monitor
prompt (>).
system-board-date (no default) Variable for system board date
information.
system-board-serial# (no default) Variable for system board serial
number information.
testarea 0 One-byte scratch field, available for
read/write test.
tpe-link-test? true Enable10baseT link test for built-in
twisted pair Ethernet.
ttya-mode 9600,8,n,1,- TTYA
(baud,#bits,parity,#stop,handshake).
Options are:
baud –
110,300,1200,2400,4800,9600,38400
#bits – 5,6,7,8
parity – n (none), e (even), o (odd)
#stop – 1 (1), . (1.5), 2 (2)
handshake -> - (none),
h(hardware:rts/cts),
s(software:xon/xoff)
ttyb-mode 9600,8,n,1,- TTYB
(baud,#bits,parity,#stop,handshake).
Options are:
baud –
110,300,1200,2400,4800,9600,38400
#bits – 5,6,7,8
parity – n (none), e (even), o (odd)
#stop – 1 (1), . (1.5), 2 (2)
handshake -> - (none),
h(hardware:rts/cts),
s(software:xon/xoff)
ttya-ignore-cd true If true, OS ignores TTYA carrier-
detect.
ttyb
-
ignore
-
cd
true
If true, OS ignores TTYB carrier
-
detect.
ttya-rts-dtr-off false If true, OS does not assert DTR and
RTS on TTYA.
ttyb-rts-dtr-off false If true, OS does not assert DTR and
RTS on TTYB.
upa-port -skip -list (no default) CPU=0 -3=Four plug-in slots
UPA-PCI bridge=4,6,1f=Soldered on
motherboard
UPA graphics frame buffer=1d,
1e=Two plug-in slots
Ex: setenv upa-port-skip-list 4,1d
use-nvramrc? false If true, execute commands in
NVRAMRC during system start-up.
watchdog-reboot? false If true, reboot after watchdog reset.
watchdog-sync? false Specify true to invoke OpenBoot
PROM's sync word after a watchdog
reset trap. ( Sun Enterprise 10000 only.)
Troubleshooting
Symptom Possible Cause Recommended Action
Hardware failure Check for power indicator lights on
monitor. If yellow, there is no sync.
Try a new monitor or a different
cable if possible.
Keyboard not
attached
If the keyboard is not attached,
output goes to TTYA instead. Power
down, plug in or reseat keyboard,
power back on. Try new keyboard.
output -device is
set to TTYA or
TTYB
NVRAM parameter output-device is
set to ttya or ttyb instead of screen.
Connect terminal to TTYA and reset
the system. After getting to the ok
prompt on the terminal, type:
screen output to send output to the
frame buffer. Use setenv to change
the default display device, if needed.
Blank screen
System has
multiple frame
buffers
Wrong frame buffer is being used as
the console device. Connect to any
other frame buffer/graphics cards
and see if signal is going there.
Defined by output-device variable.
diag-switch?
NVRAM param
is set to true
Interrupt the booting process with
Stop-A and run:
setenv diag-switch? false then
boot.
System boots from
net instead of disk
boot-device
NVRAM param
set to net not disk
Interrupt the booting process with
Stop-A and run:
setenv boot-device disk and boot
Ensure disk alias is set correctly.
Fails with the
message: The file
just loaded does
not appear to be
executable
The boot block is missing or
corrupted. Install a new boot block
or Older SPARC systems don’t like
root partition over 2 gig. Reload
system with root partition of 1.8 gig
or smaller size.
System will not
boot from disk
Fails with the
message: Can't
open boot device
Disk may be powered down or
unavailable/failed. Listen to see if
disk is spinning. Check cablin g or
connection, reseat disk, or try
another disk or older SPARC
systems don’t like root partitions
over 2 gig. Reload system with root
partition of 1.8 gig or smaller size.
SCSI problems or
errors
Duplicate SCSI
target number
settings or device
hardware
problems
Unplug all but one disk. Run probe-
scsi and note target number and unit
number. Repeat steps for remaining
disks looking for errors or ID
conflicts. On ID conflict, change the
target number of the offending disk
to be one of the unused target
numbers or remove/replace if
hardware problem.
Helpful Web Links
http://docs.sun.com - Sun Microsystems Online Documentation Site
http://sunsolve.sun.com - Sun Microsystems Online Help Resource Site
http://searchsolaris.com - Sun Oriented Website
and of course there’s always http://google.com - Great Web Search Site