Microcode Level 771001801410af03.020118 for FC 5708

07/08/2016: 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

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

020118

Fix ping issue in NIC fcode found during NIM install of Power 8 systems.

The Firmware Levels Below Are No Longer Supported
Please Update To The Latest Level At Your Earliest Convenience

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
    • 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.


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 020118.

Use Enter to continue.




F3=Cancel             F10=Exit             Enter

If the current microcode level is not 020118, 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 020118.

Use Enter to continue.




F3=Cancel             F10=Exit             Enter

If the current microcode level is not 020118, 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               : 020118
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               : 020118
Manufacturing Id                  : RFC0916K60851

If Flash Image Version is not 020118 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. If the /etc/microcode directory does not exist, make a directory to receive the RPM format file. On the command line type:

mkdir /etc/microcode

2. Transfer the RPM format file, 771001801410af03.020118.aix.rpm to any temporary directory on the target system.

3. Unpack the file. On the command line type:

rpm -ihv --ignoreos 771001801410af03.020118.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 <package_name> is already installed", you will need to uninstall the rpm package. On the command line type:

rpm -e <package_name>

where <package_name> 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.020118 file in /etc/microcode. On the command line type:

For the file size:

ls -al 771001801410af03.020118

For the sum:

sum 771001801410af03.020118

The ouput of these commands should be:

file size: 808528
sum: 14801

Back to Contents

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.020118.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.020118.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 <package_name> is already installed", you will need to uninstall the rpm package. On the command line type:

rpm -e <package_name>

where <package_name> 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.020118 file in /lib/firmware directory. On the command line type:

For the file size:

ls -al /lib/firmware/771001801410af03.020118

For the sum:

sum /lib/firmware/771001801410af03.020118

The ouput of these commands should be:

file size: 808528
sum: 14801

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 020118.

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.020118

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 020118.

Use Enter to continue.







F3=Cancel             F10=Exit             Enter

If the current microcode level is 020118, 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 020118.

Use Enter to continue.







F3=Cancel             F10=Exit             Enter

If the current microcode level is 020118, 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               : 020118
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               : 020118
Manufacturing Id                  : RFC0916K60851

If Flash Image Version is 020117 for a listed adapter, then microcode image on the adapter has been updated.

 Back to Contents



Document Change History

Date

Changes

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