PCIe3 4-Port 16Gb FC Adapter
PCIe3 2-Port 16Gb FC Adapter
******* PLEASE READ THIS ENTIRE NOTICE *********
Ê
DATE: October 6, 2023
Table of Contents
1.0 Microcode and Document Revision History:
2.0 General information
3.0 Installation time
4.0 Machine's Affected:
5.0 Cautions and Important Notes
6.0 Determine the Current Microcode Level
6.1 AIX Systems:
6.2 Linux Systems:
7.0 Downloading the RPM Format File to the Target Server
7.1 Downloading AIX RPM Package
7.2 Downloading Linux RPM Package
8.0 Discovery Tool Microcode CD-ROM creation and download instructions
9.0 Verifying microcode image before download
9.1 Verifying microcode before download for AIX
9.2 Verifying microcode before download for Linux
10.0 Microcode Download Procedure for AIX:
10.1	Setting up for Microcode download
10.2 Downloading Microcode to the Adapter
10.3 Verify Update
11.0 Microcode Download Procedure for Linux using QConvergeConsole CLI utility
11.1 Download and Install QConvergeConsole CLI
11.2	Download Code to Adapter
11.3	Verify
Ê
Ê

1.0 Microcode and Document Revision History: 
Ê 
Microcode Level
Changes
070202
Impact: UsabilityÊÊ Severity: ATT
* Merge microcode image for EN1E, EN1F, EN1G & EN1H to support a common image.
* While scanning devices to build boot-list a DSI can occur; Detected bad memory access to address: xxx 
* Interrupt timeout, IOCB, Type 18 seen during boot
* Adapter links may fail during SMS scan
* SCR timed out in "Report ID Acquisition IOCB" with LPM
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. 
Please Update To The Latest Level At Your Earliest Convenience
070006
Impact: NewÊÊ Severity: New
* This is the level of microcode that initially shipped with the EN1E & EN1F adapters when they became generally available
026005
Impact: NewÊÊ Severity: New
* This is the level of microcode that initially shipped with the EN1G & EN1H adapters when they became generally available


Ê
Document Revision History
Description
01/23/2023
Updated readme for 070202 microcode release. Merged EN1E, EN1F, EN1G, EN1H readme. 
04/20/2021
Created initial readme file for FC EN1E, EN1F. Initial microcode 070006 released
06/09/2020
Created initial readme file for FC EN1G, EN1H. Initial microcode 026005 released

2.0 General information 
This Readme file is intended to give directions on how to update the microcode found on the following adapters:
PCIe3 4-Port 16G FC Adapter (CCIN: 579A with FC: EN1E and EN1F)
* 7710712014109e06

PCIe3 2-Port 16G FC Adapter (CCIN: 579B with FC: EN1G and EN1H)
1) 7710612214105006

3.0 Installation time
Approximately 20 minutes.
Ê
4.0 Machine's Affected:Ê
IBM Power
Ê
5.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, during the microcode installation, the adapter ASIC is reset.  It is highly recommended that installation be scheduled during a maintenance window or during non-peak production periods.
Important Notice:Ê EEH error entries in AIX system errlog are expected when updating adapter FW.
ÊÊ
6.0 Determine the Current Microcode Level 
Ê6.1 AIX Systems:
Before you install the microcode, it is important to determine the microcode level of the Adapter installed in the target system. Use the following instructions to read the ROM level stored in the adapter's VPD.
1)Ê List the Fiber Channel adapters in the system by typing: 
# lscfg -l fcs\*
Note: All of the Fiber Channel ports that are installed will be displayed. They will be listed as fcsX, where X is 0, 1, etc. Locate the fcsX instances associated with the adapter planned for update. 
2) To check the current microcode level for the adapter or controller enter the following command 
# lsmcode -cd fcsX <Where ÒXÓ is the instance of the adapter>
The command will produce output similar to: 
The current microcode level for fcsX is 026005 or 070006.
If the ROM Level is less than 070202, you should update the microcode.
Ê
Ê6.2 Linux Systems:
1) Download and install the latest QConvergeConsole CLI package from the Marvell Driver Download site: https://www.marvell.com/support/downloads.html
To locate the correct QConvergeConsole CLI Search for the following:
a. CATEGORY: Fibre Channel Adapters
b. PLATFORM/OS: Linux
c. KEYWORDS: PPC

2) To verify firmware version running on the adapter run: # qaucli
a. Select: Ò1: Adapter InformationÓ
If the ÒFirmware VersionÓ is not 070202 then the microcode level on the adapter is not at the latest and should be updated.
Ê
7.0 Downloading the RPM Format File to the Target Server 
7.1 Downloading AIX RPM Package
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 two directories on your AIX system to receive the RPM format file. 
ÊÊÊ Enter:ÊÊÊÊÊ "mkdir /tmp/microcodeÓ 
ÊÊÊ and then create this directory
ÊÊÊ Enter:ÊÊÊÊÊ "mkdir /tmp/microcode/RPM" 
2) Transfer the RPM format file to the /tmp/microcode/RPM directory (using "Save as ...").Ê Change to that directory, "cd /tmp/microcode/RPM". 
You'll see the filename for the RPM file.
ÊÊÊ ÊÊ"rpm -ihv --ignoreos 7710xxxxxxxxxxxx.070202.aix.rpm"
3) For AIX:Ê The microcode files will be added to /etc/microcode/.Ê 
NOTE: 
Ê- "/etc/microcode" is a symbolic link to "/usr/lib/microcode". 
Ê- If permission does not allow the copy to the above stated directory or file then the user will be prompted for a new location.

7.2 Downloading Linux RPM Package
Follow these steps 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 names.
1) Transfer the Linux rpm file, 7710xxxxxxxxxxxx.070202.grp.linux.rpm, to a temporary directory on the target server such as /tmp.
2) Unpack the rpm file by typing:
# rpm -ihv --ignoreos /tmp/7710xxxxxxxxxxxx.070202.grp.linux.rpm
3) The microcode package extracts the firmware file to the /lib/firmware directory. If a message is displayed 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.
Ê
8.0 Discovery Tool Microcode CD-ROM creation and download instructions 
To obtain information how to burn a CD-ROM and run the Discovery Tool for an AIX or Linux System please go to: http://www14.software.ibm.com/support/customercare/mds/
1) After running the Discovery Tool successfully, the "/tmp/microcode/RPM" directory was created, and your rpm files are copied from the CD-ROM. 
2) Change to that directory, "cd /tmp/microcode/RPM". 
3) Unpack the file by executing the instructions below: 
ÊÊÊ Enter the commands: 
ÊÊÊÊÊ rpm -ihv --ignoreos 7710xxxxxxxxxxxx.070202.aix.rpm
4) A microcode file will be copied to "/etc/microcode".ÊÊ 
ÊÊÊÊÊÊÊÊÊÊÊÊÊÊ File Name: 7710xxxxxxxxxxxx.070202
Ê
ÊÊÊÊÊÊÊÊÊÊÊÊÊÊ NOTE: 
Ê- "/etc/microcode" is a symbolic link to "/usr/lib/microcode". 
Ê- If permission does not allow the copy to the above stated directory or file then the user will be prompted for a new location. 
ÊÊ
9.0 Verifying microcode image before download 
9.1 Verifying microcode before download for AIX
Please verify the file size and checksum of the raw microcode files matches what is listed below. 
For AIX: 

Please verify the file size and checksum
# ls -l 7710xxxxxxxxxxxx.070202
Expected file size: 1085768
Ê
# sum 7710xxxxxxxxxxxx.070202
Expected checksum: 47836  1061
Ê
9.2 Verifying microcode before download for Linux
ÊPlease verify the file location, size and checksum of the raw microcode files matches what is listed below for Linux: 
Please verify file size and checksum
# ls -l /lib/firmware/7710xxxxxxxxxxxx.070202.grp
Expected file size: 1085768
Ê
# sum /lib/firmware/7710xxxxxxxxxxxx.070202.grp
Expected checksum: 47836  1061
Ê
10.0 Microcode Download Procedure for AIX:
Microcode download must be performed separately for each Adapter under each Logical Partitions (LPAR's).
10.1 Setting up for Microcode download
* Stop all applications that use this interface/adapter
* You only need to pick one of the fcs#s per adapter for microcode update. Diag will update microcode for all ports. 

10.2 Downloading Microcode to the Adapter
1) At the command line type ÒdiagÓ
2) Select the "Task Selection (Diagnistics, Advanced Diagnostics, Service Aids, etc.)" from diagnostics menu.
3) Select "Microcode TasksÓ then select ÒDownload Latest Available Microcode" from the menu.
4) Select all the Fibre Channel Adapters that need to be updated from the list of devices 
5) If a source selection menu is displayed, Select Ò/etc/microcodeÓ.
The following message will appear on the screen when download is completed: "Installation of the microcode has completed successfully on the following instances of the adapter:ÉÊ The current microcode level ÉÉÊÊ Please run diagnostics on these resources to ensure that the adapter is functioning properly."

10.3 Verify Update
Check & verify the firmware version as described in Section 6.1
If, firmware version is not the version you are expecting, carefully retrace steps for omissions and examine console output for errors.Ê Contact IBM support if you need further assistance.
ÊÊ
11.0 Microcode Download Procedure for Linux using QConvergeConsole CLI utility
Microcode download must be performed separately for each Adapter under each Logical Partitions (LPAR's).
11.1 Download and Install QConvergeConsole CLI
Microcode updates on Fibre Channel adapters installed in a Linux system require the use of the ÒqaucliÓ utility. The ÒqaucliÓ utility is included in the QConvergeConsole CLI tool found on the Marvell Public Driver Downloads web page located at:
https://www.marvell.com/support/downloads.htmlÊ
o CATEGORY: Fibre Channel Adapters
o PLATFORM/OS: Linux
o KEYWORDS: PPC
Ensure that all I/O activity to storage devices controlled by the adapter is stopped prior to proceeding with firmware update as the adapter will be reset after firmware update.

11.2 Download Code to Adapter
From the command line launch QConvergeConsole by typing: # qaucli
* Select: Ò3: Adapter UpdatesÓ
* Select: Ò1: Flash UpdateÓ
o Select the adapter you wish to update and hit ÒenterÓ
Next you will be asked for a filename. Type the following: 
* Ò/lib/firmware/7710xxxxxxxxxxxx.070202ÓÊ<or the level you are planning to update to> and hit ÔenterÕ
The update will begin and complete.  The output will be similar to the following:
Updating Flash on HBA port(s) Ð QLExxxxx. Please waitÉ
Flash update complete. Changes have been saved to the HBA port(s).

Press <Enter> to continue:
* System must be rebooted for firmware to be loaded.Ê Reboot system

11.3 ÊVerify 
After reboot, check and verify firmware version as described in Section 6.2
If, firmware version is not the version you are expecting, carefully retrace steps for omissions and examine console output for errors.Ê Contact IBM support if you need further assistance.