========================================================

Upgrading the Controller Firmware for HP-UX and IBM AIX (3.xx to 4.15): 

--------------------------------------------------------
 
For HP-UX and IBM AIX hosts, it is necessary to upgrade your RAID
controller firmware as described below, since the upgrade script
supplied for Linux, Windows, and Solaris operating systems cannot
be used on these platforms. Do not attempt to upgrade Linux,
Windows, and Solaris hosts with this procedure.

===========================

Invoking Sun StorEdge CLI:

---------------------------

Version 2.3 or greater of the "sccli" CLI utility is required. It is included
in the SUNWsscs package, which may be downloaded from the Sun Download Center
or installed from the optional Sun StorEdge Professional Storage Manager CD.

For software installation or upgrading instructions, refer to the "Sun
StorEdge 3000 Family Software Installation Guide." Click the link for your
array on the Sun Documentation Centers Storage web page at:

sun.com/products-n-solutions/hardware/docs/Network_Storage_Solutions/

Select the most recent version of software and then download the Software
Installation Guide.

The firmware procedures require the user to invoke Sun StorEdge CLI (sccli)
using the appropriate syntax for the type of connection used to manage the 
array.

If the array to be upgraded is a RAID subsystem attached to a Fibre Channel
HBA installed in the local host, type the sccli command with no arguments:

        sccli

If more than one array is connected to local Fibre Channel, sccli will
display a list from which the appropriate device may be selected.

If the array has an IP address configured, it may be managed remotely using
a network (or "out-of-band") connection.  To specify this mode, type:

        sccli [-w <password>] <hostname | ip>

where <password> is the password assigned to the controller, and 
<hostname | ip> is the hostname or IP address of the array.  Use single 
quote characters to quote the password if it contains any characters that 
are interpreted specially by the shell.  If no controller password is set, 
the -w option and password argument should be omitted.

To verify the version of "sccli" you are running type the following command
at the sccli> prompt:

       version
  
===============================================

Prerequisites for Manually Upgrading Controller Firmware

-----------------------------------------------

When upgrading from 3.xx to 4.15, you must have a serial connection to 
restore settings during the controller firmware upgrade. Use a null
modem serial cable to connect the COM port of the RAID array to the
serial port on a host workstation. Set the serial port parameters on the
workstation to 38,400 baud, 8 bit, 1 stop bit, no parity. 

Before installing controller firmware version 4.15, make sure your 
environment can support the prerequisites for installing the new 
firmware including:
 
 * Version 2.3 or greater SUNWsscs software package minimum requirement
  
        If you do not have this package installed, or if you have an earlier 
        version, see the "Invoking Sun StorEdge CLI" section in this document
        for more information.

 * The firmware manual upgrade will reset all settings to the 4.15 firmware
   defaults. Using a .txt file, you will have to manually restore your
   controller configuration settings including any of the following:
    
    *   controller-name 

    *   controller-id 

    *   logical drive controller assignment (Primary/Secondary) 

    *   host-wwn-name

    *   cache-parameters: write-back, write-through, random, 
        sequential 

    *   disk-array: normal-verify, rebuild-verify, init-verify, 
        rebuild-priority 

    *   drive-parameters: spin-up, disk-access-delay, 
        scsi-io-timeout, queue-depth, polling-interval, 
        enclosure-polling-interval, auto-detect-swap-interval, 
        smart, auto-global-spare 

    *   host-parameters: queue-depth, max-luns-per-id, 
        fibre-connection-mode

    *   channels - This option restores the channel type, 
        (disk or host), and target IDs. 

    *   maps - This option restores the LUN mappings. 

    *   Network settings - IP address, net mask, and gateway settings

    *   Host LUN filter settings - type, access mode, and name

    *   Sector/head/cylinder settings 

    *   Channel data rate

    *   Non-default RCCOM settings


 * Ethernet connections are required for out-of-band firmware upgrades if
   the array to be upgraded is not connected to the host from which the
   upgrades are to be performed.

 * A Fibre Channel connection to the array is required for in-band
   firmware upgrades when no network connection to the array is available.

 * You must stop all I/O to the array before beginning the controller 
   firmware upgrade.

 * Unmount any filesystems or volumes mounted on the array.  

 * If your configuration has more than 32 partitions per logical drive, 
   you must back up the data on the affected logical drives, reconfigure
   the partitions per logical drive to 32 or less, redistribute the data
   across the logical drives, and then upgrade the firmware.

 * You must currently be running controller firmware version 3.27R or
   later 3.xx firmware and SES version 1046 or later SES firmware. If
   you do not have these firmware versions installed, download patch
   113723-09 from SunSolve online and install the appropriate firmware
   it contains before proceeding with upgrading RAID controller firmware
   3.xx to 4.15.

 * Unpack the patch into any convenient directory (for example, /var/tmp).

 * Back up all data. To ensure that the existing array is restored using
   the currently configured settings, back up all data and configuration
   parameters so you can reference them after the upgrade.

=========================================

Before Manually Upgrading Controller Firmware:

-----------------------------------------

If you are using controller firmware version 4.15, then no firmware 
upgrade is necessary and you should skip to "SES Firmware Upgrade" section
in the README document contained in this patch.

 1. Change your working directory to the directory in which the patch
    was unpacked and confirm that the SUN415F-3510.bin file is present.

 2. Verify that you are running version 2.3 or greater of sccli. Type
    the following command at the sccli> prompt:

        version

 3. Verify the product and revision of the array. Type the following
    command at the sccli> prompt:

        show inquiry

    and examine the output. If the "Product" is "StorEdge 3510F D"
    and "Device Type: Enclosure" appears, the device is a JBOD chassis;
    skip to "SES Firmware Upgrade" section in the README document contained
    in this patch.

    If the Product is not "StorEdge 3510," this patch does not apply.  
    Select a different device or discontinue installation of this patch.

    If the firmware version reported is 415F, the RAID controller firmware 
    does not need to be upgraded; skip to "SES Firmware Upgrade" section in
    the README document contained in this patch.


 4. Save the array configuration settings in .txt format. This file will be
    referred to later to restore the configuration settings.  

    Type the following command at the sccli> prompt:

        show configuration <filename.txt>
     
    This command may take several minutes to complete.  

    -----
    Note:
    -----
    Configuration setting output files are not transferable. You cannot 
    save a configuration for a specific 3510 device and use it to perform the
    script upgrade on another 3510 device. 

 5. Use the RAID controller firmware menu interface to view
    sector/head/cylinder settings by choosing "view and edit Configuration
    parameters > Host-side Parameters > Host Cylinder/Head/Sector Mapping
    Configuration" from the Main Menu. Record these settings.

    Choose "view and edit Host luns" from the Main Menu to view Host LUN
    filter settings. Record these settings. Also, for easier reference
    during the upgrade, record the Host LUN settings.

    Choose "view and edit channels" from the Main Menu to record RCCOM
    settings. Record these settings. Also, for easier reference during
    the upgrade, record the channel ID settings.

    Use the RAID controller firmware menu interface to view the IP address,
    netmask, and gateway by choosing "view and edit Configuration
    parameters > communication Parameters > Internet Protocol (TCP/IP)"
    from the Main Menu. For easier reference during the upgrade, record
    these settings.

    --------
    Caution:
    --------
    After the script resets nvram, the only way to recover these settings is
    re-entering them after the upgrade is complete. 

 6. Verify single or dual controller.  Type the following command at the
     sccli> prompt:

        show redundancy

    The dual-controller array is healthy if the Redundancy mode is 
    "Active-Active" AND the status is "Enabled." The single-controller 
    array is healthy if the Redundancy mode is "Active-Active" AND the 
    status is "Scanning." If this is not the case, correct the problem
    before proceeding.

========================================================

Performing the Manual Controller Firmware Upgrade: 

--------------------------------------------------------

----
Note:
----
Perform the following steps, only after you've completed the "Prerequisites
for Manually Upgrading Controller Firmware" and "Before Upgrading
Controller Firmware from Version 3.xx to 4.15" sections.

If you will be upgrading more than one array, note the time it takes to
upgrade the first array so you can schedule the amount of time needed to
upgrade your other arrays.

-------
Caution:
-------
The following procedure is used for a 3.xx to 4.15 upgrade only. If you
are currently running 4.xx firmware, skip to section "Upgrading
Controller Firmware 4.xx to 4.15" section in the README document contained
in this patch.



 1. Stop all I/O activity and unmount any filesystems or volumes mounted by
    a volume manager from the array.

 2. Stop any Sun StorEdge Configuration Service (SSCS) agent that may be
    running on a host connected to the array controller. 

        To stop the SSCS agent, issue the shell command as "root" user.

             /etc/init.d/ssagent stop
    
        If the SSCS agent is running on a Microsoft Windows system
        connected to the array, use the Services application
        (Start->Run-> services.msc) to stop the SSCS Agent service.
 
 3. StorADE, or any other application that monitors the status of the
    enclosure, may also interfere with controller or SES firmware downloads.
    Stop the StorADE agent software, or any other software that monitors
    the array, following the procedures described in the documentation for
    that application.

 4. Set up a serial connection to the controller. Refer to the section
    "Prerequisites for Manually Upgrading Controller Firmware" for
    more information.

    --------
    Warning:
    --------
    Do not restore saved 3.xx NVRAM from disk or any image file
    of 3.xx configuration on a 4.1x controller. This may cause data loss
    or data corruption.

    --------
    Caution:
    --------
    The download controller-firmware command does not support a
    live upgrade (a hot download operation). The -r option in the
    following step must be used to prevent firmware download failure.
 
    Perform the firmware upgrade by typing the following command at
    the sccli> prompt:
        
        download controller-firmware --reset-nvram -r SUN415F-3510.bin

    The sccli command will display the following messages:

     sccli: Downloading controller firmware...programming flash memory...done
     sccli: Resetting controller...done

     The reset nvram command restores the original default settings,
     including all controller parameters, host, and drive parameters etc. 
     This command does not restore the controller IP address, instead it 
     configures the network for DHCP. You may also lose LUN mappings on host 
     channels.
     You may need to have a serial connection to the controller avaiable in
     order to be able to restore the previous configuration.

     sccli: reset nvram to factory defaults: succeeded
     sccli: resetting controller...
     sccli: controller has been reset

    Wait until the sccli> prompt appears again, which may take 10 minutes or
    more, before proceeding.

 5. To re-establish communication with the array, use the serial 
    connection to restore the IP address, netmask, and gateway recorded
    in step 5 of "Before Upgrading Controller Firmware from Version 3.xx
    to 4.15". If you are using in-band communication, restore channel
    settings (ID), LUN mapping.

    Use the RAID controller firmware menu interface to restore the IP address,
    netmask, and gateway by choosing "view and edit Configuration
    parameters > communication Parameters > Internet Protocol (TCP/IP)"
    from the Main Menu. 

    Choose "view and edit channels" from the Main Menu to restore channel
    settings (ID).
    
    Choose "view and edit Host luns" from the Main Menu to restore Host
    LUN mappings. 

 6. Verify that the firmware upgrade succeeded by examining the firmware
    revision again. Type the following command at the sccli> prompt:

         show inquiry

    and verify that the firmware revision is now reported as 415F.

 7. Save the current array configuration settings in .txt format with the
    name "after.txt". Use this to compare and verify settings with the .txt
    file created in step 4 of "Before Manually Upgrading Controller Firmware"
    
    Type the following command at the sccli> prompt:

        show configuration after.txt
     
    This command may take several minutes to complete.

    The manual upgrade procedure requires extensive configuration because all
    4.15 factory defaults have been restored. Refer to the <filename>.txt file
    and other recorded settings from steps 4 and 5 of "Before Manually
    Upgrading Controller Firmware" to restore settings that were reset. 

    
8. The controller firmware upgrade is now complete. skip to "SES Firmware
   Upgrade" section in the README document contained in this patch to complete
   the remainder of the upgrade procedures.
