C H A P T E R  9

Configuring System Firmware

This chapter describes OpenBoot firmware commands and configuration variables available for configuring the following aspects of Sun Fire V490 system behavior:

In addition, this chapter provides information about keyboard commands and alternative methods for performing OpenBoot emergency procedures.

Tasks covered in this chapter include:



Note - Many of the procedures in this chapter assume that you are familiar with the OpenBoot firmware and that you know how to enter the OpenBoot environment. For background information, see About the ok Prompt. For instructions, see How to Get to the ok Prompt.




How to Enable OpenBoot Environmental Monitoring

Before You Begin

For background information about the OpenBoot environmental monitor, see:

What to Do

single-step bulletTo enable OpenBoot environmental monitoring, type env-on at the ok prompt.:

ok env-on
Environmental monitor is ON
ok

What Next

To disable OpenBoot environmental monitoring, complete this task:


How to Disable OpenBoot Environmental Monitoring

Before You Begin

For background information about the OpenBoot environmental monitor, see:

What to Do

single-step bulletTo disable OpenBoot environmental monitoring, type env-off at the ok prompt:

ok env-off
Environmental monitor is OFF
ok


How to Obtain OpenBoot Environmental Status Information

Before You Begin

For background information about environmental status information, see:

What to Do

single-step bulletTo obtain OpenBoot environmental status information, type .env at the ok prompt:

ok .env


How to Enable the Watchdog Mechanism and Its Options

Before You Begin

For background information about the hardware watchdog mechanism and related externally initiated reset (XIR) functionality, see:

What to Do

1. Edit the /etc/system file to include the following entry.

set watchdog_enable = 1

2. Choose the desired system recovery behavior.

The hardware watchdog mechanism can automatically reboot the system in case the system hangs. This can be done with or without first generating an automated crash dump file. As superuser, do one of the following:

3. Restart the system to effect the changes. Type:

# reboot

What Next

If you choose to have the system generate an automated crash dump file, then, in the event the operating system hangs, that file appears in the /var/crash/ directory, under a subdirectory named after your system. For more information, see the documentation accompanying your Solaris software release.


How to Enable ASR

The automatic system recovery (ASR) feature is activated by default. However, if you have manually disabled it, use this procedure to restore it.

What to Do

1. Set the system control switch to the Normal position.

2. At the system ok prompt, type:

ok setenv service-mode? false
ok setenv auto-boot? true
ok setenv auto-boot-on-error? true

3. Set the diag-trigger variable either to power-on-reset, error-reset, (the default) or to all-resets. For example, type:

ok setenv diag-trigger all-resets

4. To cause the parameter changes to take effect, type:

ok reset-all

The system permanently stores the parameter changes and boots automatically if the OpenBoot variable auto-boot? is set to true (its default value).

What Next

To disable ASR, complete this task:


How to Disable ASR

After you disable the automatic system recovery (ASR) feature, it is not activated again until you enable it at the system ok prompt.

What to Do

1. At the system ok prompt, type:

ok setenv auto-boot-on-error? false

2. To cause the parameter change to take effect, type:

ok reset-all

The system permanently stores the parameter change.


How to Obtain ASR Status Information

Use the following procedure to retrieve information about the status of the automatic system recovery (ASR) feature.

What to Do

1. At the system ok prompt, type:

ok .asr

In the .asr command output, any devices marked disabled have been manually deconfigured using the asr-disable command. The .asr command also lists devices that have failed firmware diagnostics and have been automatically deconfigured by the OpenBoot ASR feature.

2. Display components that have failed POST diagnostics. Type:

ok show-post-results

3. Display components that have failed OpenBoot diagnostics tests. Type:

ok show-obdiag-results

What Next

For more information, see:


How to Redirect the System Console to the System Controller

Perform this procedure if, after installing the Solaris OS and the Sun Remote System Control (RSC) software, you want to configure the system to use the system controller as the system console. For more information about RSC software, see:

What to Do

1. Establish a system controller session.

For instructions, see the Sun Remote System Control (RSC) 2.2 User's Guide, which is included on the Sun Fire V490 Documentation CD.

2. At the system ok prompt, type:

ok setenv diag-out-console true
ok setenv input-device rsc-console
ok setenv output-device rsc-console

3. To cause the changes to take effect, type:

ok reset-all

The system permanently stores the parameter changes and boots automatically if the OpenBoot variable auto-boot? is set to true (its default value).

4. To connect to the system console, at the system controller prompt, type:

rsc> console



Note - To reverse the system controller console redirection manually and temporarily by resetting OpenBoot configuration variables, follow the instructions in About OpenBoot Emergency Procedures. Otherwise follow the system controller console exit steps in the section, How to Restore the Local System Console.



What Next

For instructions on how to use RSC software, see:


How to Restore the Local System Console

Perform this procedure if your system is configured to use the system controller (SC) as the system console and you need to redirect the system console to a local graphics terminal, alphanumeric terminal, or an established tip connection. For more information about RSC software, see:

What to Do

1. Set the input and output device. Do one of the following.

The above settings are appropriate for viewing system console output on either an alphanumeric terminal or a tip line connected to serial port ttya.

The above settings are appropriate for viewing system console output on a graphics terminal connected to a frame buffer card.

2. To cause the changes to take effect, type:

ok reset-all

The system permanently stores the parameter changes and boots automatically if the OpenBoot variable auto-boot? is set to true (its default value).

What Next

You can now issue commands and view system messages on the local console.


How to Deconfigure a Device Manually

Before You Begin

To support the ability to boot even when nonessential components fail, the OpenBoot firmware provides the asr-disable command, which lets you manually deconfigure system devices. This command "marks" a specified device as disabled, by creating an appropriate "status" property in the corresponding device tree node. By convention, UNIX will not activate a driver for any device so marked. For background information, see

What to Do

1. At the system ok prompt, type:

ok asr-disable device-identifier

where the device-identifier is one of the following:



Note - Manually deconfiguring a single processor causes the entire CPU/Memory board to be deconfigured, including all processors and all memory residing on the board.



OpenBoot configuration variable changes take effect after the next system reset.

2. To effect the changes immediately, type:

ok reset-all



Note - To immediately effect the changes, you can also power cycle the system using the front panel Power button




How to Reconfigure a Device Manually

Before You Begin

You can use the OpenBoot asr-enable command to reconfigure any device that you previously deconfigured with asr-disable. For background information, see

What to Do

1. At the system ok prompt, type:

ok asr-enable device-identifier

where the device-identifier is one of the following:

2. Do one of the following:



Note - To reconfigure a processor, you must power cycle the system. The reset-all command will not suffice to bring the processor back online.




How to Implement Stop-N Functionality

Before You Begin

This procedure implements Stop-N functionality on Sun Fire V490 systems, temporarily resetting OpenBoot configuration variables to their default settings. This procedure is most useful if you have not configured your Sun Fire V490 system to run diagnostic tests. You might find it more convenient to use the alternative method of placing the system control switch in the Diagnostics position. For more background, see:

For information about the system control switch, see:

What to Do

1. Turn on the power to the system.

If POST diagnostics are configured to run, both the Fault and Locator LEDs on the front panel will blink slowly.

2. Wait until only the system Fault LED begins to blink rapidly.



Note - If you have configured the Sun Fire V490 system to run diagnostic tests, this could take upwards of 30 minutes.



3. Press the front panel Power button twice, with no more than a short, one-second delay in between presses.

A screen similar to the following is displayed to indicate that you have temporarily reset OpenBoot configuration variables to their default values:

Setting NVRAM parameters to default values.
 
Probing I/O buses
 
Sun Fire V490, No Keyboard
Copyright 1998-2004 Sun Microsystems, Inc.  All rights reserved.
OpenBoot x.x, xxxx MB memory installed, Serial #xxxxxxxx.
Ethernet address x:x:x:x:x:x, Host ID: xxxxxxxx.
 
System is operating in Safe Mode and initialized with factory 
default configuration.  No actual NVRAM configuration variables 
have been changed; values may be displayed with 'printenv' and set 
with 'setenv'. System will resume normal initialization and 
configuration after the next hardware or software reset.
 
ok



Note - Once the front panel LEDs stop blinking and the Power/OK LED stays lit, pressing the Power button again will begin a graceful shutdown of the system.



What Next

During the execution of OpenBoot firmware code, all OpenBoot configuration variables--including the ones that are likely to cause problems, such as input and output device settings--are temporarily set to "safe" factory default values. The only exception to this is auto-boot, which is set to false.

By the time the system displays the ok prompt, OpenBoot configuration variables have been returned to their original, and possibly misconfigured, values. These values do not take effect until the system is reset. You can display them with the printenv command and manually change them with the setenv command.

If you do nothing other than reset the system at this point, no values are permanently changed. All your customized OpenBoot configuration variable settings are retained, even ones that may have caused problems.

To correct such problems, you must either manually change individual OpenBoot configuration variables using the setenv command, or else type set-defaults to permanently restore the default settings for all OpenBoot configuration variables.