PCIe2
8Gb 4-Port FC Adapter
PCIe2
Low Profile 8Gb 4-Port FC Adapter
*******
PLEASE READ THIS ENTIRE NOTICE *********
DATE: January 17, 2020
Contents
3.0
Microcode Description and Revision History
4.0
Cautions and Important Notes
5.0
To Determine Adapter Microcode Levels.
7.0
Installing the Adapter's Microcode
7.1
Using the AIX Command-Line Method
7.2
Using the Diagnostic Service Aid Method
7.3
Using the QLogic/Cavium QConvergeConsole CLI Method
7.4
Using the Standalone Diagnostics CD
8.1
Verifying the Update on AIX
8.2
Verifying the Update on Linux
----------------------------------------------------------------------------------
This
update contains the AIX RPM file for the current level of microcode for the 8Gb
PCIe2 4-Port FC Adapter, Feature Code(s) EN0Y and EN12.
This
is a multi-port adapter with two identical ASICs. Each ASIC controls two ports
so only a single resource (port) needs to be updated per ASIC.
----------------------------------------------------------------------------------
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 -l fcsX (where fcsX represents the adapter)
Affected
adapters will be listed as:
PCIe2 8Gb
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 host3 host4
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.
----------------------------------------------------------------------------------
|
Microcode Level |
Changes |
|
7710322514101e04.0325080271 |
Impact: Usability
Severity: ATT This level of firmware supports the Firmware
Secure Boot feature of Power systems |
|
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 |
|
|
7710322514101e04.0320080270 |
Impact: Data
Severity: HIPER |
|
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. |
|
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. |
----------------------------------------------------------------------------------
·
Concurrent
Download - 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.
----------------------------------------------------------------------------------
Before
installing the microcode, it is important to determine the current microcode
level of the adapter.
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,2,3 or some other number. There will
be an fcsX listing for each port of the FC EN0Y or EN12 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 fcs0
PCIe2 8Gb 4-Port FC Adapter (7710322514101e04) The current microcode level for fcs0 is 0325080271. Use Enter to continue. F3=Cancel
F10=Exit Enter |
Or
|
# lscfg -vl
fcs0|grep -E ‘fcs0|ROS’ fcs0 U78CD.001.FZH0548-P2-C6-T1 8Gb PCIe2 4-Port FC Adapter (7710322514101e04) ROS
Level and ID............0319080247 |
If
the current microcode level is not 0325080271 (as shown in the ‘lsmcode’
output’) or 0319080247 (as shown in the ‘lscfg’ output), then the microcode
image on the adapter is not at the latest level.
Note:
When displaying the microcode in the ‘lscfg’ output you will notice it does not
appear to be the same version as the ‘lsmcode’ output. The reason the number looks different is that
the ‘lscfg’ displays the version in hex and the ‘lsmcode’ converts to decimal.
Convert two digits at a time.
1. Download and Install the latest
QConvergeConsole CLI package from the Qlogic/Cavium Driver Download site: http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/IBM_Search.aspx
*** NOTE: For Ubuntu, you must convert rpm to deb for ubuntu
with the "alien" utility. ***
If you do not already have alien installed you will need to
first, get alien:
#apt-get
install alien
Then use alien to convert rpm to deb format.
#alien -d QConvergeConsoleCLI-2.2.00-15.ppc64le.rpm
--scripts -k <change the package
name to match the package name you downloaded>
NOTE:
the scripts flag is important. It is needed to pull in the correct libraries
for the tool.
2. Verify
firmware version running on the host.
# qaucli
In the first ‘menu’ pick “1: Adapter Information”
In the second ‘menu’ pick “3: FC VPD Information” and then select the adapter port you wish to
verify.
If the “Firmware Version” version reported is not
8.02.71, then the microcode image on the adapter is not at the latest level.
----------------------------------------------------------------------------------
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.0325080271 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.0325080271.aix.rpm to any temporary directory on the target system.
3. Unpack the file. On the command line type:
# rpm -ihv --ignoreos 7710322514101e04.0325080271.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.0325080271 file in /etc/microcode. On the command line type:
For the file size:
# ls -al 7710322514101e04.0325080271
For the sum:
# sum 7710322514101e04.0325080271
The output of these commands should be:
file
size: 1048576
sum:
24133
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.0325080271.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 --ignoreos /tmp/7710322514101e04.0325080271.Linux.rpm
If the microcode package unpacks successfully, the
microcode file will be added to the/lib/firmware directory.
3. 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.0325080271 file in /lib/firmware directory. On
the command line type:
For the file size:2
# ls -al /lib/firmware/7710322514101e04.0325080271
For the sum:
# sum
/lib/firmware/7710322514101e04.0325080271
The output of these commands should be:
file
size: 1048576
sum:
24133
----------------------------------------------------------------------------------
Note:
This
4 port adapter uses 2 ASICs, where each ASIC manages 2 ports. The top two ports
are managed by one ASIC and the bottom two ports are managed by the second
ASIC. Only one port from each of these pairs needs to be updated for the pair
to be updated.
*** Both pairs must be
updated to completely update the entire adapter ***
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 the above
steps for at least one of the ports in the second pair. ***
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
0325080271.
*** Repeat the above
steps for at least one of the ports in the second pair. ***
The following steps assume you are logged on with root
permissions, you have the
QConvergeConsole CLI already installed and you have at least one PCIe2 8Gb
4-Port FC Adapter , Feature Code EN0Y or EN12 installed in the system.
If you do not have the QConvergeConsole CLI installed
see section 5.2 for instructions.
From the command line launch the QConvergeConsole by
typing the following:
# qaucli
From the first menu select “3: Adapter Updates”
Next select “1:
Flash Update”
Select the adapter you wish to update and hit ‘enter’
You will be asked for the filename.
Type in /lib/firmware/7710322514101e04.0325080271 <or the level
you are planning to update to> and hit ‘enter’
Next you will see the Update begin and complete. The output will be similar to the following:
Updating Flash on HBA port(s) - QLE2564. Please wait...
Flash update complete. Changes have been saved to the
HBA port(s).
Press <Enter> to continue:
*** Repeat the above steps for at least
one of the ports in the second pair. ***
If you have more than 1 EN0Y or EN12 adapter that needs
to be updated, repeat the above steps for the remaining adapters.
Below are references and the general flow on how to
update microcode update via CD. This method requires
1. To create a
bootable Diagnostic's CD go to the following URL.
http://www.software.ibm.com/webapp/set2/sas/f/diags/home.html
2. Boot the
system via a Standalone Diagnostic's CD
Note: After booting to Standalone Diagnostics, the
Diagnostic's CD can be removed.
3. 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.0325080271.aix.rpm file(s) and unpacking them
on a usable server.
The unpacked files can then be burned on to the CD
media.
----------------------------------------------------------------------------------
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,2,3 or some other number.
There will be an fcsX listing for each port of the FC
EN0Y or EN12 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 fcs0 PCIe2 8Gb 4-Port FC Adapter (7710322514101e04) The current microcode level
for fcs0 is 0325080271. Use Enter to continue. F3=Cancel F10=Exit Enter |
If the current microcode level is 0325080271, then the
microcode image was updated successfully.
Repeat
above steps for remaining ports.
1. Verify
firmware version running on the host.
#
qaucli
In the first ‘menu’ pick “1: Adapter Information”
In the second ‘menu’ pick “3: FC VPD Information” and then select one of the adapter ports.
Repeat
above steps for remaining ports.
If the “Firmware Version” version reported is 8.02.71, then the microcode image on the
adapter is at the latest level.
If version reported is not as expected, carefully
retrace steps to confirm each step is completed without error.
----------------------------------------------------------------------------------
|
Date |
Change |
|
01/17/2020 |
New microcode release to
support the Firmware Secure Boot feature of Power systems |
|
03/21/2019 |
Adding note in section 7.0,
clarifying that this 4 port adapter with 2 ASICs requires update on a port
member from each ASIC to update adapter as a whole. |
|
8/30/2018 |
New microcode release; New
microcode update procedure for Linux |
|
5/20/2016 |
Initial Document |
----------------------------------------------------------------------------------
----------------------------------------------------------------------------------
Privacy(http://www.ibm.com/privacy) |
Legal(http://www.ibm.com/legal) | Contact
IBM(http://www.ibm.com/contact)