Document fins/I0553-1


FIN #: I0553-1

SYNOPSIS: The F/W download procedure documented in A3x00 Controller Replacement
          Guide may render the controller un-usable.

DATE: Feb/04/00

KEYWORDS: The F/W download procedure documented in A3x00 Controller Replacement
          Guide may render the controller un-usable.


---------------------------------------------------------------------
- Sun Proprietary/Confidential: Internal Use Only -
---------------------------------------------------------------------  
                            FIELD INFORMATION NOTICE
                  (For Authorized Distribution by SunService)



SYNOPSIS: The F/W download procedure documented in A3x00 Controller 
          Replacement Guide may render the controller un-usable. 
           
           
TOP FIN/FCO REPORT: No 
 
PRODUCT_REFERENCE:  A3x00 Controller firmware 
 
PRODUCT CATEGORY:   Storage / Documentation; Software / Unbundled 

PRODUCTS AFFECTED:  
  
Mkt_ID   Platform   Model      Description              Serial Number
------   --------   -----      -----------              -------------
Systems Affected
----------------

  -      ANYSYS       -        System Platform Independent    -
   
X-Options Affected
------------------
X6532A               -     -   A3000 15*4.2GB/7200 FWSCSI     - 
X6533A               -     -   A3000 35*4.2GB/7200 FWSCSI     -     
X6534A               -     -   A3000 15*9.1GB/7200 FWSCSI     -    
X6535A               -     -   A3000 35*9.1GB/7200 FWSCSI     -
X6536A               -     -   A3000 StorEdge Controller      -
X6537A		     -     -   A3500 SCSI controller          -
X6538A               -     -   A3500FC StorEdge Controller    -
SG-XARY350A-90G      -     -   A3500 1x5x9GB/7200, min        -    
SG-XARY350A-545G     -     -   A3500 1x5x9GB/7200, max        -    
SG-XARY351A-180G     -     -   A3500 1x5x18GB/7200, min       -
SG-XARY352A-180G     -     -   A3500 2x7x9GB/7200, min        -
SG-XARY352A-763G     -     -   A3500 2x7x9GB/7200, max        -
SG-XARY353A-360G     -     -   A3500 2x7x18GB/7200, min       -
SG-XARY354A-1635G    -     -   A3500 3x15x9GB/7200, max       - 
SG-XARY360A-90G      -     -   A3500 1x5x9GB/10K, min (BSD)   - 
SG-XARY360A-545G     -     -   A3500 1x5x9GB/10K, max         -
SG-XARY362A-180G     -     -   A3500 2x7x9GB/10K, min (BSD)   -
SG-XARY362A-763G     -     -   A3500 2x7x9GB/10K, max         -
SG-XARY364A-1635G    -     -   A3500 3x15x9GB/10K, max        -
SG-XARY374A-273G     -     -   A3500 3x15x9GB/10K, min (BSD)  - 
SG-XARY380A-182G     -     -   A3500 1x5x18GB/10K, min (BSD)  -
SG-XARY380A-1092G    -     -   A3500 1x5x18GB/10K, max        -
SG-XARY382A-364G     -     -   A3500 2x7x18GB/10K, min (BSD)  -
SG-XARY384A-546G     -     -   A3500 3x15x18GB/10, min (BSD)  -
SG-XARY381A-364G     -     -   A3500 1x5x36GB/10K, min (BSD)  -
SG-XARY381A-1456G    -     -   A3500 1x5x36GB/10K, Max        -
SG-XARY383A-728G     -     -   A3500 2x7x36GB/10K, min (BSD)  -
SG-XARY385A-1092G    -     -   A3500 3x15x36/10K, min (BSD)   -


PART NUMBERS AFFECTED: 

Part Number   Description            Model
-----------   -----------            -----
     -             -                   -


REFERENCES:

BugId:  4278577
ESC:    522816
MANUAL: 805-7854-11 A3x00 Controller Replacement Guide
        805-6887-10 Sun StorEdge RAID Manager 6.2 User's Guide
        805-6888-10 Raid Mgr Install&Support Guide for Windows NT
URL:    http://thedance.ebay/software/manage/raidmgr/rm_6.2.html

       
PROBLEM DESCRIPTION: 

The firmware download procedure documented in the A3x00 Controller
Replacement Guide pn 805-7854-11 is incomplete and misses some critical
instructions.  If the FW downgrade procedure in the document is
strictly followed, the controller will fail to become ready.
Consequently Our Enterprise Services Logistics Organizations have seen
a large number of A3x00 controller returned defective.

This incorrectly documented procedure impacts the 540-3600-04 (A3000,
RSM 2000 FRU) and 540-3083-03 (A3500 FRU).  The A3x00 Controller
Replacement Guide shows the Raid Manager GUI F/W downgrade procedure
which would download Bootware first instead Appdware and result in the
controller failing to become ready from sysReboot after +the Bootware
download.

The following warning messages can be seen on the system console when 
the controller mode is switched either from Active to Passive OR from 
Passive to Active.  These messages are expected because the rdac driver 
is re-routing the I/Os.

      Jan  5 12:40:23 sonoma34 unix: WARNING: /sbus@e,0/QLGC,isp@2, 
           10000/sd@4,3 (sd346):
      Jan  5 12:40:23 sonoma34 unix:  Error for Command: write                 
 
           Error Level: Fatal
      Jan  5 12:40:23 sonoma34 unix:  Requested Block: 175611                  
 
           Error Block: 175611
      Jan  5 12:40:23 sonoma34 unix:  Vendor: Symbios                          
 
           Serial Number:    B    8p  
      Jan  5 12:40:23 sonoma34 unix:  Sense Key: Illegal Request
      Jan  5 12:40:23 sonoma34 unix:  ASC: 0x94 (<vendor unique code
0x94>), 
           ASCQ: 0x1, FRU: 0x0
      Jan  5 12:40:23 sonoma34 unix: WARNING: Errored I/O, with errno 5, 
           returned to the Array driver on Module 3, LUN 3
      Jan  5 12:40:23 sonoma34 unix: 
      Jan  5 12:40:23 sonoma34 unix: The errored I/O is a write at sector: 
           175611
      Jan  5 12:40:23 sonoma34 unix: The errored I/O is being routed to the 
           Resolution daemon
      Jan  5 12:40:25 sonoma34 unix: The Array Resolution Daemon is resuming 
           I/Os on Module 3, LUN 3
      Jan  5 12:40:25 sonoma34 unix: <Symbios-StorEDGEA3000-0205 cyl 98 
           alt 2 hd 64 sec 64>
      Jan  5 12:40:25 sonoma34 unix: The Array driver/daemon has recovered   
           an Errored I/O on Module 3, Lun 3, sector 175611

This documentation error will be corrected in the next release of the
A3x00 Controller Replacement Guide pn 805-7854-12 which is expected to 
be released around May, 2000. 
 
IMPLEMENTATION: 
 
         ---
        |   |   MANDATORY (Fully Pro-Active)
         ---    
         
  
         ---
        |   |   CONTROLLED PRO-ACTIVE (per Sun Geo Plan) 
         --- 
         
                                
         ---
        | x |   REACTIVE (As Required)
         ---
         

CORRECTIVE ACTION: 

Enterprise Customers and authorized Field Service Representatives may
avoid the above mentioned documentation problem by following the 
recommendations as shown below:

After a controller replacement, follow the procedure shown below to
download the firmware to the universal controller FRU.

General Guideline:

     Use command line "fwutil" to download F/W. 
     For F/W down grade, you need to load appdware first then bootware. 
     For F/W up grade, you need to load bootware first then appdware. 

The universal FRU is factory loaded with Appdware 2.5.6.32 and bootware
2.5.6.32 as of today.  The F/W downgrade procedure for each Raid
Manager release is listed below.  These procedures must be followed as
directed for F/W downgrade to work.  Depending on the Raid Manager 
Software manual, Appdware and Bootware version, the appropriate procedure 
should be followed.

In order to determine the current Raid Manager Software version, follow the 
steps as shown below:

1. From the command line,  type RM6 to display the Raid Manager GUI.
2. Click the icon called 'About' to reveal the current RM6 Software
   version.

In order to obtain current Appdware & Bootware version, follow the steps 
as shown below:

1. Click on the Configuration Icon from the RM6 GUI to open up the 
   configuration window.
2. Click on Module Profile Button from the configuration window which will 
   display 3 different options: Controller, Drive, LUNs.
3. Select and click on the Controller Icon to reveal current Appdware and 
   Bootware version.

After obtaining this information, proceed with the appropriate procedure 
as shown below.

Procedure for RM6.0, 02.04.1d apd/02.04.01 bwd
==============================================

This release supports StorEdge A3000.

Note: Network Storage no longer supports RM6.0.  This download procedure
      is provided for reference only.  If any problems were discovered in 
      the universal FRU download to this level, it will not be fixed. 
      Customer will need to upgrade to at least RM6.1 to work around it. 

Follow the RM6 Recovery GURU procedure to replace the failed controller.

Caution: When the new controller is brought up on-line, Recovery GURU
         will warn you that the firmware versions on the two controllers
         do not match and will prompt you to upgrade the F/W. Select
"OK" 
         to begin the firmware upgrade procedure. Then the firmware upgrade 
         GUI window comes up, you must select "Cancel" to terminate F/W

         upgrade in this window. If you proceed with the GUI firmware down- 
         load, your new controller will become un-usable.   
         
After canceling the firmware upgrade, a message window will appear to 
notify that the firmware download failed: "The controller has been 
replaced but the firmware download was canceled or did not succeed.
Switching to active/active mode is not recommended until the firmware 
has been downloaded."  

Click the "OK" button. The new controller will be placed in Passive
mode.

Next, use the command line procedure to down grade F/W on the new controller.

Note: a. 02040401.apd and 02040400.bwd are not bundled with RM6.0.  Therefore,
         it is necessary to copy these F/W files from a system that has RM6.1 
         installed. RM6 F/W files are in /usr/lib/osa/fw directory.

      b. For Raid Manager 6.0 only, the command path is /usr/sbin/osa. 
         Specify this path when issue Raid Manager 6.0 commands or set up 
         the search path in .profile. 
 
1) Download Appware 02040401.apd (intermediate step) to the universal 
   controller FRU:
	# fwutil /usr/lib/osa/fw/02040401.apd cxtxdxs0

2) Download Appware ap02041D.dl to the universal controller FRU:
	# fwutil /usr/lib/osa/fw/ap02041D.dl cxtxdxs0

3) Download bootware 02040400.bwd (intermediate step) to the universal 
   controller FRU: # fwutil /usr/lib/osa/fw/02040400.bwd cxtxdxs0

4) Download bootware bw020401.dl to the universal controller FRU:
	# fwutil /usr/lib/osa/fw/bw020401.dl cxtxdxs0

5) Set controller mode to Active/Active and balance LUNs:
        # rdacutil -m 2 -b "module name"

		OR
     
Procedure for RM6.1, 02.04.04.01 apd/02.04.04.00 bwd
====================================================

This release supports StorEdge A3000.

Follow the RM6 Recovery GURU procedure to replace the failed controller.

Caution: When the new controller is brought up on-line, Recovery GURU
         will warn you that the firmware versions on the two controllers
         do not match and will prompt you to upgrade the FW. Select
"OK" 
         to begin the firmware upgrade procedure. Then the firmware upgrade 
         GUI window comes up, you must select "Cancel" to terminate F/W
         upgrade in this window. If you proceed with the GUI firmware down 
         load, your new controller will become un-usable.   
         
After canceling the firmware upgrade, a message window will appear to 
tell you that the firmware down load failed: "The controller has been 
replaced but the the firmware download was canceled or did not succeed.
Switching to active/active mode is not recommended until the firmware has
been down loaded."

Click the "OK" button. The new controller will be placed in Passive
mode.

Now use the command line procedure to down grade FW on universal FRU.

Note: Set up the search path in .profile or Specify /usr/lib/osa to 
      issue Raid Manager commands. 

1) Download Appware 02040401.apd to the universal controller FRU:
	# fwutil /usr/lib/osa/fw/02040401.apd cxtxdxs0

2) Download bootware 02040400.bwd to the universal controller FRU:
	# fwutil /usr/lib/osa/fw/02040400.bwd cxtxdxs0

3) Set controller mode to Active/Active and balance LUNs:
        # rdacutil -m 2 -b "module name"
		

		OR

Procedure for RM6.1.1, 02.05.02.09 apd/2.5.1.00 bwd 
===================================================

This release supports StorEdge A3000.

Follow the RM6 Recovery GURU procedure to replace the failed controller.

Caution: You will not be warned of F/W mismatch in this Raid Manager
         release when bringing the universal FRU on-line. You still need
         to down grade the F/W to match with the native controller F/W.

Now use the command line procedure to down grade F/W on universal FRU.

Note: Set up the search path in .profile or Specify /usr/lib/osa to 
      issue Raid Manager commands.

1) Place the new controller in "Passive" mode for firmware download.
	# rdacutil -m 1 "module name"  
           i)  When this command is used for the first time, Controller-B 
               will be placed in Passive Mode.
           ii) When this command is used for the second time, controller-A 
               will become Passive Mode, and, controller B becomes 
               Active Mode.
					
2) First: Update Appware for the universal controller FRU:
	# fwutil /usr/lib/osa/fw/02050209.apd cxtxdxs0

3) Second: Update Bootware for the universal controller FRU:
	# fwutil /usr/lib/osa/fw/02050100.bwd cxtxdxs0 

4) Set controller mode to Active/Active and balance LUNs:
        # rdacutil -m 2 -b "module name" 


		OR

Procedure for RM6.1.1 update 1, 02.05.02.11 apd /02.05.01.00 bwd and
RM6.1.1 update 2, 02.05.02.32 apd /02.05.06.32 bwd
====================================================================

These two releases support StorEdge A3000 and StorEdge A3500.

Update 1 patch release:
	02.05.02.14 apd/02.05.01.00 bwd (patch 106513/02)
	02.05.02.15 apd/02.05.01.00 bwd (patch 106707)
	02.05.02.32 apd/02.05.06.32 bwd (patch 106513, 106707) 

Follow the RM6 Recovery GURU procedure to replace the failed controller.

Caution: You will not be warned of F/W mismatch in this Raid Manager
         release when bringing the universal FRU on-line. You still need
         to down grade the F/W to match with the native controller F/W.

Now use the command line procedure to down grade F/W on universal FRU.
Select the appropriate FW in the /usr/lib/osa/fw directory for your
controller to match with the native controller and the Raid Manager 
release:

Below is an RM6.1.1 update 1 command line example:

Note: Set up the search path in .profile or Specify /usr/lib/osa to 
      issue Raid Manager commands. 

1) Place the new controller in "Passive" mode for firmware down load:  
	# rdacutil -m 1 "module name"
           i)  When this command is used for the first time, Controller-B 
               will be placed in Passive Mode.
           ii) When this command is used for the second time, controller-A 
               will become Passive Mode, and, controller B becomes 
               Active Mode.

2) Update Appware for the universal controller FRU:
	# fwutil /usr/lib/osa/fw/02050211.apd cxtxdxs0

3) Update Bootware for the universal controller FRU: 
      Note: This step is not needed if the system is running RM6.1.1 update 2,
      because your native controller should have 02.05.06.32 bwd. 
      
	# fwutil /usr/lib/osa/fw/02050100.bwd cxtxdxs0     

4) Set controller mode to Active/Active and balance LUNs:
        # rdacutil -m 2 -b "module name" 


COMMENTS:     

--------------------------------------------------------------------------
Implementation Footnote:

i)   In case of MANDATORY FINs, Enterprise Services will attempt to    
     contact all affected customers to recommend implementation of 
     the FIN. 
   
ii)  For CONTROLLED PROACTIVE FINs, Enterprise Services mission critical    
     support teams will recommend implementation of the FIN  (to their  
     respective accounts), at the convenience of the customer. 

iii) For REACTIVE FINs, Enterprise Services will implement the FIN as the   
     need arises.
----------------------------------------------------------------------------
All released FINs and FCOs can be accessed using your favorite network 
browser as follows:
 
SunWeb Access:
-------------- 
* Access the top level URL of http://sdpsweb.ebay/FIN_FCO/

* From there, select the appropriate link to query or browse the FIN and
  FCO Homepage collections.
 
SunSolve Online Access:
-----------------------
* Access the SunSolve Online URL at http://sunsolve.Corp/

* From there, select the appropriate link to browse the FIN or FCO index.

Supporting Documents:
---------------------
* Supporting documents for FIN/FCOs can be found on Edist.  Edist can be 
  accessed internally at the following URL: http://edist.corp/.
  
* From there, follow the hyperlink path of "Enterprise Services Documenta- 
  tion" and click on "FIN & FCO attachments", then choose the
appropriate   
  folder, FIN or FCO.  This will display supporting directories/files for 
  FINs or FCOs.
   
Internet Access:
----------------
* Access the top level URL of https://infoserver.Sun.COM
--------------------------------------------------------------------------
General:
--------
* Send questions or comments to finfco-manager@Sun.COM
---------------------------------------------------------------------------



Copyright (c) 1997-2003 Sun Microsystems, Inc.