Microcode Level 771001801410af03.020123 for FC 5708 11/14/2018: See Document Change History for details on changes to this document. If you are experiencing difficulties viewing this readme please go to Firmware Downloads and select the Description link for FC 5708. Contents * 1.0 Overview * 2.0 Adapters Affected * 3.0 Microcode Description and Revision History * 4.0 Cautions and Important Notes * 5.0 To Determine Adapter Microcode Levels o 5.1 AIX Systems o 5.2 Linux Systems * 6.0 Install  RPM Package o   6.1 AIX RPM Package o   6.2 Linux RPM Package * 7.0 Installing the Adapter's Microcode o 7.1 Using the AIX Command-Line Method o 7.2 Using the AIX Diagnostic Service Aid Method o 7.3 Using the QLogic CLI  Method * 8.0 Verifying the Update o 8.1 Verifying the Update on AIX o 8.2 Verifying the Update on Linux * Document Change History 1.0 Overview This is the current level of microcode for the 10Gb FCoE PCIe Dual Port Adapter, Feature Code 5708. This is a multifunction adapter. Each port can support an ethernet and a fibre channel resource simultaneously. To update the microcode for the entire adapter, only one of the resources needs to be updated.  Back to Contents 2.0 Adapters Affected This microcode is for feature code 5708: PN 46K8088: CCIN 2B3B To determine the part number of the adapter on an AIX system, on the command line key in one of the following two commands: lscfg -vl fcsX where fcsX represents the adapter Affected adapters will be listed as 10Gb FCoE PCI Express Dual Port Adapter or lscfg -vl entX where entX represents the adapter Affected adapters will be listed as 10Gb Ethernet-SR PCI Express Dual Port Adapter To determine the presence of an FCoE adapter on a Linux system, on the command line key in: lspci -d 1077:8001 Affected adapters will be listed as: QLogic Corp. 10GbE Converged Network Adapter (FCoE) (rev 02) The typical time to install the microcode is 0.4 hr.  Back to Contents 3.0 Microcode Description and Revision History Microcode Level Changes 020123 Impact: Data  Severity: HIPER * Fixed adapter no longer displayed in SMS menus in P7 system * Alleviate issues related to port fail-over by delaying retry of FDISC request after ELS LS_RJT response with reason code 05h is received for ELS FDISC request. * Fix ELS LOGO request sent with SID 000000h after receiving ELS LS_RJT response with reason code 03h/0Dh for ELS FDISC request. * Fix for a potential issue during error recovery processing resulting in a possible loss of data that would not be detected if an IO is aborted after partial transfer of the FCP_RSP payload. The Firmware Levels Below Are No Longer Supported Please Update To The Latest Level At Your Earliest Convenience 020118 Fix ping issue in NIC fcode found during NIM install of Power 8 systems. 020117 Fix get link statistic. Fix Task Management IOCB type 14h completion with DMA error status. Move up to FW branch 5.10 020111 Corrected problem that could cause a Per Priority Pause storm to be transmitted when a receive DMA is stalled. Memory leak in Target mode regarding Notify Acknowledgement IOCB Fixed PERST# processing in MPI firmware. MPI Firmware needs to initialize PCI PLL upon deassertion of PERST# to get clean PCI clock. Fixed the NPIV client paths fail after cable pull and replug. Fixed a problem where I/Os issued following a completed Login/Logout IOCB PLOGI (with implicit LOGO) failed with aborted status. 020100 Added new functions for Target Mode support 010522 Short term firmware update plan for the open defects/features (Only to be installed if experiencing one of these two issues) (1) Customers who have installed 010506 code and have an Ether Channel configuration may see an MPI error logged. MSNENT_MPIFW_ERR. (2) Link is dropped when mktcpip runs 010506 THIS IS THE CURRENT MANUFACTURING RELEASE Fixes MPI hang which will cause possible disk and ethernet connection loss. Fixes EEH error caused by failed VPD validation. Fixes occasional link loss when switching from internal to external loopback in diagnostics test. This also resolves delay in I/O recovery after a link loss when adapter is connected to a Cisco fabric. 010400 Fixes an MPI hang when a legacy switch is attached to one port on the adapter. The second adapter port will potentially see software program errors. 010300 This is the level of microcode that initially shipped with the adapter when it became generally available. Back to Contents 4.0 Cautions and Important Notes * Concurrent Download The microcode installation supports concurrent download while the fcs resources and attached storage devices are available for use. HOWEVER, concurrent download is not supported for the ent resources. If the ent resources are in use, they must manually be released prior to starting the download. Failure to do so will result in a message instructing that the ent resource be freed. NOTE: It is recommended that the installation be scheduled during a maintenance window or during non-peak production periods. * NOTICE FOR AIX CUSTOMERS INSTALLING 020111 MICROCODE o AIX Requirements Prior to installing the microcode, it is required that the following AIX Service Packs be installed. * AIX 6.1 Technology Level 4 Service Pack 1 (6100-04-01-0944) or use APAR IZ62438 * AIX 5.3 Technology Level 11 Service Pack 1 (5300-11-01-0944) or use APAR IZ62437 The Service Packs can be obtained from the IBM Fix Central website located at http://www.ibm.com/eserver/support/fixes. o VIOS Requirements If the adapter is running in a partition running VIOS, it is required that VIOS 2.1.2.10 or later be installed. If VIOS is not at this level, install Fix Pack 22 prior to installing the new microcode. The Fix Pack can be obtained from the Virtual I/O Server website located at http://www14.software.ibm.com/webapp/set2/sas/f/vios/download/fixpack.html Back to Contents 5.0 To Determine Adapter Microcode Levels Before installing the microcode, it is important to determine the current microcode level of the adapter. 5.1 AIX Systems 1.  List the FCoE adapters installed in the system by typing on the command line: lsdev |grep -e fcs -e ent Note the names of all the FCoE adapters installed. FCoE adapters will be identified as either 10 Gb FCoE PCI Express Dual Port Adapter or 10 Gb Ethernet-SR PCI Express Dual Port Adapter. The adapter names will be fcsX and/or entX, where X is 0, 1, or some other number. 2.  Determine the current microcode level on the adapter by typing on the command line: lsmcode -d fcsX or lsmcode -d entX where X is the number of the adapter's port returned from the "lsdev" command above. When using lsmcode -d fcsX, a screen similar to the following will be displayed: DISPLAY MICROCODE LEVEL                  802111 fcs0            The current microcode level for fcs0 is 020123. Use Enter to continue. F3=Cancel             F10=Exit             Enter If the current microcode level is not 020123, then the microcode image on the adapter is not at the latest level. When using lsmcode -d entX, a screen similar to the following will be displayed: DISPLAY MICROCODE LEVEL                  802111 ent0            The current microcode level for ent0 is 020123. Use Enter to continue. F3=Cancel             F10=Exit             Enter If the current microcode level is not 020123, then the microcode image on the adapter is not at the latest level. Back to Contents 5.2 Linux Systems The following steps assume you are logged on with root permissions, QLogic CLI Management Application has been installed, and at least one 10Gb FCoE PCIeDual Port Adapter, Feature Code 5708, is installed in the system.  Linux Management Application Prerequisite: A QLogic text mode CLI Management Application is required to view and update microcode image on the adapter.  If the QLogic CLI application is already installed on your system, it should not need to be reinstalled.  To determine if CLI is installed on your system, type the following on the command line. which scli Output will display the pathname to the CLI application if it is installed on the system: /usr/local/bin/scli If the CLI application is installed, continue with section Determine Adapter Microcode Levels for Linux. The QLogic CLI Management Application can be downloaded and installed from the QLogic IBM OEM web page located at: http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/IBM.aspx?companyid=6 This is a top level page for a variety of IBM products.  Select the “Converged Network Adapters” link under “IBM Power System”.. From the table titled “IBM CNA Server Adapter Management Tools”, download and install “QLogic FCoE CLI Management Application for Linux (PPC64)”. The “Readme” file contains installation instructions.             Upon successful installation of the CLI Management Application continue with Determine Adapter Microcode Levels for Linux Determine Adapter Microcode Levels for Linux Determine the current microcode level on the adapter's port by typing on the command line: scli -i all vpd A screen similar to the following will be displayed, listing vpd data for all installed feature code 5708: PN 46K8088 adapters: -------------------------------------------------------------------------------- HBA Instance 0: QLE8142 Port 1 WWPN 21-00-00-C0-DD-10-1E-AD PortID 02-08-03 -------------------------------------------------------------------------------- Product Identifier                : 10 Gb FCoE PCI Express Dual Port Adapter Part Number                       : 46K8088 FC Code                           : 5708 Fru Number                        : 46K8088 Serial Number                     : 11S46K8088YL10NY95BTX1 Flash Image Version               : 020123 Manufacturing Id                  : RFC0916K60851 -------------------------------------------------------------------------------- HBA Instance 1: QLE8142 Port 2 WWPN 21-00-00-C0-DD-10-1E-AF PortID 02-0A-01 -------------------------------------------------------------------------------- Product Identifier                : 10 Gb FCoE PCI Express Dual Port Adapter Part Number                       : 46K8088 FC Code                           : 5708 Fru Number                        : 46K8088 Serial Number                     : 11S46K8088YL10NY95BTX1 Flash Image Version               : 020123 Manufacturing Id                  : RFC0916K60851 If Flash Image Version is not 020123 for a listed adapter, then microcode image on the adapter is not at the latest level. Back to Contents 6.0 Install RPM Package 6.1 AIX RPM Package Use this method to install the AIX RPM package on an AIX system. Note that the commands are case sensitive and must be entered exactly as shown, including file names. 1. NOTE:  - "/etc/microcode" is a symbolic link to "/usr/lib/microcode".   - If permission does not allow the copy to the above state directory or file then the user will be prompted for a new location. 2. Transfer the RPM format file, 771001801410af03.020123.aix.rpm to any temporary directory on the target system. 3. Unpack the file. On the command line type: rpm -ihv --ignoreos 771001801410af03.020123.aix.rpm 4. If the microcode package unpacks successfully, the microcode file will be added to the /etc/micrococde directory. If a message is received saying the "package is already installed", you will need to uninstall the rpm package. On the command line type: rpm -e where is the name of the package that was returned in the message. Return to step 3 and attempt to unpack the file again. 5. Verify the file size and sum of the 771001801410af03.020123 file in /etc/microcode. On the command line type: For the file size: ls -al 771001801410af03.020123 For the sum: sum 771001801410af03.020123 The ouput of these commands should be: file size: 808592 sum: 27296 Back to Contentssum 6.2 Linux RPM Package Use this method to install the Linux RPM package on a Linux system. Note that the Linux commands are case sensitive and must be entered exactly as shown, including file path names. 1. Transfer the Linux rpm file, 771001801410af03.020123.Linux.rpm, to a directory on the target system,  /tmp is used in this example.      2. Unpack the rpm file.  On the command line type :         rpm -ihv /tmp/771001801410af03.020123.Linux.rpm 3. If the microcode package unpacks successfully, the microcode file will be added to the /lib/firmware directory. If a message is displayed indicating  the "package is already installed", you will need to uninstall the rpm package. On the command line type: rpm -e where is the name of the package that was returned in the message. Return to step 2 and attempt to unpack the file again.  4. Verify the file size and sum of the 771001801410af03.020123 file in /lib/firmware directory. On the command line type: For the file size: ls -al /lib/firmware/771001801410af03.020123 For the sum: sum /lib/firmware/771001801410af03.020123 The ouput of these commands should be: file size: 808592 sum: 27296 Back to Contents 7.0 Installing the Adapter's Microcode 7.1 Using the AIX Command-Line Method Login as root user. From the command line key in: diag -d fcsX -T download or diag -d entX -T download where X is the port on which you want to install the microcode. Self-explanatory menus will step you through the microcode installation. Only one of the fcs or ent resources needs to be updated for the entire adapter to be updated.. Back to Contents 7.2 Using the AIX Diagnostic Service Aid Method Login as root user. From the command line key in:  diag Select:  Task Selection (Diagnostics, Advanced Diagnostics, Service Aids, etc.) Select:  Microcode Tasks Select:  Download Latest Available Microcode Select:  file system           /etc/microcode Select the device:  fcs* or ent* Press enter when prompted to download the microcode. Only one of the fcs or ent resources needs to be updated for the entire adapter to be updated. Upon completion, a message will state that the microcode has been successfully downloaded and that the new level is 020123. Back to Contents 7.3 Using the QLogic CLI Method The following steps assume you are logged on with root permissions, QLogic CLI Management Application has been installed, and at least one 10Gb FCoE PCIe Dual Port Adapter, Feature Code 5708, is installed in the system.  If CLI Management Application has not yet been installed, return to section Linux Management Application Prerequisite  A single command will update the microcode on all installed 10Gb FCoE PCIe Dual Port Adapters, Feature Code 5708.  On the command line type: scli -b all -rg all /lib/firmware/771001801410af03.020123 A screen similar to the following will be displayed showing the status of the microcode update process.  Do not power down the system or LPAR during microcode update process. Validating Flash Image File... FCode Version                     : 3.09 Driver Firmware Version           : 5.03.09 (8d4) Flash BIOS Version                : 2.14 Flash FCode Version               : 3.09 Flash EFI Version                 : 3.33 Flash Firmware Version            : 5.03.09 Updating Flash on HBA port(s) -  QLE8142. Please wait... Updating Adapter flash NIC Boot Code...Success Updating Adapter flash NIC MPI FW...Success Updating Adapter flash FC Boot Code/FW...Success Updating Adapter flash uncompressed FW...Success Updating Adapter flash FC VPD...Success Updating Adapter flash NIC VPD...Success Flash update complete. Changes have been saved to both ports of this HBA. Skipping flash update on HBA instance 1 - QLE8142 (Already done) Back to Contents 8.0 Verifying the Update 8.1 Verifying the Update on AIX 1.  List the fibre channel adapters installed in the system by typing on the command line: lsdev |grep -e fcs -e ent Note the names of all the FCoE adapters installed. FCoE adapters will be identified as either 10 Gb FCoE PCI Express Dual Port Adapter or 10 Gb Ethernet-SR PCI Express Dual Port Adapter. The adapter names will be fcsX and/or entX, where X is 0, 1, or some other number. 2.  Determine the current microcode level on the adapter by typing on the command line: lsmcode -d fcsX or lsmcode -f entX where X is the number of the adapter's port returned from the "lsdev" command above. When using lsmcode -d fcsX, a screen similar to the following will be displayed: DISPLAY MICROCODE LEVEL                  802111 fcs8            The current microcode level for fcs0 is 020123. Use Enter to continue. F3=Cancel             F10=Exit             Enter If the current microcode level is 020213, then the microcode has been updated.   When using lsmcode -d entX, a screen similar to the following will be displayed: DISPLAY MICROCODE LEVEL                  802111 ent8            The current microcode level for ent8 is 020123. Use Enter to continue. F3=Cancel             F10=Exit             Enter If the current microcode level is 020123, then the microcode has been updated.  Back to Contents 8.2 Verifying the Update on Linux Verify  the current microcode level on the adapter by typing on the command line: scli -i all vpd A screen similar to the following will be displayed, listing vpd data for all installed feature code 5708: PN 46K8088 adapters: -------------------------------------------------------------------------------- HBA Instance 0: QLE8142 Port 1 WWPN 21-00-00-C0-DD-10-1E-AD PortID 02-08-03 -------------------------------------------------------------------------------- Product Identifier                : 10 Gb FCoE PCI Express Dual Port Adapter Part Number                       : 46K8088 FC Code                           : 5708 Fru Number                        : 46K8088 Serial Number                     : 11S46K8088YL10NY95BTX1 Flash Image Version               : 020123 Manufacturing Id                  : RFC0916K60851 -------------------------------------------------------------------------------- HBA Instance 1: QLE8142 Port 2 WWPN 21-00-00-C0-DD-10-1E-AF PortID 02-0A-01 -------------------------------------------------------------------------------- Product Identifier                : 10 Gb FCoE PCI Express Dual Port Adapter Part Number                       : 46K8088 FC Code                           : 5708 Fru Number                        : 46K8088 Serial Number                     : 11S46K8088YL10NY95BTX1 Flash Image Version               : 020123 Manufacturing Id                  : RFC0916K60851 If Flash Image Version is 020213 for a listed adapter, then microcode image on the adapter has been updated.  Back to Contents Document Change History Date Changes 11/14/2018 Updated Microcode Description and Revision History section to reflect fixes implemented on the 771001801410af03.020123 Microcode Level. 07/08/2016 Updated Microcode Description and Revision History section to reflect fixes implemented on the 771001801410af03.020118 Microcode Level. 12/12/2013 Updated Microcode Description and Revision History section to reflect fixes implemented on the 771001801410af03.020117 Microcode Level. 08/08/2012 Updated Microcode Description and Revision History section to reflect fixes implemented on the 771001801410af03.020111 Microcode Level. 05/16/2012 Updated Microcode Description and Revision History section to reflect fixes implemented on the 771001801410af03.020100 Microcode Level. 09/09/2010 Updated Microcode Description and Revision History section to reflect fixes implemented on the 771001801410af03.010522 Microcode Level. 06/27/2011 Updated Microcode Description and Revision History section to reflect fixes implemented on the 771001801410af03.010506 Microcode Level. 11/06/2009 Initial Document Back to Contents Privacy | Legal | Contact IBM