Modifying Boot Behavior on SPARC Based Systems (Task Map)

Task	Description	For Instructions
Identify the PROM revision number.	Use the banner command at the ok prompt to display the PROM revision number for a system.	SPARC: How to Find the PROM Revision Number for a System
Identify devices on the system that can be booted.	Before modifying boot behavior by using the boot PROM, identify the devices on the system.	SPARC: How to Identify Devices on a System
Display the current boot device.	Use this procedure to determine the current default boot device from which the system will boot.	SPARC: How to Determine the Default Boot Device
Change the default boot device.	To change the default boot device, use one of the following methods: Change the boot-device parameter at the boot PROM. Change the boot-device parameter by using the eeprom command.	SPARC: How to Change the Default Boot Device by Using the Boot PROM SPARC: How to Change the Default Boot Device by Using the eeprom Command
Reset the system.	When you reset the system, the system runs diagnostic tests on the hardware, then reboots.	SPARC: Resetting the System
Change the default boot file.	To change the default kernel that the system boots, use one of the following methods: Change the boot-file parameter by using the boot PROM. Change theboot-file parameter by using the eeprom command.	SPARC: How to Change the Default Kernel by Using the Boot PROM SPARC: How to Change the Default Kernel by Using the eeprom Command

SPARC: Using the Boot PROM

The boot PROM is used to boot a system. You might need to change the way the system boots. For example, you might want to reset the device to boot from or run hardware diagnostics before you bring the system to a multiuser level.

System administrators typically use the PROM level to boot a system. You can also change the default boot file and boot device at the PROM level.

If you need to perform any of the following tasks, you need to change the default boot device:

• Add a new drive to the system either permanently or temporarily

• Change the network boot strategy

• Temporarily boot a stand-alone system from the network

For a complete list of PROM commands, see monitor(1M) or eeprom(1M).

SPARC: How to Find the PROM Revision Number for a System

• Display a system's PROM revision number by using the banner command.

  ok banner
  Sun Ultra 5/10 UPA/PCI (UltraSPARC-IIi 333MHz), No Keyboard
  OpenBoot 3.15, 128 MB memory installed, Serial #number.
  Ethernet address number, Host ID: number.

  Hardware configuration information, including the revision number of the PROM, is displayed. In this example, the PROM revision number is 3.15.

SPARC: How to Identify Devices on a System

You might need to identify the devices on the system to determine what are the appropriate devices to boot from.

Before You Begin

Before you can safely use the probe commands to determine what devices are attached to the system, you need to do the following:

• Change the PROM auto-boot? parameter to false.

  ok setenv auto-boot? false

• Issue the reset-all command to clear system registers.

  ok reset-all

You can view the probe commands that are available on your system by using the sifting probe command:

ok sifting probe

If you run the probe commands without clearing the system registers, the following message is displayed:

ok probe-scsi
This command may hang the system if a Stop-A or halt command
has been executed.  Please type reset-all to reset the system 
before executing this command. 
Do you wish to continue? (y/n) n

1. Identify the devices on the system.

   ok probe-device

2. (Optional) If you want the system to reboot after a power failure or after using the reset command, then reset the auto-boot? parameter to true.

   ok setenv auto-boot? true
   auto-boot? =          true

3. Boot the system to multiuser mode.

   ok reset-all

Example 11-1 SPARC: Identifying the Devices on a System

The following example shows how to identify the devices connected to an Ultra^TM 10 system.

ok setenv auto-boot? false
auto-boot? =          false
ok reset-all
Resetting ... 

Sun Ultra 5/10 UPA/PCI (UltraSPARC-IIi 333MHz), No Keyboard
OpenBoot 3.15, 128 MB memory installed, Serial #10933339.
Ethernet address 8:0:20:a6:d4:5b, Host ID: 80a6d45b.

ok probe-ide
  Device 0  ( Primary Master ) 
          ATA Model: ST34321A                                

  Device 1  ( Primary Slave ) 
         Not Present

  Device 2  ( Secondary Master ) 
         Removable ATAPI Model: CRD-8322B                               

  Device 3  ( Secondary Slave ) 
         Not Present

ok setenv auto-boot? true
auto-boot? =          true

Alternatively, you can use the devalias command to identify the device aliases and the associated paths of devices that might be connected to the system. For example:

ok devalias
screen                   /pci@1f,0/pci@1,1/SUNW,m64B@2
net                      /pci@1f,0/pci@1,1/network@1,1
cdrom                    /pci@1f,0/pci@1,1/ide@3/cdrom@2,0:f
disk                     /pci@1f,0/pci@1,1/ide@3/disk@0,0
disk3                    /pci@1f,0/pci@1,1/ide@3/disk@3,0
disk2                    /pci@1f,0/pci@1,1/ide@3/disk@2,0
disk1                    /pci@1f,0/pci@1,1/ide@3/disk@1,0
disk0                    /pci@1f,0/pci@1,1/ide@3/disk@0,0
ide                      /pci@1f,0/pci@1,1/ide@3
floppy                   /pci@1f,0/pci@1,1/ebus@1/fdthree
ttyb                     /pci@1f,0/pci@1,1/ebus@1/se:b
ttya                     /pci@1f,0/pci@1,1/ebus@1/se:a
keyboard!                /pci@1f,0/pci@1,1/ebus@1/su@14,3083f8:forcemode
keyboard                 /pci@1f,0/pci@1,1/ebus@1/su@14,3083f8
mouse                    /pci@1f,0/pci@1,1/ebus@1/su@14,3062f8
name                     aliases

SPARC: How to Determine the Default Boot Device

1. Bring the system to the ok PROM prompt.

   For more information, see How to Shut Down a Stand-Alone System.

2. Use the printenv command to determine the default boot device.

   ok printenv boot-device

   boot-device

   Identifies the parameter for setting the device from which to boot.

   device[n]

   Identifies the boot-device value such as a disk or the network. The n can be specified as the disk number.

   The default boot-device is displayed in a format that is similar to the following:

   boot-device = /pci@1f,4000/scsi@3/disk@1,0:a

   If the default boot-device is a network boot device, the output is similar to the following:

   boot-device = /sbus@1f,0/SUNW,fas@e,8800000/sd@a,0:a \
   /sbus@1f,0/SUNW,fas@e,8800000/sd@0,0:a disk net

SPARC: How to Change the Default Boot Device by Using the Boot PROM

You might need to identify the devices on the system before you can change the default boot device to some other device. For information on identifying devices on the system, see SPARC: How to Identify Devices on a System.

1. Change to run level 0.

   # init 0

   The ok PROM prompt is displayed. For more information, see theinit(1M) man page.

2. Change the value of the boot-device parameter.

   ok setenv boot-device device[n]

   Use one of the probe commands if you need help identifying the disk number.

3. Verify that the default boot device has been changed.

   ok printenv boot-device

4. Save the new boot-device value.

   ok reset-all

   The new boot-device value is written to the PROM.

Example 11-2 SPARC: Changing the Default Boot Device

In this example, the default boot device is set to disk.

# init 0
# 
INIT: New run level: 0
.
.
.
The system is down.
syncing file systems... done
Program terminated
ok setenv boot-device /pci@1f,4000/scsi@3/disk@1,0
boot-device =         /pci@1f,4000/scsi@3/disk@1,0
ok printenv boot-device
boot-device           /pci@1f,4000/scsi@3/disk@1,0
ok boot
Resetting ... 

screen not found.
Can't open input device.
Keyboard not present.  Using ttya for input and output.

Sun Enterprise 220R (2 X UltraSPARC-II 450MHz), No Keyboard
OpenBoot 3.23, 1024 MB memory installed, Serial #13116682.
Ethernet address 8:0:20:c8:25:a, Host ID: 80c8250a.

Rebooting with command: boot disk1                                    
Boot device: /pci@1f,4000/scsi@3/disk@1,0  File and args:

In this example, the default boot device is set to the network.

# init 0
# 
INIT: New run level: 0
.
.
.
The system is down.
syncing file systems... done
Program terminated
ok setenv boot-device net
boot-device =         net
ok printenv boot-device
boot-device           net                    disk
ok reset
Sun Ultra 5/10 UPA/PCI (UltraSPARC-IIi 333MHz), No Keyboard
OpenBoot 3.15, 128 MB memory installed, Serial #number.
Ethernet address number, Host ID: number.



Boot device: net  File and args:
.
.
.
pluto console login:

SPARC: How to Change the Default Boot Device by Using the eeprom Command

1. Become superuser or assume an equivalent role.
2. Specify the alternate kernel to boot.

   # eeprom boot-device new-boot-device

3. Verify that the new parameter has been set.

   # eeprom boot-device

   The output should display the new eeprom value for the boot-device parameter.

SPARC: Resetting the System

Run the following command from the ok prompt:

ok reset-all

The self-test program, which runs diagnostic tests on the hardware, is executed. Then, if the auto-boot? parameter is set to true, the system is rebooted.

SPARC: How to Change the Default Kernel by Using the Boot PROM

1. Change to run level 0.

   # init 0

   The ok PROM prompt is displayed. For more information, see theinit(1M) man page.

2. Set the boot-file property to an alternate kernel.

   ok setenv boot-file boot-file

3. Verify that the default boot device has been changed.

   ok printenv boot-file

4. Save the new boot-file value.

   ok reset-all

   The new boot-file value is written to the PROM.

SPARC: How to Change the Default Kernel by Using the eeprom Command

1. Become superuser or assume an equivalent role.
2. Specify the alternate kernel to boot.

   # eeprom boot-file new boot-file

   For example:

   # eeprom boot-file=kernel.name/sparcv9/unix

3. Verify that the new parameter has been set.

   # eeprom boot-file

   The output should display the new eeprom value for the specified parameter.