8Gb PCIe2 4-Port FC Adapter

8Gb PCIe2 Low Profile 4-Port FC Adapter

 

******* PLEASE READ THIS ENTIRE NOTICE *********

 

 

 

DATE:  May 24, 2016

 

Contents

 


1.0 Overview

This update contains the AIX RPM file for the current level of microcode for the 8Gb PCIe2 Low Profile 4-Port FC Adapter, Feature Code EN0Y and 8Gb PCIe2 4-Port FC Adapter, Feature Code EN12. This is a multiport adapter with 2 identical ASICs.  Each ASIC controls 2 ports so only a single resource (port) need to be updated per ASIC.

 


2.0 Adapters Affected

This microcode is for feature codes EN0Y ( Low Profile ) and EN12 ( High Profile ) .

 CCIN EN0Y

To determine the part number of the adapter on an AIX system, on the command line key the following command:

lscfg -vl fcsX         

where fcsX represents the adapter. 

Affected adapters will be listed as:  8Gb PCIe2 Low Profile 4-Port FC Adapter (7710322514101e04)

 

To determine the presence of this adapter on a Linux system, on the command line key in:

ls /sys/class/fc_host

Example output:   host1  host2

 

Next determine the model description and name for each host. For each host{n} displayed in previous command, on the command line key in the following command,where host{n} is replaced by one of hosts listed in previous step:

 

cat /sys/class/scsi_host/host{n}/model*

 

 

The typical time to install the microcode is 0.4 hr.

 


3.0 Microcode Description and Revision History

Microcode Level

Changes

7710322514101e04.0320080200

*Moving to new branch of FW 08.xx.xx  from 05.xx.xx

* Fix AIX temporary error  on boot up.

00000094: VP0 Enable Timeout; expecting Rpt ID Acq from adapter

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

7710322514101e04.0320051040

*Fix LOGO with zero in S_ID after a LS_RJT in some NPIV environment.

*Delay 400ms before retrying an FDISC reject is received with error code LOG_BUSY 05.

 

7710322514101e04.0320051000

 

           *Fix get link statistic.

           *Fix Task Management IOCB type 14h

             completion with DMA error status.

           *Move up to FW branch 5.10

 

7710322514101e04.0315050680

This is the level of microcode that is initially supported when it became generally available.

 

 

 


4.0 Cautions and Important Notes

The microcode installation does NOT support concurrent download while the fcs resources are available for use. If the fcs 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 fcs resource be freed.

NOTE: It is recommended that the installation be scheduled during a maintenance window or during non-peak production periods.

The Service Packs can be obtained from the IBM Fix Central website located at http://www.ibm.com/eserver/support/fixes.

 

RHEL 5.7, RHEL 6.2, and SLES11 SP2 or later are supported.


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 (FC) adapters installed in the system by typing on the command line:

lsdev -C | grep fcsX

Note the device names of all the fibre channel adapters installed. The adapter device 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 EN0Y adapter

2.  Determine the current microcode level on the adapter 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

fcs0             8Gb PCIe2 Low Profile 4-Port FC Adapter (7710322514101e04)

 

The current microcode level for fcs0

is 0320080200.

 

Use Enter to continue.



F3=Cancel             F10=Exit             Enter

 

Or

 

 

 

# lscfg -vl fcs6

 

  fcs6             U78CA.001.RCH0032-P1-C6-C1-T1  8Gb PCIe2 Low Profile 4-Port FC Adapter (7710322514101e04)

 

        Part Number.................00FX604

        EC Level....................N46430

        Feature Code/Marketing ID...EN0Y

        FRU Number..................00FX604

        Customer Card ID Number.....EN0Y

        Serial Number...............11S00FX604YA50NY4C4HYD

        Manufacture ID..............RFD1447A79942

        Network Address.............21000024FF649838

        ROS Level and ID............0314080200

        Device Specific.(Z0)........00080200

        Device Specific.(Z1)........03149095

        Device Specific.(Z2)........49535020

        Device Specific.(Z3)........00002532

        Device Specific.(Z4)........000E0002

        Device Specific.(Z5)........0001000A

        Device Specific.(Z6)........00010001

        Device Specific.(Z7)........00000000

        Device Specific.(Z8)........20000024FF649838

        Device Specific.(Z9)........ISP

        Hardware Location Code......U78CA.001.RCH0032-P1-C6-C1-T1

 

 

If the current microcode level is not 0320080200, then the microcode image on the adapter is not at the latest level.

 

5.2 Linux Systems

1.  Identify fibre channel hosts. Following command will list fibre channel hosts.

ls /sys/class/fc_host

 

Example output: host3 host4

 

2. Verify firmware version running on the host.  The following command will display the firmware version loaded by the adapter, where host{n} is replaced by one of hosts listed in previous step.

cat /sys/class/scsi_host/host{n}/fw_version

 

Expected output: 8.02.00 (nnnn)   (nnnn) can be ignored

If version reported is not greater than or equal to 8.02.00, then the microcode image on the adapter is not at the latest level.


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. Installing the RPM places the binary file 7710322514101e04.0320080200 in the /etc/microcode directory.

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, 7710322514101e04.0320080200.aix.rpm to any temporary directory on the target system.

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

rpm -ihv --ignoreos 7710322514101e04.0320080200.aix.rpm

4. If the microcode package unpacks successfully, the microcode file will be added to the /etc/microcode 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 7710322514101e04.0320051040 file in /etc/microcode. On the command line type:

For the file size:

ls -al 7710322514101e04.0320080200

For the sum:

sum 7710322514101e04.0320080200

The ouput of these commands should be:

file size: 1048576
sum: 54457

 

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, 7710322514101e04.0320080200.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/7710322514101e04.0320080200.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 7710322514101e04.0320080200 file in /lib/firmware directory. On the command line type:

For the file size:

ls -al /lib/firmware/7710322514101e04.0320080200

For the sum:

sum /lib/firmware/7710322514101e04.0320080200

The output of these commands should be:

file size: 1048576
sum: 54457

 

 


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

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

7.2 Using the 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.
Only one of the fcs 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 0320080200.

7.3 Using the QLogic CLI Method

The following steps assume you are logged on with root permissions, QLogic and at least one 8Gb PCIe2 Low Profile 4-Port FC Adapter, Feature Code EN0Y, 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

      Pick Fibre Channel , and QLE2564L  and Management Tools, and Go

      Download the latest level of Qlogic CLI Management Application for Linux (PPC64)

 

 A single command will update the microcode on all installed 8Gb PCIe2 Low Profile 4-Port FC Adapters.

 On the command line type:

scli -b all -rg all /lib/firmware/7710322514101e04.0320080200

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

Updating Flash on HBA port(s) - QLE2564. Please wait...

Flash update complete. Changes have been saved to all ports of this HBA.

Updating Flash on HBA port(s) - QLE2564. Please wait...

Flash update complete. Changes have been saved to all ports of this HBA.

Skipping flash update on HBA instance 3 - QLE2564

Updating Flash on HBA port(s) - QLE2564. Please wait...

Flash update complete. Changes have been saved to all ports of this HBA.

Skipping flash update on HBA instance 5 - QLE2564

7.4 Using the Standalone Diagnostics CD

Below are references and the general flow on how to update microcode update via CD. This method requires

1) Boot the system via a Standalone Diagnostic's CD

a) To create a bootable Diagnostic's CD go to the following URL.

http://www.software.ibm.com/webapp/set2/sas/f/diags/home.html

b) After booting to Standalone Diagnostics, the Diagnostic's CD can be removed.

2) The Diagnostic's CD should be replaced by a CD containing the unpacked microcode image(s).

The CD containing the microcode images should be prepared prior. This can be done by taking the 7710322514101e04.0320080200.aix.rpm file(s) and unpacking them on a usable server. The unpacked files can then be burned on to the CD media.

 


8.0 Verifying the Update

8.1 Verifying the Update on AIX

1.  List the Fibre Channel (FC) adapters installed in the system by typing on the command line:

lsdev -C | grep fcsX

Note the device names of all the fibre channel adapters installed. The adapter device 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 EN0Y adapter

2.  Determine the current microcode level on the adapter 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

fcs0             8Gb PCIe2 Low Profile 4-Port FC Adapter (7710322514101e04)

 

The current microcode level for fcs0

is 0320080200.

 

Use Enter to continue.



F3=Cancel             F10=Exit             Enter

 

If the current microcode level is 0320080200, then the microcode image was updated successfully.

 

 

8.2 Verifying the Update on Linux

1.  Identify fibre channel hosts. Following command will list fibre channel hosts.

ls /sys/class/fc_host

 

Example output: host1 host2

 

 

2. Verify firmware version running on the host.  The following command will display the firmware version loaded by the adapter, where host{n} is replaced by one of hosts listed in previous step.

cat /sys/class/scsi_host/host{n}/optrom_fw_version

 

Expected output: 8.02.00 (nnnn)   (nnnn) can be ignored

 

If version reported is not as expected, carefully retrace steps to confirm each step is completed without error. 

 

 



Document Change History

Date

Change

5/24/2016

Updated to level 0320080200.

9/16/2015

 

Updated to level 0320051040.

 

12/21/2013

Updated Microcode Description and Revision History section to reflect fixes implemented on the 7710322514101e04.0320051000 Microcode Level.

08/01/2012

Initial Document

 






 
 
 
 
 
 

Privacy | Legal | Contact IBM