Microcode Installation Instruction - FC 5714, 1987 IBM 1 Gigabit-SX iSCSI TOE PCI-X Adapter Level 2.0.0.57

Feature codes applied:

• Feature code 1987 P/N 30R5519 Fiber interface
• Feature code 5714 P/N 03N6058 Fiber interface

Contents

1. Overview

   This is the Current level of firmware for The IBM 1 Gigabit iSCSI TOE PCI-X Adapter
   
   

2. Systems Affected

   The current firmware for FC 1987, and 5714. All adapters should have this level of firmware. The typical time to install the microcode is 0.4 hr.
   
   

3. Firmware Description and Revision History

   This firmware update contains the following features and fixes:
   

   Firmware Level	Description of Changes
   2.0.0.57	Fix adapter hang issue Fix cmd time-out errors due to slow failover
   2.0.0.29	Updated level to support storage failover
   2.0.0.19	GA level

   
   

4. Cautions and Important Notes

   It is recommended firmware upgrades be performed during a scheduled maintenance window and that the system be re-booted following firmware download.
   
   

5. For AIX Operating System

   1. Determining Current Firmware Level

      Before you install the microcode, it is important to determine the FRU Number and Microcode level of the adapter installed in the target system. Use the following instructions to read the FRU number stored in the adapter's non-volatile memory.

      List the iSCSI TOE adapters installed in the system by typing:

      lsdev -C | grep "ics"

      Note the device names of all the IBM 1 Gigabit iSCSI TOE PCI-X Adapters installed. The adapter device names will be icsX, where X is 0,1, or some other number.

      There are two methods to check the current microcode level on the adapter.

      1. The first uses the " lscfg " command and it will return much of the information in the adapter VPD. The field ROM Level.(alterable) will have the firmware level. This method will also display the FRU part number and Assembly part number.
         

         lscfg -vl icsX

         
         Where X is the number of the adapter returned by the previous lsdev command.
         The Command will produce output similar to
         

         lscfg -vl ics0

         
         

         DEVICE LOCATION DESCRIPTION IBM 1 Gigabit - SX iSCSI TOE PCI-X adapter: Part Number.................03N6058 EC Level....................H13951 Manufacture ID..............52P7175 FRU Number..................03N6058 Customer Card ID Number.....573C Network Address.............00C0DD03F3E2 ROM Level.(alterable).......000002000029 Product Specific.(Z1).......iqn.2000-04.com.qlogic:qla4050c.fs20525b03207.1 Device Specific.(YL)........U787A.001.DPM1G90-P1-C6-T2

         
         
         
      2. The second method uses the "lsmcode"command and it will return the extension of the firmware image file that installed.method
         

         lsmcode -d icsX

         
         Where X is the number of the adapter returned from the "lsdev" command above.
         

         DISPLAY MICROCODE LEVEL                    802111 ics0 iSCSI Adapter The current microcode level for ics0 is 000002000029. Use Enter to continue. F3=Cancel F10=Exit Enter

         
         
      If the firmware level in the "ROM Level" field is not 000002000057, then the microcode should upgraded.
      
      

   2. Downloading and Unpacking the Firmware Update Package

      AIX commands are CASE (lower and upper) SENSITIVE, and must be entered exactly as shown, including filenames.
      
      1. Download the RPM format file to the /tmp directory or any other directory of your choice (using "Save as ...").
         You'll see the filename is 1410cf02-2-0057.aix.noarch.rpm
         Please verify file size and checksum as follows:
         

         ls -l 1410cf02-2-0057.aix.noarch.rpm

         verify file size is 257511
         

         sum 1410cf02-2-0057.aix.noarch.rpm

         verify file sum is 20896
         
         
      2. Unpack the file by executing the instructions below:
         Enter the commands:
         

         rpm -ihv --ignoreos 1410cf02-2-0057.aix.noarch.rpm

         
         The microcode file 1410cf02.000002000057 will be added to /etc/microcode
         
         If step 2 returns with: " package package_name is already installed", You will need to un-install the rpm package as follows:
         

         rpm -e package_name

         
         Where "package_name" is the package name returned in the failure of step 2.
         Redo step 2 above to unpack the firmware.
         
         The following step is needed only if you have feature codes 1986/1987
         

         ln -s /etc/microcode/1410cf02.000002000057 /etc/microcode/1410e202.000002000057

         
         

   3. Flashing the firmware in the adapter

      You are now ready to flash the EEPROM in the adapter using the single command:
      

      diag -d icsX -T download

      Where X is the number found from the "lsdev -C | grep ics " command.
      Self-explanatory menus will step you through the microcode installation.
      Repeat this step for all the cards that need the update.
      
      To Back level the firmware
      

      diag -d icsX -T "download -f -l previous"

      
      
      

6. For LINUX Operating System

   You will need to install the utility SanSurfer from Qlogic. The utility is included in the device driver CD. There are two types of interface GUI and CLI. Instructions given below are for CLI interface. If you use GUI interface, follow the same concept as the one in CLI.

   1. Determining Current Firmware Level

      Before you install the microcode, it is important to determine the FRU Number and Microcode level of the adapter installed in the target system. Use the following instructions to read the FRU number stored in the adapter's non-volatile memory. List the iSCSI TOE adapters installed in the system by typing:

      iscli

      Select option 3. List All QLogic iSCSI HBAs detected.
      Make note the number of HBA present
      Get back to Menu
      Select opetion 5. HBA Information
      Notice the Firmware Version field (i.e. 2.0.0.29)
      The example above show the firmware level in the card is 2.0.0.29. If the package does not contain 2.0.0.57, then the adapter should be updated.

   2. Downloading and Unpacking the Firmware Update Package

      Linux commands are CASE (lower and upper) SENSITIVE, and must be entered exactly as shown, including filenames.
      
      1. Download the RPM format file to the /tmp directory or any other directory of your choice (using "Save as ...").
         You'll see the filename is 1410cf02-2-0057.Linux.noarch.rpm
         Please verify file size and checksum as follows:
         

         ls -l 1410cf02-2-0057.Linux.noarch.rpm

         verify file size is 257495
         

         sum 1410cf02-2-0057.Linux.noarchrpm

         verify file sum is 26381
         
         
      2. Unpack the file by executing the instructions below:
         Enter the commands:
         

         rpm -ihv --ignoreos 1410cf02-2-0057.Linux.noarchrpm

         
         The microcode file 1410cf02.000002000057 will be added to /lib/firmware
         
         If step 2 returns with: " package package_name is already installed", You will need to un-install the rpm package as follows:
         

         rpm -e package_name

         
         Where "package_name" is the package name returned in the failure of step 2.
         Redo step 2 above to unpack the firmware.
         
         

   3. Flashing the firmware in the adapter

      You are now ready to flash the EEPROM in the adapter using the single command:
      

      iscli

      Select option 4. HBA Options Menu
      Select option 5. Set Working Adapter to select the intended adapter
      Select option 2. HBA Firmware Settings Menu
      Select option 5. Update Firmware Image
      Enter firmware name (full path) when asked
      The filename starts with 1410cf02
      
      Repeat this procedure for all the cards that need the update.
      
      Use the step "I. Determining Firmware Level" above to verify installation.