Microcode Revision Level df1000fa.191105 (1.91a5) With FCode level 1.50a4 for F/C 5716, 1977, 1957 *2/15/2010**: See Document Change History <#Document_Change_History> for details on changes to this document.* Contents * 1.0 Overview <#ov> * 2.0 Systems Affected <#2.0_Systems_Affected> * 3.0 Firmware Description and Revision History <#3.0_Firmware_Description_and_Revision_H> * 4.0 Cautions and Important Notes <#4.0_Cautions_and_Important_Notes> * 5.0 To Determine Adapter Microcode Levels <#5.0_To_Determine_Adapter_Microcode_Leve> * 6.0 Downloading and Unpacking the Firmware Update Package <#6.0_Downloading_and_Unpacking_the_Firmw> * 7.0 Updating the Adapter's Microcode <#7.0_Update_the_Adapter's_Microcode> * 7.1 Using the AIX Command-Line Method <#7.1_Using_the_AIX_Command-Line_Method> * 7.2 Using the Update Flash Diagnostic Service Aid Method <#7.2_Using_the_Down_Load__Microcode_Diag> * 7.3 Using the Linux lputil Method <#7.3_Using_the_Linux_lputil_Method> * 7.4 Verifying the Update <#7.3_Verifying_the_Update> * 8.0 Machine Record <#8.0_Machine_Record> * Document Change History <#Document_Change_History> 1.0 Overview This is the Current level of firmware for The IBM pSeries 2 Gigabit Fiber Channel PCI-X Adapter FC 5716, 1977, 1957. Back to Contents <#Contents> ------------------------------------------------------------------------ *2.0 Systems Affected* This level of firmware is for : o FC 5716, PN: 80P4543, 03N6441, 03N7069, 10N8622 o FC 1977, PN: 80P6101, 80P6455, 03N6439, 03N7067, 10N8623 o FC 1957, PN: 03N4698, 03N6440, 03N7068, 10N8624 The typical time to install the microcode is 0.4 hr. Back to Contents <#Contents> ------------------------------------------------------------------------ *3.0 Firmware Description and Revision History* This firmware update contains the following features and fixes: Firmware Level Changes 1.91a5 * Fix problem with BB credit for ACC of FLOGI *The Firmware Levels Below Are No Longer Supported* *By IBM Once They Have Been Removed From The Microcode Down Load Website.* It is best practices to update to the latest FW level not only for IBM support of these products, but for optimal performance and to ensure that all of the required HW/FW fixes are installed. Once new FW has been released to the field, we will provide a 6 month grace period for customers to update these products to the currently supported FW level * Please Update To The Latest Level At Your Earliest Convenience* 1.90X13 * Fix problem with Tape sequence recovery algorithm 1.90A4 GA level Back to Contents <#Contents> ------------------------------------------------------------------------ *4.0 Cautions and Important Notes* · Concurrent Download It is recommended firmware upgrades be performed during a scheduled maintenance window and that the system be re-booted following firmware download. * *Machine type 7039-651* Machine type 7039-651 must be at system firmware level 3J030521 or higher. If the system firmware level is less than 3J930521 you can damage the fibre channel adapter if you attempt to upload the fibre channel adapter firmware. To determine machine type, enter the following command: * lscfg -pl sysplanar0 | grep Model | awk ' {print $2}'* If machine type is "IBM,7039-651", check the system firmware level by entering the following command: * lsmcode -rt system* *NOTE: *firmware level RJ030206 is a lower level than 3J030521. To compare firmware levels, compare the trailing 6 characters. For firmware levels RJ030206 and 3J030521, you compare the trailing 6 characters: 030206 is less than 030521 Back to Contents <#Contents> ------------------------------------------------------------------------ 5.0 To Determine Adapter Microcode Levels 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. 1) List the Fiber Channel PCI adapters installed in the system by typing: *lsdev** -C | grep "fcs"* Note the device names of all the Gigabit Fiber Channel PCI Adapters installed. The adapter device names will be fcsX, where X is 0,1, or some other number. 2) There are two methods to check the current microcode level on the adapter. * The first uses the " lscfg " command and it will return much of the information in the adapter VPD. The Z9 field will have the firmware level. This method will also display the FRU part number and Assembly part number. *lscfg** -vl fcsX* Where X is the number of the adapter returned by the previous lsdev command. The Command will produce output similar to DEVICE LOCATION DESCRIPTION fcs1 P1-C1-T1 FC Adapter *Part Number.................80P4543* EC Level....................A Serial Number...............1A31600450 Manufacturer................001A Feature Code................280B *FRU Number.................. 80P4544* Device Specific.(ZM)........3 Network Address.............10000000C9332A79 ROS Level and ID............02881914 Device Specific.(Z0)........1001206D Device Specific.(Z1)........00000000 Device Specific.(Z2)........00000000 Device Specific.(Z3)........03000909 Device Specific.(Z4)........FF801315 Device Specific.(Z5)........02881914 Device Specific.(Z6)........06831914 Device Specific.(Z7)........07831914 Device Specific.(Z8)........20000000C940F419 *Device Specific.(Z9)........TS1.90x13* Device Specific.(ZA)........T1D1.90x13 Device Specific.(ZB)........T2D1.90x13 Device Specific.(YL)........U7879.001.DQD0JHD-P1-C1-T1 If the firmware level in the "Z9" field is less the 1.91a5, then the microcode should upgraded. * The second method uses the "lsmcode"command and it will return the extension of the firmware image file that installed.method *lsmcode** -d fcsX * Where X is the number of the adapter returned from the "lsdev" command above. DISPLAY MICROCODE LEVEL 802111 fcs3 FC Adapter The current microcode level for fcs3 is 1903013. Use Enter to continue. F3=Cancel F10=Exit Enter 191105 is the extension of the firmware image (df1000fa.191105) that was last loaded on the adapter. If the extensions is less than 191105, then the firmware should be upgraded. Back to Contents <#Contents> ------------------------------------------------------------------------ *6.0 Downloading and Unpacking the Firmware Update Package* * Description (Instruction document) * AIX RPM format (For downloading to an AIX system) * Linux RPM format (For downloading to a Linux system). You will want a copy of the description and one of the above formats. You may transfer the files to the target system in one of the following ways: * Download the AIX RPM format File to a AIX system * Download the Linux RPM format File to a Linux system.. Detailed download /unpacking instruction follow for each format. *6.1 AIX RPM Package* *Downloading RPM Format File to Target Server* Use this method to download to an AIX system: Note: The instructions that follow are specific AIX commands. AIX commands are CASE (lower and upper) SENSITIVE, and must be entered exactly as shown, including filenames. 1. Make a directory on an AIX system to receive the RPM format file. Enter: *mkdir** /etc/microcode* 2. From the download website, follow the website instructions to download the package. If your initial download is not to the target system, you can use ftp to move the file(s) to the target system.. You'll see the filename is pci.df1000fa-1-91A5.aix.noarch.rpm 3. Unpack the file by executing the instructions below: Enter the commands: *rpm -ihv --ignoreos pci.df1000fa-1-91A5.aix.noarch.rpm* 4. If the firmware unpacks successfully, the microcode files will be added to /etc/microcode/ 5. The file size and checksum will be verified on the unpacked firmware image, NOT the RPM file. File size: 664748 Checksum: 48915 If step 3 returns with: " package package_name is already installed" You will need to uninstall the rpm package as follows: *rpm** -e /package_name/* Where "*/packag_name/**/" /*is the package name returned in the failure of step three. Now go to step 3 above to unpack the firmware. *6.2 Linux RPM Package* *Downloading Linux RPM Format File to a Linux Server* Use this method to download to an Linux system: Note: The instructions that follow are specific AIX commands. AIX commands are CASE (lower and upper) SENSITIVE, and must be entered exactly as shown, including filenames. 1. Make a directory on an AIX system to receive the RPM format file. Enter: 2. From the download website, follow the website instructions to download the package. If your initial download is not to the target system, you can use ftp to move the file(s) to the target system.. You'll see the filename is pci.df1000fa-1-91a5.linux.noarch.rpm 3. Unpack the file by executing the instructions below: Enter the commands: *rpm -ihv --ignoreos pci.df1000fa-1-91A5.Linux.noarch.rpm* 4. If the firmware unpacks successfully, the microcode files will be added to /etc/microcode/ 5.The file size and checksum will be verified on the firmware image, NOT the RPM file. File size: 664748 Checksum: 48915 If step 3 returns with: " package package_name is already installed" You will need to unistall the rpm package as follows: *rpm** -e /package_name/* Where "*/packag_name/**/" /*is the package name returned in the failure of step three. Now go to step 3 above to unpack the firmware. Back to Contents <#Contents> ------------------------------------------------------------------------ *7.0 Update the Adapter's Microcode* The Diagnostic Microcode Download software supports the following naming convention for the microcode binary file : * df1000fa.191105 * where 191105 is the version of the file. Back to Contents <#Contents> ------------------------------------------------------------------------ *7.1 Using the AIX Command-Line Method* You are now ready to FLASH the EEPROM in the adapter using the single command: *diag** -d fcsX -T download* Where X is the number found from the "lsdev -C | grep fcs " command. Self-explanatory menus will step you through the microcode installation. Repeat each step in 7.1 above for all the cards that need the update. To Back level the firmware *diag** -d fcsX -T "download -f -l previous"* Back to Contents <#Contents> ------------------------------------------------------------------------ *7.2 Using the Download Microcode Diagnostic Service Aid Method* From the command line login, log in as root. Enter *diag* Select * Task Selection (Diagnostics, Advanced Diagnostics, Service Aids, etc.)* Select * Download Microcode* Select the device returned for above *fcs**** Press enter when prompted to download the microcode Upon completion, a message will state that the firmware has be successfully downloaded and that the new level is 191105. Exit. *7.3 Using the Linux **lputil** Metho**d* To update the Fiber Channel PCI adapter microcode on installed adapters in a Linux system the Emulex lputil flash program must be used. This program is included in an Application Kit availble only from the IBM OEM web pages on the Emulex web site. Some versions of Linux will also require an Application Helper Module also available from the IBM OEM web pages on the Emulex web site. In some cases, the IBM OEM web page may list an updated driver for the Linux version installed on the target server. The updated Driver Kit includes both an updated driver and the corresponding Application Helper Module. You should consider installing the updated Driver Kit along with the Application Helper Module. To begin, open the IBM OEM web page by entering http://www.emulex.com/ibm/support/index.jsp in an Internet browser. Follow links on the page to the LP9802 IBM Branded Fiber Channel PCI adapter page. This page will contain a list of supported drivers for this adapter. Scroll down to the "Drivers for Linux" or the "Previous Releases" section. Find the entry in the table which corresponds to the Linux driver version currently installed on the target server as determined in section 5.2 above. Download the Application Kit or Driver Kit and, if needed, the Application Helper Module to a temporary directory on the target server. Follow the installation instructions provided on the IBM OEM web page to install the downloaded packages. Once both the Application Helper Module Kit or Driver Kit and the Application Kit have been installed on the target, updating the microcode can proceed as follows. 1. Begin by confirming proper installation of Application Kit and Application Helper Module. Verify lputil command is present, type *ls** /usr/sbin/lpfc/lputil* Output should list file path for *lputil* command. Verify Driver Module (lpfc of lpfcdd) is loaded, type *lsmod* Examine output for presence of *lpfc* or *lpfcdd* in loaded module list. If not present, type *modprobe** lpfc* or *modprobe** lpfcdd*, examine console messages for error reported. Verify Helper Module (lpfcdfc) is loaded, type* lsmod* Examine output for presence of *lpfcdfc* in list. If not present, type *modprobe** lpfcdfc*, examine console messages for error reported. If any of the verification checks fail, review the installation documentation and insure all steps were completed, look for any errors reported during installation. If problems cannot be resolved, contact IBM service support. 2. Since firmware update will reset the Fiber Channel adapters, you should unmount any storage devices controlled by the adapter being updated before proceeding. Caution: Do not interrupt this process, shutdown the system or remove power until the firmware update process is complete. 3. Start the utility by typing: */usr/sbin/lpfc/lputil* 4. From the Main menu, enter *3*, *Firmware Maintenance* 5. If more than one HBA is installed, select the HBA to be updated. 6. Enter *1, Load Firmware Image* 7. Enter the full path to the firmware file, */lib/firmware/pci.00dffa00.191105*, press enter. 8. Wait for message indicating update process is complete. 9. Enter *0* twice to exit the utility, the new firmware has been flashed to the adapter. If you are updating the firmware on a dual-channel HBA, repeat steps 3 through 8 to update the firmware on the second port. Back to Contents <#Contents> ------------------------------------------------------------------------ *7.4 Verifying the Update on AIX* 1 List the Fiber Channel PCI adapters installed in the system by typing: * lsdev -C | grep "fcs"* Note the device names of all the Gigabit Fiber Channel PCI Adapters installed. The adapter device names will be fcsX, where X is 0,1, or some other number. 2 There two methods to check the current microcode level for the adapter. * The first method uses the "lsmcode" command *lsmcode** -d fcsX * Where X is the number of the adapter returned from the "lsdev" command above. DISPLAY MICROCODE LEVEL 802111 fcs3 FC Adapter The current microcode level for fcs3 is 191105. Use Enter to continue. F3=Cancel F10=Exit Enter If current microcode level is 191105, then the firmware has been upgraded. * The second method uses the "lscfg" command * lscfg -vl fcsX* Where X is the number of the adapter returned by the previous lsdev command. The Command will produce output similar to DEVICE LOCATION DESCRIPTION fcs1 P1-I1/Q1 FC Adapter Part Number.................80P4543 EC Level....................A Serial Number...............1E313BB001 Manufacturer................001E FRU Number.................. 80P4544 Device Specific.(ZM)........3 Network Address.............10000000C93AF096 ROS Level and ID............02881914 Device Specific.(Z0)........1001206D Device Specific.(Z1)........00000000 Device Specific.(Z2)........00000000 Device Specific.(Z3)........03000909 Device Specific.(Z4)........FF801314 Device Specific.(Z5)........02881913 Device Specific.(Z6)........06831913 Device Specific.(Z7)........07831913 Device Specific.(Z8)........20000000C93AF096 Device Specific.(Z9)........TS*1.91A5* Device Specific.(ZA)........T1D1.91A5 Device Specific.(ZB)........T2D1.91A5 Device Specific.(YL)........P1-I1/Q1 If the firmware level in the "Z9" filed is 1.91a5, then the firmware has been upgraded *7.5 Verifying the Update on Linux* On Linux systems one of two possible methods must be used to determine the current level of Microcode on installed adapters. If the first method does not display the Microcode level, the second method should display the Microcode level for installed adapters. Both methods assume you are logged in as root and one or more Fiber Channel PCI adapters are installed. * The first method generally works on systems running Linux 2.4 kernels and some systems running 2.6 kernels which do not have full support for the /sys filesystem. 1. List Fiber Channel PCI adapter information for all installed adapters by typing: *cat** /proc/scsi/lpfc/** Output will display various information for each installed Fiber Channel PCI adapter. Make note of Firmware Version: Firmware Version: 1.91 (H2D*1.91a5*) * The second method works on systems running Linux 2.6 and higher kernels which support the /sys file system. 1. Determine which host numbers are assigned to installed Fiber Channel PCI adapters by typing: *cd** /sys/class/scsi_host* *find . -name "lpfc_drvr_version" -print* Output will list relative path names for each installed Fiber Channel PCI adapter. Note the host{n} portion of each path. ./*host2*/lpfc_drvr_version ./*host1*/lpfc_drvr_version 2. Display Firmware version for each installed Fiber Channel PCI adapter by typing: *cat** host{n}/fwrev* Where host{n} is one from step 1. Firmware version will display as follows: 1.91 (H2D*1.91a5*) If the firmware level in displayed using either method is 1.91a5, then the firmware has been upgraded Back to Contents <#Contents> ------------------------------------------------------------------------ *8.0 Machine Record* Back to Contents <#Contents> ------------------------------------------------------------------------ *Document Change History* 2/15/2010 Added part numbers to FC5716, 1977, 1957 in section 2.0 Added Firmware support message to Firmware Description and Revision History table in section 3.0 9/25/2006 Initial Document Back to Contents <#Contents> Privacy | Legal | Contact IBM