OBP

The following table describes commands available in OpenBoot version 3.x. To use a command, simply type the command at the OBP ok prompt and press Return.

• banner : Displays the power on banner. The banner includes information such as CPU speed, OBP revision, total system memory, ethernet address and hostid.
• devalias alias path : Defines a new device alias, where alias is the new alias name and path is the physical path of the device. If devalias is used without arguments, it displays all system device aliases (will run up to 120 MHz).
• .enet-addr : Displays the ethernet address.

led-off/led-on Turns the system led off or on.

• nvalias name path : Creates a new alias for a device, where name is the name of the alias and path is the physical path of the device.

Note - Run the reset-all or the nvstore command to save the new alias in non-volatile memory (NVRAM).

• nvunaliasname path : Deletes a user-created alias (see nvalias), where name is the name of the alias and path is the physical path of the device.

Note - Run the reset-all or nvstore command to save changes in NVRAM.

• nvstore : Copies the contents of the temporary buffer to NVRAM and discards the contents of the temporary buffer.
• power-off/power-on : Powers the system off or on.
• printenv : Displays all parameters, settings, and values.
• probe-fcal-all : Identifies Fiber Channel Arbitrated Loop (FCAL) devices on a system.1
• probe-sbus : Identifies devices attached to all SBUS slots.

Note - This command works only on systems with SBUS slots.

• probe-scsi : Identifies devices attached to the onboard SCSI bus.1
• probe-scsi-all : Identifies devices attached to all SCSI busses.1
• set-default parameter : Resets the value of parameter to the default setting.
• set-defaults : Resets the value of all parameters to the default settings.

Tip - You can also press the Stop and N keys simultaneously during system power-up to reset the values to their defaults.

• setenv parameter value : Sets parameter to specified value.

Note - Run the reset-all command to save changes in NVRAM.

• show-devs : Displays all the devices recognized by the system.
• show-disks : Displays the physical device path for disk controllers.
• show-displays : Displays the physical device path for frame buffers.
• show-nets : Displays the physical device path for network interfaces.
• show-post-results : If run after Power On Self Test (POST) is completed, this command displays the findings of POST in a readable format.
• show-sbus : Displays devices attached to all SBUS slots. Similar to probe-sbus.
• show-tapes : Displays the physical device path for tape controllers.
• sifting string : Searches for OBP commands or methods that contain string. For example, the sifting probe command displays probe-scsi, probe-scsi-all, probe-sbus, and so on.
• .speed : Displays CPU and bus speeds.
• test device-specifier : Executes the selftest method for device-specifier. For example, the test net command tests the network connection.
• test-all : Tests all devices that have a built-in test method.
• .version : Displays OBP and POST version information.
• watch-clock : Tests a clock function.
• watch-net : Monitors the network connection for the primary interface.
• watch-net-all : Monitors all the network connections.
• words : Displays all OBP commands and methods.

show-pci-devs-all (show all pci devices)

show-pci-configs-all

probe-pci

To prepare your system to run OBDiag, perform the following:

1. Set the OBP diagnostics variable:

ok setenv diag-switch? true

2. Set the auto-boot variable:

ok setenv auto-boot? false

3. Reset the system:

ok reset-all

Then, to run OBDiag, type obdiag at the ok prompt.

POST is a program that resides in the firmware of each board in a system, and it is used to initialize, configure, and test the system boards. POST output is sent to serial port A (on an Ultra Enterprise server, POST output is sent only to serial port A on the system and clock board). The status LEDs of each system board on Ultra Enterprise servers indicate the POST completion status. For example, if a system board fails the POST test, the amber LED stays lit.

You can watch POST ouput in real-time by attaching a terminal device to serial port A. If none is available, you can use the OBP command show-post-results to view the results after POST completes.

1. Attach a terminal device to serial port A.

2. Set the OBP diagnostics variable:

ok setenv diag-switch? true

3. Set the desired testing level.

Two different levels of POST can be run, and you can choose to run all tests or some of the tests. Set the OBP variable diag-level to the desired level of testing (max or min), for example:

ok setenv diag-level max

4. If you wish to boot from disk, set the OBP variable diag-device:

ok setenv diag-device disk

The system default for this variable is net.

5. Set the auto-boot variable:

ok setenv auto-boot? false

6. Save the changes.

ok reset-all

7. Power cycle the system (turn it off, and then back on).

POST runs while the system is powered on, and the output is displayed on the device attached to serial port A. After POST is completed, you can also run the OBP command show-post-results to view the result.