Solaris 7 Sun Hardware Platform Guide

Before Updating the Flash PROM

Before you begin updating the flash PROM, please note the following.


Caution - Caution -

Do not interrupt power during flash PROM updating. When you are using the update routine, do not remove or insert system boards.



Note -

If power is interrupted during flash PROM updating, follow the power interruption recovery procedures covered later in this chapter.


Running the Flash PROM Update Script Manually

The flash PROM update script is typically run at bootup. You can also run the flash PROM update script manually by doing the following:

  1. If you shut down the system in order to set the write-enable jumper (Sun Ultra 1 and Ultra 2 systems), turn the system on so it can boot.

  2. Bring the system down to single user mode.


    % su
    Type your superuser password
    # init S
    

    Type the following:

  3. Execute the flash PROM update script by typing the following:


    /bin/sh /usr/platform/sun4u/lib/prom/`/usr/bin/uname -i`

    Follow the step-by-step instructions when running the script in the section "To Update the Flash PROM". Begin with Step 2 (do not execute the reboot command).

To Update the Flash PROM
  1. If you shut down your system to set the write-enable jumper (Ultra 1, Ultra 2 systems), turn the system on so it can boot. Go to Step 1.

  2. If you did not need to shut down the system (for example, with the Sun Enterprise 450 system or the Sun Ultra 450 workstation), reboot your system. Type reboot at the superuser prompt.


    # reboot
    

  3. If your flash PROM needs to be updated, the flash PROM update script displays the following message


    This system has older firmware. Although the current firmware is fully capable of running the 32-bit packages, you will not be able to run the 64-bit packages installed on this system until you update the system flash PROM.
    
    This system ships with flash PROM write-protect jumpers in the "write disabled" position. Before running the flash PROM update, please verify that the flash PROM jumpers are in the "write-enabled" position.
    
    See the Hardware Platform Guide for more information.
    
    Please answer the next question within 90 seconds, or press the ENTER key to disable the timer.
    
    Would you like to run the system flash PROM update now?
    (By default the system flash PROM update will not be run now.) yes or no? [y,n] y
    
    Flash Update 2.0: Program and system initialization in progress...

  4. If you see the line Current Flash PROM Revision on your screen, go to Step 1. If you see the error message Flash Update: System Security is set, complete Step 1. If the Open Boot security-mode was set to either full or command, then you have PROM-level security turned on and you cannot update the flash PROM. With security turned on you will see the following error message. You need to set the security-mode variable to none.


    **ERROR:  System
    security is set:
    System firmware was not modified.
    

  5. If you need to change the OpenBoot security-mode, as the system boots go to the ok prompt by one of the following methods. Then follow the steps in the screen which follows.

    • Press Stop-a from the keyboard.

    • If you are running on a terminal and connected to serial port A of the system, press the Break key.

    • If you are connected to serial port A via telnet connection send a Break sequence by pressing the Control and ] keys simultaneously. This returns you to the telnet command line. Type send brk at the telnet command line.

    • If you are connected to serial port A via a tip connection, send a Break sequence by typing the characters ~# in quick succession.


      Type boot, go (continue), or login (command mode)
      > login
      Firmware Password: Type your security password
      Type help for more information
      ok setenv security-mode none
      ok boot
      

  6. When the flash update process begins, it displays the current and available OpenBoot firmware revisions. Type yes to the question about updating the firmware in the system flash PROM. If the NVRAM configuration variable use-nvramrc? is set to true, the update script resets use-nvramrc? to false. You will only see the message about the use-nvramrc? variable if use-nvramrc? is set to true.


    Current System Flash PROM Revision:
    -----------------------------------
    OBP 3.5.2 1997/01/06 17:40
    
    Available System Flash PROM Revision:
    -------------------------------------
    OBP 3.11.1 1997/12/03 15:44
    
    NOTE: The system will be rebooted (reset) after the firmware has been updated.
    
    Do you wish to update the firmware in the system Flash PROM? yes/no :yes
    
    The NVRAM variable 'use-nvramrc?' was 'true'. This program will reset it to the default value 'false'. This is being done because the contents of the NVRAM variable 'nvramrc' may or may not be appropriate for use with the new firmware. Do not change the value of 'use-nvramrc?' until you evaluate the contents of 'nvramrc'.

  7. Next, the update script asks you if you want to continue. Type yes. Also, if any of the NVRAM configuration variables have been customized, the update displays both the default value and the current value.


    Are you sure that you wish to continue? yes/no :yes
    
    **IMPORTANT**  If the power fails during the firmware update that is about to take place, it is possible that the customized values in the NVRAM configuration variables will revert back to their *default values* once the system power is restored. *If* this event occurs then it could have a significant effect on the behavior of the system after power is restored. Following is a list of the system's NVRAM configuration variables which have default values and have been customized. You may wish to write this information down so that the values may be restored after recovery from a power loss.
    
    Name: sbus-probe-list
    Default: 01
    Current: 10
    Name: nvramrc
    Default: <null>
    Current: ." This is a sample message which indicates that nvramrc has been modified." cr

  8. The update script asks you again if you want to continue. Type yes. If the default value of any variable changed from the old revision to the new revision and you have a customized value, the update script lists the old default value, the customized value, and the new default value. If you did not print the contents of NVRAM with the eeprom utility at the beginning of the flash update process, then you may want to write down your customized value. Note that the new firmware default value will replace the customized value and the old default value.


    Are you sure that you wish to continue? yes/no :yes
    
    Note this change to the default value for NVRAM variable 'sbus-probe-list'
    The default value for the old firmware: '01'
    Your customized value in NVRAM:         '10'
    The default value for the new firmware: 'e01'
    The new firmware default value is replacing your custom value *and* the old default value in NVRAM. This change *will* have an effect on the system after the system has been reset.


    Note -

    After the update, you may wish to evaluate if the customized values displayed on the previous screen need to be modified.


  9. If the jumper is not set so that the flash PROM can be written to or the keyswitch is set to the locked position, you will see the following error message. To remedy the problem, make the flash PROM write-enabled.


    Couldn't determine the flash PROM component type.

    1. On the Sun Ultra 1 and Ultra 2 systems, halt the system by typing init 0 at the superuser prompt. Power off the system. Set the J2003 jumper to be write enabled (pins 2 and 3 jumpered). Then, power on the system and complete the flash PROM update process. For more details, see the section "Making the Flash PROM Write-Enabled".

    2. On the Sun Enterprise 450 system or the Sun Ultra 450 workstation, turn the keyswitch to the On or Diagnostics position then type reboot at the # prompt.

  10. At this point, the flash PROM is updated. After the update, the system reboots if the update completed successfully or unsuccessfully.


    Erasing the top half of the Flash PROM.
    Programming OBP into the top half of the Flash PROM.
    Verifying OBP in the top half of the Flash PROM.
    
    Erasing the bottom half of the Flash PROM.
    Programming OBP into the bottom half of Flash PROM.
    Verifying OBP in the bottom half of the Flash PROM.
    
    Erasing the top half of the Flash PROM.
    Programming POST into the top half of Flash PROM.
    Verifying POST in the top half of the Flash PROM.
     
    The system's Flash PROM firmware has been updated.
    
    Please wait while the system is rebooted . . . 
    The system's reboot messages are displayed.
    

  11. At this point any NVRAM configuration variable that had a customized value will be restored except use-nvramrc? and the customized values displayed in Step 1. You will see messages similar to the following:


    rebooting...
    Resetting ... 
    Restoring previous NVRAM environment settings...
    #power-cycles =       376
    security-#badlogins =  5
    nvramrc <custom nvramrc>
    OK
    Resetting ... 


    Note -

    You may see variables listed above that were not shown earlier in the process when the customized values were displayed. This is because some of the variables shown above may not have assigned default values.


  12. If you changed the write-enable jumper settings on Sun Ultra 1 or Ultra 2 systems earlier, change the jumper back to the write-protect position (see Figure 4-1, Figure 4-2, Figure 4-3, and Table 4-4.)

    1. Allow the system to boot so you can become superuser.

    2. Halt the system by typing init 0 at the superuser prompt.

    3. Power off the system.

    4. Open the system unit (refer to the installation or service manual for your system).

    5. Attach a wrist strap properly (refer to the installation or service manual for your system).

    6. Reset the J2003 write-enable/protect jumper to the write-protect position. In the write-protect position pins 1 and 2 are jumpered (see Figure 4-1, Figure 4-2, Figure 4-3, Figure 4-6, and Table 4-4). You may need to remove a plug-in card from the system before resetting the jumper if the card is covering the jumper. Pin 1 is noted by an asterisk (*).

      Figure 4-6 Moving the Write-Protect/Enable Jumper Back to the Write-Protect Position

      Graphic

    7. If you removed a plug-in card from the system before changing the jumper, replace the card now.

      Refer to the installation guide or service manual for your system for this procedure.

    8. Remove your wrist strap and replace the system access cover.

      Refer to the installation guide or service manual for your system for this procedure.

    9. Turn the power on to the system.

  13. If you have a Sun Enterprise 450 system or a Sun Ultra 450 workstation, after the flash PROM update is completed, turn the keyswitch to the Standby position, wait a few seconds, and then power on again.

    This power-cycling flushes any old firmware code out of system memory.