Patch-ID# 116424-01
Keywords: jnic1560 pci single dual 2gbit fc network adapter
Synopsis: Hardware/Fcode: JNI PCI Single + Dual 2Gbit FC Network Host Adapter
Date: Mar/05/2004


Install Requirements: See Special Install Instructions                      
                      
Solaris Release: 8 9

SunOS Release: 5.8 5.9

Unbundled Product: Hardware/Fcode/JNIC1560

Unbundled Release: 1.1

Xref: 

Topic: 

Relevant Architectures: sparc

BugId's fixed with this patch: 4984636

Changes incorporated in this version: 4984636

Patches accumulated and obsoleted by this patch: 

Patches which conflict with this patch: 

Patches required with this patch: 
NOTE:   Solaris 8       114877-02 or higher (jfca driver patch)
        Solaris 9       114878-02 or higher (jfca driver patch)

Obsoleted by: 

Files included with this patch: 

README.116424-01
jnimodhba
patchinfo
seeprom-upgrade

Problem Description:

BugId 4984636 Can't flash-upgrade JNI1560 Amber2J SG-XPCI1FC-JF2 375-3156
 
Although Bud #4984636 is filed against the single channel Amber-2J card, this
problem affects the dual channel cards (Crystal-2J SG-XPCI2FC-JF2) as well.
The problem is caused by incorrect Subsystem-id written into the Serial EEPROM
of the host adapter by the supplier. This EEPROM is not rewritten once the
host adapter is shipped to the field. Due to the high number of boards shipped
with this incorrect Subsystem-id, we are providing this patch as a one time
only fix for this particular problem. This patch will update the SEEPROM to
contain the correct Subsystem-id to allow subsequent Fcode upgrades.
 
**************************************************************************
**************************************************************************
**WARNING:****WARNING:****WARNING:****WARNING:****WARNING:****WARNING:**
 
1. Use the command:
   prtpicl -v -c scsi |grep subsystem-id
   to check for boards with incorrect subsystem-ids.
   Incorrect ids are: 0x6562, or 0x656a.
 
2. The new Subsystem-id will not take effect until the system is rebooted
   or power-cycled.   
 
3. This patch will recognize JNI1560 based single and dual Fibre Channel PCI 
   HBAs. It will upgrade the Subsystem-ids each board type with the 
   appropriate subsystem-ids.
 
4. Loss of power during this SEEPROM upgrade can result in premature
   termination of the patch.   An incomplete SEEPROM might not be
   able to interface with OBP during boot.  In this event, it will be
   necessary to replace the HBA.
 
5. During the update session, the screen will display messages regarding
   the fibre channel link getting initialized, or the link speed being
   negotiated, please ignore these messages, but pay attention to the most 
   recent system prompt before the display of such messages. 
 
   In the example below:
   =========================================================================
   # prtpicl -v -c scsi |grep subsystem-d
  :subsystem-id  0x6562 
  :subsystem-id  0x6562 
  :subsystem-id  0x6562 
  :subsystem-id  0x6562 
 
   # ./seeprom-upgrade
 
   jnimodhba: Changing settings on all HBA ports...
 
   jnimodhba: Settings changed on all HBA ports...
 
   HBA Model        WWN Id WWN               Topo   Speed Device
   === ============ ====== ================= ====== ===== ====================================
   #1  FCX2-6562-L  035950 10000001 73008C6E Auto   Auto  /pci@9,700000/SUNW,jfca@3:devctl
   #2  FCX2-6562-L  035950 10000001 73808C6E Auto   Auto  /pci@9,700000/SUNW,jfca@3,1:devctl
   #3  FCX2-6562-L  034823 10000001 73008807 Auto   Auto  /pci@9,600000/SUNW,jfca@1:devctl
   #4  FCX2-6562-L  034823 10000001 73808807 Auto   Auto  /pci@9,600000/SUNW,jfca@1,1:devctl
 
   =========================================================================    
 
   The "prtpicl ..." command discovered 4 instances of the JNIC1560 device that has the
   incorrect subsystem-id.
 
   The seeprom-upgrade utility upgraded all the JNIC1560 devices to the correct model. 
   A subsequent reboot and prtpicl query will show the correct subsystem-ids.
 
   # prtpicl -v -c scsi |grep subsystem-d
  :subsystem-id  0x656b 
  :subsystem-id  0x656b 
  :subsystem-id  0x656b 
  :subsystem-id  0x656b 
   #
 
   Note: It is OK to upgrade the already good JNIC1560 devices if they happen to
   be installed. The SEEPROM settings will not be changed by this utility as a result.
 
 **************************************************************************
 **************************************************************************

Patch Installation Instructions:
--------------------------------
 
 1. General guidelines for upgrading:
 
    It is best to perform the upgrade with no I/O activities going through
    the JNI host adapters.
 
 
 2. Procedure:
 
 The procedure to be used for upgrading the HBA subsystem-id is explained
 below. Typical upgrade time is about 30 seconds total.
 
 a) Type "prtpicl -v -c scsi |grep subsystem-id" to locate any JNI boards with
    incorrect subsystem-ids.
 
 b) Copy the patch into any directory, say <patchdir>.
    (Note, if the patch ends in a ".zip" suffix, you will need to first
    unzip` it.)  So, you would type:
         % su root
         # cd <patchdir>
         # unzip <patch zip file>
 
 c) Type "reboot -- -s" to reboot in single-user mode.
 
 
 d) In the patch directory (116424-01), as root, type the "seeprom-upgrade"
    command:
         # ./seeprom-upgrade
    Wait for command to complete.
 
 e) Type "reboot -- -r" to reboot the system then verify the subsystem-id 
    with "prtpicl -v -c scsi |grep subsystem-id".
 
 
 **************************************************************************
 **************************************************************************
 EXAMPLE : See example in item (5) of Problem Description section above.

Special Install Instructions:
----------------------
 
 None

README -- Last modified date:  Friday, March 5, 2004