Domain (Solaris Host) Based Firmware Update procedures for
ILOM based Service Processor Systems 

NOTE 1: Updating the Service Processor firmware requires a host (Solaris)
outage.  It is highly recommended that you review all of the prerequisites and
procedures prior to performing the task to avoid unscheduled outages.  It is
also recommended that SunMC and MASF(snmp) applications be shutdown prior to
updating the Service Processor firmware.

NOTE 2: The standard procedure assumes that Solaris is installed and running
on the system in order to do the first part of the firmware update procedure.
If Solaris is not running, you have two choices:

   a) If possible, you can install and run Solaris first, then follow the
      standard procedure.

   b) Skip to the alternate procedure in Appendix 2 (below) which details a
      method for updating the firmware that does not require Solaris to be
      running.  This method is useful when you have a hardware problem that is
      preventing Solaris from running, and you suspect that the problem may be
      firmware related, or if you wish to get the firmware upgraded before
      installing Solaris.



The ILOM based Service Processor systems have the capabilities of providing
the Service Processor installed firmware version level to the host (Solaris).
This can be accomplished by either using the Sun Update Connection GUI, the
smpatch CLI utility, or invoking sysfwdownload with the -g or -getversion
options.

The following procedure describes how to identify the installed firmware
version, determine if there is a later version available, retrieve the new
version, and complete the installation. 

PREREQUISITES

I.  The sysfwdownload utility must be available and executable on the host.
    Oracle always includes the latest sysfwdownload utility with each SunSolve
    patch for Sun System Firmware.  You are encouraged to use the version
    included in the patch by default vs older versions from prior patches or
    versions already installed on your system.

II.  Access to the documentation for "Oracle Integrated Lights Out Manager
     (ILOM) 3.0", may be required for additional setup procedures.  This information
     can be accessed from http://download.oracle.com/docs/cd/E19860-01/index.html.


PROCEDURE

Assuming all of the prerequisites have been met, the firmware update procedure
can now be executed.  The following procedure utilizes the Sun Update Connection
GUI.  If a CLI format for Service Processor firmware stack version checking is
desired, please consult man pages for smpatch.

1.  On the host (Solaris domain), maximize the Sun Update Manager Window.

2.  Select the "Available Updates" tab located in the upper right hand portion
    of the window.

3.  Review the "Synopsis" column to find entry containing "...Sun Firmware
    System Firmware Update".  This entry will be specific to your particular
    system type.
	NOTE: If there is NO entry containing the string above and all of the
	prerequisites listed above are met, the firmware stack version currently
	loaded on your Service Processor is up to date and does not require
	updating.

4.  Using the mouse, highlight the entry as described in step 3 and review the
    README file to verify the entry is appropriate for your system type.  Note 
    that this README also provides these installation instructions.

5.  Click on the entry and ensure that a check mark is illustrated in the box
    located on the left hand side.

6.  Click on the button entitled "Install Update" located on the lower left hand
    side of the window.  This action will download the newer version of the 
    Service Processor firmware stack to the host (Solaris domain) for
    continued installation. The format type of the download will be a zip format
    with a name that corresponds to the patch id (Example: 123456-01.zip).
 
	NOTE: This action ONLY downloads a newer image.  NO installation on the
	Service Processor will occur.  No changes of any kind will be made to
	the Service Processor with this action.

7.  From the root command prompt on the host (Solaris domain):
	a) # cd /var/spool/pkg
	b) # ls [patch_id].zip
	c) # mkdir /tmp/patch
	d) # chmod 777 /tmp/patch
	e) # mv ./[patch_id].zip /tmp/patch
	f) # cd /tmp/patch
	g) # /usr/bin/unzip [patch_id].zip
	h) # cd ./[patch_id]
	i) # ls *.pkg

8. The *.pkg file is the image that will need to be transferred to the Service
   Processor for update purposes.  Also note that there are various other files
   included in this directory including .txt type files for additional
   information.

9. Continue preparation of upgrading the Service Processor by downloading the
   image from the host (Solaris domain) to the Service Processor.

	a) # pwd   <- should be /tmp/patch/[patch_id]
	b) # ./sysfwdownload [image].pkg

10. Wait until the download completes successfully.  This should take less 
    than 15 minutes to complete.  The command prompt (host) will return upon
    successful completion.  The end result is the image ([image].pkg) is
    now resident on the SP (located in /coredump/[image].pkg).

11. From the host (Solaris domain) shut the system down.
	# shutdown -i0 -g0 -y

12. Establish a connection to the Service Processor via ssh or using the
    Serial Console port.

13. Log in to the Service Processor using the admin login session created for
    ALOM compatible utilities.  The procedure for creating and logging into 
    an ALOM compatible shell is listed below in Appendix 1.

14. From the Service Processor CLI, issue the poweroff command
    (this sequence will take about 60 seconds to completely power the
    server off):

          sc> poweroff
          Are you sure you want to power off the system [y/n]?  y
          sc>
          SC Alert: SC Request to Power Off Host.

          SC Alert: Host system has shut down.
          sc>

15. Make sure that your virtual keyswitch setting is not in the LOCKED position.
    You can check the setting from the Service Processor CLI with the following
    command:

        sc> showkeyswitch

    If the virtual key switch is in LOCKED position you can change that
    with the following command:

        sc> setkeyswitch -y normal

16.  Flash update the downloaded Sun System Firmware image:
   
        sc> flashupdate -s 127.0.0.1

    '127.0.0.1' is the default address for the local host.

    As the update process progresses, a series of periods appear across your
    screen.

          .......................

    When the download process is finished, ILOM displays the message:

        Update complete. Reset device to use new software.

17. The Sun System Firmware has now been updated. For the system to use
    the new firmware you must reset the Service Processor.

    Type the resetsc command to reset ILOM.

        sc> resetsc
        User Requested SC Shutdown


------------------
Appendix 1
------------------

How to Create an ALOM CMT Compatibility Shell

1. Log onto the server with username: root.
When powered on, the server boots to the ILOM login prompt. The factory default
password is changeme.

SUNSPxxxxxxxxxxxx login: root
Password:
Waiting for daemons to initialize...
Daemons ready
Oracle Integrated Lights Out Manager
Version 3.0.0.0
Copyright (c) 2010, Oracle and/or its affiliates.  All rights reserved.
Use is subject to license terms.
Warning: password is set to factory default.

2. Create a user named admin, set the admin account role to Administrator
and the CLI mode to alom

-> create /SP/users/admin
Creating user...
Enter new password: ********
Enter new password again: ********
Created /SP/users/admin

-> set /SP/users/admin role=Administrator
Set 'role' to 'Administrator'
-> set /SP/users/admin cli_mode=alom
Set 'cli_mode' to 'alom'

Note - The asterisks in the example will not appear when you enter your
       password.


You could also combine the create and set commands on a single line:

-> create /SP/users/admin role=Administrator cli_mode=alom
Creating user...
Enter new password: ********
Enter new password again: ********
Created /SP/users/admin

3. Log off the root account after you have finished creating the admin account.

-> exit

4. Log into the ALOM CLI shell (indicated by the -> prompt) from the ILOM
login prompt.

SUNSPxxxxxxxxxxxx login: admin
Password:
Waiting for daemons to initialize...
Daemons ready
Oracle Integrated Lights Out Manager
Version 3.0.0.0
Copyright (c) 2010, Oracle and/or its affiliates.  All rights reserved.
Use is subject to license terms.

sc>

------------------
Appendix 2
------------------

How to update Sun System Firmware without Solaris, using ILOM or ALOM CLI.

The Sun System Firmware update process enables you to install new firmware for
both the host and Service Processor.  You can use the default ILOM CLI syntax,
or optionally, the ALOM CLI command syntax. For ALOM CLI, you must first follow
the instructions in Appendix 1, "How to Create an ALOM CMT Compatibility Shell"

This Appendix includes the following sections:

    * Firmware Update Process

    * ILOM Firmware Update Overview

          o View ILOM Version Information Using the CLI

          o Update ILOM Firmware Using the CLI

          o Reset ILOM SP


Firmware Update Process
-----------------------

Review this caution and these guidelines when updating the firmware.

CAUTION - Shut down your host operating system before proceeding. ILOM attempts 
to shut down the OS gracefully. If a graceful shutdown is not possible, ILOM 
forces a shutdown, which could cause filesystem corruption.

    * The firmware update process takes less than ten minutes to complete.
      During this time, no other tasks should be performed in ILOM.

    * A network failure during the firmware file upload results in a time-out. 
      This causes ILOM to reboot with the currently installed version of 
      firmware.


ILOM Firmware Update Overview
-----------------------------

1. Download the new firmware image.

2. Copy the image to a TFTP server for a CLI update.

3. Log in as any user with Administrator privileges.

4. Update the firmware on the service processor (SP) using the CLI.

5. When the firmware update is complete, the system automatically reboots.


To View ILOM Version Information Using the CLI

1. Log in to the Secure Shell as any user with Administrator privileges.

2. Type the following to view current system firmware version info:

-> show /HOST
(ILOM CLI)

or 

sc> showhost
(ALOM CLI)

The following information appears:

SP firmware #.#.#.#
SP firmware build number: #####
SP firmware date: Fri Apr 27 14:03:21 EDT 2007
SP filesystem version: #.#.## 

Update ILOM Firmware Using the CLI (Command Line Interface)

1. Log in as any user with Administrator privileges.

2. Type the following command to download the new ILOM firmware image:

-> load -source tftpURL
(ILOM CLI)

or

sc>flashupdate -s IPaddr -f pathname
(ALOM CLI)

For example:

-> load -source tftp://xxx.xxx.xxx.xxx/filename.pkg
(ILOM CLI)

or

sc> flashupdate -s xxx.xxx.xxx.xxx -f /filename.pkg
(ALOM CLI)
 
NOTE: A firmware upgrade will cause the server and ILOM to 
      be reset. It is recommended that a clean shutdown of
      the server be done prior to the upgrade procedure.
      An upgrade takes less than 10 minutes to complete. ILOM
      will enter a special mode to load new firmware. No
      other tasks can be performed in ILOM until the
      firmware upgrade is complete and ILOM is reset.
 
Are you sure you want to load the specified file (y/n)? y
Do you want to preserve the configuration (y/n)? y
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preserving configuration. Please wait.
Done preserving configuration.
 
 
Firmware update is complete.
ILOM will now be restarted with the new firmware. 


