Microcode Installation Instruction - IBM 1 Gigabit iSCSI TOE PCI-X Adapter

Feature codes applied:

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 1986, 1987, 5713, 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.19 GA level
    2.0.0.29 Updated level to support storage failover

  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 - TX iSCSI TOE PCI-X adapter:
        Part Number.................03N6056
        EC Level....................H13951
        Manufacture ID..............52P7175
        FRU Number..................03N6056
        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 less the 000002000029, 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 pci.10774022-2-2.29.aix.rpm
        Please verify file size and checksum as follows:
        ls -l pci.10774022-2-2.29.aix.rpm
        verify file size is 505765
        sum pci.10774022-2-2.29.aix.rpm
        verify file sum is 31153

      2. Unpack the file by executing the instructions below:
        Enter the commands:
        rpm -ihv --ignoreos pci.10774022-2-2.29.aix.rpm

        The microcode files 1410cf02.000002000029 and 1410d002.000002000029 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 steps are needed only if you have feature codes 1986/1987
        ln -s /etc/microcode/1410cf02.000002000029 /etc/microcode/14102203.000002000029
        ln -s /etc/microcode/1410d002.000002000029 /etc/microcode/1410e202.000002000029

    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.29. If the package contains a newer version, 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 pci.10774022-2-2.29.Linux.rpm
        Please verify file size and checksum as follows:
        ls -l pci.10774022-2-2.29.Linux.rpm
        verify file size is 505758
        sum pci.10774022-2-2.29.Linux.rpm
        verify file sum is 09410

      2. Unpack the file by executing the instructions below:
        Enter the commands:
        rpm -ihv --ignoreos pci.10774022-2-2.29.Linux.rpm

        The microcode files 1410cf02.000002000029 and 1410d002.000002000029 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
      For the copper interface, the filename starts with 1410d002
      For the fibre interface, 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.