Microcode Level df1000fe-0002.27315 (2.71x15) with FCode Level 1.50x1 for FC 5774, 5276

1/15/2013: See Document Change History for details on changes to this document.

Contents

1.0 Overview

This is the current level of microcode for the IBM 4 Gigabit PCI Express Dual Port Fibre Channel Adapter, Feature Code 5774,5276.

 Back to Contents


2.0 Adapters Affected

This microcode is for featue code 5774,5276:   PN 10N7255:   CCIN 5774

To determine the part number of fibre channel adapters on an AIX system, on the command line key in:

lscfg -vl fcsX
where fcsX represents the adapter

The typical time to install the microcode is .4 hr.

 Back to Contents


3.0 Microcode Description and Revision History

 

Microcode Level

Changes

271315
(2.71x15)
with
FCode Level 1.50x1

 

  • Fixes a false parity error that intermittently occurs in a SAN environment with tape drives. With the 271102 (2.71a2) level of firmware, AIX would post SRN 2603-706 and the adapter would be taken offline. If the adapter has this current level of firmware installed and SRN 2603-706 occurs, take the corrective action specified by the SRN.
  • Enhances the FCode by adding a "set-post-linkup" command. Refer to the Important Notes in Section 4.0 for details.

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


271308
(2.71x8)
with
FCode Level 1.50x1


Fixes a false parity error that intermittently occurs in a SAN environment with tape drives. Prior to this level of firmware, AIX would post SRN 2603-706 and the adapter would be taken offline. If the adapter has this level of firmware or later, and SRN 2603-706 occurs, take the corrective action specified by the SRN.

This firmware level had a limited distribution and is commonly referred to as "the iFix".


271102
(2.71a2)
with
FCode Level 1.50x1


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 adapter and attached storage devices are available for use. HOWEVER, it is recommended that installation be scheduled during a maintenance window or during non-peak production periods.

  • Enhancement to FCode

The FCode has been enhanced by adding a "set-post-linkup" command. By default, link up and initialization on the adapater occurs after the Power On Self Test (POST). The new command will allow customers to switch to bringing the link up and initializing it during POST by turning the support on. Once turned on, it will remain on until the command is run again to turn it off. Customers who would like to utilize this function should contact the IBM Support Center for instructions.

·         Notice for AIX and VIOS customers installing microcode

AIX APARs

Prior to installing the microcode, the following APARs are required to be installed. Failure to do so may result in LPAR hang while installing microcode.

 

To determine AIX level, run command:  oslevel –s

To determine fileset levels, run command:  lspp -hac | grep devices.pci.df1000f7.com

·         IZ89104 for AIX 7.1  (Shipped in devices.pci.df1000f7.com 7.1.0.15)

·         IZ88330 for AIX 6.1, TL7   (Shipped in devices.pci.df1000f7.com 6.1.7.0)

·         IZ82960 for AIX for AIX 6.1, TL6   (Shipped in  devices.pci.df1000f7.com 6.1.6.15)

·         IZ82911 for AIX for AIX 5.3, TL12   (Shipped in  devices.pci.df1000f7.com 5.3.12.3)

·         IZ81003 for AIX for AIX 5.3, TL11  (Shipped in devices.pci.df1000f7.com 5.3.11.6)

·         IZ80939 for AIX for AIX 5.3, TL10  (Shipped in  devices.pci.df1000f7.com 5.3.10.5)

VIOS Requirements

These are the equivalent items to install for VIOS prior to installing microcode.

To determine VIOS levels, run command from VIOS partition (assumes you are logged into padmin shell):  ioslevel

·         VIOS 2.2.1.0 or Fixpack 25

·         VIOS 2.2.0.12-FP-24 SP-02

The Fix Pack can be obtained from the Virtual I/O Server website located at https://www14.software.ibm.com/webapp/set2/sas/f/vios/download/home.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 fibre channel adapters installed in the system by typing on the command line:

lsdev -C | grep fcsX

Note the names of all the fibre channel adapters installed. The adapter names will be fcsX, where X is 0, 1, or some other number. There will be an fcsX listing for each port of the FC 5774 or 5276 adapter.

2.  Determine the current microcode level on the adapter's port by typing on the command line:

lsmcode -d fcsX
where X is the number of the adapter's port returned from the "lsdev" command above.

A screen similar to the following will be displayed:

DISPLAY MICROCODE LEVEL                  802111
fcs8           FC Adapter

The current microcode level for fcs8 is 271308.

Use Enter to continue.







F3=Cancel             F10=Exit             Enter

If the current microcode level is not 271315, then the microcode image on the adapter's port is not at the latest level.

Back to Contents

5.2 Linux Systems

The following steps are for Linux Red Hat or Novell (SuSE) systems running 2.6 kernels which support the /sys filesystem. These steps assume you are logged on with root permissions and one or more IBM 4 Gigabit PCI Express Dual Port Fibre Channel Adapters, FC 5774,5276, are installed.

1. Display the model name for each installed fibre channel adapter.
Note: The adapter will display as two instances of model LPe11002; one for each port of the adapter.
Type the following commands to display a list showing the model for each installed adapter:

cd /sys/class/scsi_host
find -L host* -maxdepth 1 -name "modelname" -printf %h: -exec cat {} \;

The output will be similar to that shown here:

host1: LPe11002
host2: LPe11002

These values are needed for the next step. If the list is empty, either there are no LPe11002 adapters installed or there was an error in typing the command. If the list contains other adapters but no LPe11002 adapter is listed, none are installed.

2. Display the firmware version for each LPe11002 adapter. Type the following command replacing hostN for each LPe11002 port listed in step 1.

cat hostN/fwrev

The microcode level listed may vary but output will be similar to that shown here:

2.71A2 (Z3L2.71A2), sli-3

Repeat this command for each LPe11002 hostN adapter. Any adapter port that does not list a microcode version of 2.71x15 needs to be updated.

3. Display the Emulex fibre channel adapter driver version. Type the following command:

modinfo -F version lpfc

The driver versions may vary but the output will be similar to that shown here:

0:8.2.0.48.2p

Only the portion following the colon is important. Make a note of the driver version as it will be needed later.

4. Display the Linux Operating System version.

For Red Hat type the following command:

cat /etc/redhat-release

The output will be similar to that shown here:

Red Hat Enterprise Linux Server release 5.3 (Tikanga) eClipz 2009601

For Novell type the following command:

cat /etc/SuSE-release

The output will be similar to that shown here:

SUSE Linux Enterprise Server 11 (ppc64)
VERSION = 11
PATCHLEVEL = 0

Back to Contents


6.0 Downloading and Unpacking the Microcode RPM Package

There are two microcode packages available from this microcode download site; an RPM package for AIX systems and an RPM package for Linux systems. Use the appropriate method for the installed OS on the target system.

6.1 AIX RPM Package

Use this method to install the AIX RPM package on an AIX system. Note that the commands are case senstitive 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. If downloading to an interim server, transfer the RPM format file, df1000fe-0002.271315.aix.rpm to any temporary directory on the target system as follows.  If the file was downloaded directly to target server, skip to step 3.  

 

From your intermediate AIX system, enter the following commands:

ftp {name of target system or partition}

{Login with a valid userid and password}

bin

pwd  (so you know for subsequent steps what directory microcode file transferred to)

 put  df1000fe-0002.271315.aix.rpm

quit


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

rpm -ihv --ignoreos df1000fe-0002.271315.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 df1000fe-0002.271315 file in /etc/microcode. On the command line type:

For the file size:

ls -al df1000fe-0002.271315

For the sum:

sum df1000fe-0002.271315

The ouput of these commands should be:

file size: 984888
sum: 10627

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 senstitive and must be entered exactly as shown, including file names.

1. If downloading to an interim server, transfer the Linux rpm file, 10dffe00-0002-2.71x15.Linux.rpm, to a temporary directory on the target system, as follows.  If the file was downloaded directly to target server, skip to step 2. 

 

From your intermediate AIX system, enter the following commands:

ftp {name of target system or partition}

{Login with a valid userid and password}

bin

pwd  (so you know for subsequent steps what directory microcode file transferred to)

 put  df1000fe-0002.271315.aix.rpm

quit

 

2. Unpack the rpm file by typing:

        rpm -ihv /tmp/10dffe00-0002-2.71x15.Linux.rpm

3. If the microcode package unpacks successfully, the microcode file will be added to the /lib/firmware 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 2 and attempt to unpack the file again.

4. Verify the file size and sum of the pci.10dffe00.271315 file in /lib/firmware. On the command line type:

For the file size:

ls -al pci.10dffe00-0002.271315

For the sum:

sum pci.10dffe00-0002.271315

The ouput of these commands should be:

file size: 984888
sum: 10627

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
where fcsX is the port on which you want to install the microcode.

Self-explanatory menus will step you through the microcode installation.
Repeat this command for both ports on all adapters.

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*
Press enter when prompted to download the microcode

Upon completion, a message will state that the microcode has been successfully downloaded and that
the new level is 271315.

Back to Contents

7.3 Using the Emulex hbacmd Method

To update the fibre channel adapter microcode on installed adapters in a Linux system, the Emulex hbacmd program must be used. The hbacmd program must be installed on the system using an Application Kit available only from the IBM OEM web pages hosted on the Emulex web site.

To begin, open the IBM OEM web page located at http://www.emulex.com/downloads/ibm/drivers.html. The page is formatted as a matrix with driver versions listed in the first column and storage systems/platforms listed in the header row. Locate the OS release and driver version currently installed on your system as determined in section 5.2. Click on any link in this row. The link will take you to a page containing the Application Kit, a Driver User's Guide, and an Application Kit User Guide.

Download the Application Kit to any temporary directory on the target system. Untar the .tar archive by entering the following command on the command line:

tar -xvf {application-kit.tar}

After extracting the application kit, the destination directory will contain a README.txt file with steps to complete the installation and release notes. It will also include prerequisites and known issues. Read the entire README.txt file before starting the installation.

  1. Begin by confirming proper installation of the Application Kit.
    • Verify the hbacmd command is present by typing: ls /usr/sbin/hbanyware/hbacmd
    • The output should list the file path for the hbacmd command.
    • Verify the Driver Module lpfc is loaded by typing: lsmod
    • Examine the output for the presence of lpfc in the loaded module list.
    • If it is not present, type: modprobe -a lpfc to load the driver module. Examine the console messages for reported errors.


If any of the verification checks fail, review the installation documentation and ensure all steps were completed. Look for any errors reported during installation. If problems can not be resolved, contact IBM service.

  1. Since the microcode update will reset the fibre channel adapters, you should ensure that all I/O activity to storage devices controlled by the adapter being updated is stopped prior to proceeding.

    Caution: Do not interrupt this process, shut down the system, or remove power until the microcode update process is complete.
  2. The hbacmd program provides a large number of functions to manage Emulex fibre channel adapters. A complete list of available functions can be displayed by typing: /usr/sbin/hbanyware/hbacmd with no arguments.
  3. List installed Emulex adapters. Type on the command line

/usr/sbin/hbanyware/hbacmd listhbas

Output from this command will be similar to the following for each discovered adapter.

Port WWN : 10:00:00:00:c9:57:16:9c
Node WWN : 20:00:00:00:c9:57:16:9c
Fabric Name : 10:00:00:05:1e:34:f2:69
Flags : 8000fd00
Host Name : testsys
Mfg : Emulex Corporation
Serial No. : 1F6300C0C3
Port Number: n/a
Mode: Initiator

Adapters will be listed in hostN order. For each LPe11002 adapter, make a note of the Port WWN value as it will be required as an argument for commands in the following steps.

  1. List hba attributes for each LPe11002 adapter listed in step 4. Type on the command line:

/usr/sbin/hbanyware/hbacmd hbaattributes {wwpn}

where {wwpn} is one of the port WWN values listed in step 4. The output will look similar to the following and will list current versions of FW Version, SLI2 FW, SLI3 FW, and Boot Code. Save this information for each LPe11002 adapter listed for comparison after the firmware update.

HBA Attributes for 10:00:00:00:c9:57:16:9c
Host Name: elm3c101
Manufacturer : Emulex Corporation
Serial Number : 1F6300C0C3
Model: LPe11002
Model Desc : emulex LPe11002 4b PCIe Fibre Channel Adapter
Node WWN : 20 20 00 00 00 c9 57 16 9c
Node Symname : Emulex LPe11002 FV2.71A2 DV8.2.0.48.2p
HW Version : 2057706d
Opt ROM Version : 5.02x1
FW Version : 2.71A2 (Z3L2.71A2), sli-3
Vendor Spec ID : 0000
Number of Ports: 1
Driver Name : lpfc
Device ID : FE00
HBA Type : LPe11002
Operational FW : SLI-3 Overlay
SLI1 FW : 2.70a5
SLI2 FW : 2.71a2
SLI3 FW : 2.71a2
IEEE Address : 00 00 c9 57 16 9c
Boot Code : 5.02x1
Driver Version : 8 8.2.0.48.2p; HBAAPI (I) v2.1.g, 12-07-07
Kernel Version : 1.20a2
HBA Temperature: Normal

  1. Update the microcode on both ports of each LPe11002 adapter. This step assumes that the microcode image.rpm package has been installed on the system as described in section 6.2.
    Warning: Do not interrupt or power off the system while microcode update is in progress.
    To start the download, type on the command line:

/usr/sbin/hbanyware/hbacmd download {wwpn} /lib/firmware/pci.10dffe00.271315

where {wwpn} is one of the port WWN values listed in step 4.

Completion of the download will be indicated by a "Download Complete" message.

  1. Repeat steps 5 and 6 for each adapter needing to be updated.

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 -C | grep fcsX

Note the names of all the 4G fibre channel dual port adapters installed. The adapter names will be fcsX, where X is 0, 1, or some other number. There will be an fcsX listing for each port of the FC 5774 or 5276adapter.

2.  Determine the current microcode level on the adapter's port by typing on the command line:

lsmcode -d fcsX

where X is the number of the adapter's port returned from the "lsdev" command above.

A screen similar to the following will be displayed:

DISPLAY MICROCODE LEVEL                  802111
fcs8           FC Adapter

The current microcode level for fcs8 is 271315.

Use Enter to continue.







F3=Cancel             F10=Exit             Enter

If the current microcode level is 271315, then the microcode has been updated.

Back to Contents

8.2 Verifying the Update on Linux

List the hba attributes for each LPe11002 adapter port listed in Section 7.3, step 4. On the comman line type:

/usr/sbin/hbanyware/hbacmd hbaattributes {wwpn}

where {wwpn} is one of the port WWN values listed.

The output will look similar to the following:

HBA Attributes for 10:00:00:00:c9:57:16:9c
Host Name: elm3c101
Manufacturer : Emulex Corporation
Serial Number : 1F6300C0C3
Model: LPe11002
Model Desc : emulex LPe11002 4b PCIe Fibre Channel Adapter
Node WWN : 20 20 00 00 00 c9 57 16 9c
Node Symname : Emulex LPe11002 FV2.71A2 DV8.2.0.48.2p
HW Version : 2057706d
Opt ROM Version : 5.02x1
FW Version : 2.71A2 (Z3L2.71X15), sli-3
Vendor Spec ID : 0000
Number of Ports: 1
Driver Name : lpfc
Device ID : FE00
HBA Type : LPe11002
Operational FW : SLI-3 Overlay
SLI1 FW : 2.70a5
SLI2 FW : 2.71x15
SLI3 FW : 2.71x15
IEEE Address : 00 00 c9 57 16 9c
Boot Code : 5.02x1
Driver Version : 8 8.2.0.48.2p; HBAAPI (I) v2.1.g, 12-07-07
Kernel Version : 1.20a2
HBA Temperature: Normal

Compare the attribute data with the data gathered prior to the update. Values for FW Version, SLI2 FW, and SLI3 FW will list 2.71x15. If it does not, carefully retrace steps for omissions and examine console output for errors. Repeat this step for each adapter to confirm the update was successful.

Updated microcode is now active. The system can be returned to use without a reboot.

 Back to Contents


Document Change History

Date

Changes

1/15/2013

Modified section 4 to document how to check os level. Added ftp instruction to sections 6.1.2 and 6.2.1

6/26/2012

Added notice for VIOS customers installing microcode in section 4.0

Added notice limiting support of down-level FW in section 3.0

1/20/2012

Added Notice for AIX customers installing microcode in section 4.0

10/22/2009

Corrected filesize and sum in Sections 6.1 and 6.2

10/19/2009

Initial Document

10/28/2011

Modified to include 5276 in with 5774

Back to Contents

Privacy | Legal | Contact IBM