PCIe2 8Gb 2-Port FC Adapter
PCIe2 Low Profile 8Gb 2-Port FC Adapter
******* PLEASE READ THIS ENTIRE NOTICE *********
DATE: May 20, 2016
Contents
1.0
Overview
This microcode RPM is
for the initial release of the 8Gb PCIe2 2-Port FC Adapter, Feature Code(s) EN0G and
EN0F. This is a multiport adapter with one ASIC. The single ASIC controls both ports so only a
single resource (port) needs to be updated.
2.0 Adapters Affected
This
microcode is for feature codes EN0G ( High Profile ) and EN0F ( Low Profile ) .
CCIN:
578D
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: PCIe2 8Gb 2-Port FC Adapter (77103225141004f3)
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
|
|
77103225141004f3.0320080200
|
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.
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 EN0G or EN0F 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 PCIe2
8Gb 2-Port FC Adapter (77103225141004f3)
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 PCIe2 8Gb 2-Port FC Adapter (77103225141004f3)
Part
Number.................00WT110
EC
Level....................N99096
Feature
Code/Marketing ID...EN0G
FRU
Number..................00WT111
Customer
Card ID Number.....578D
Serial Number...............11S00WT110Y050NY4C4HYD
Manufacture ID..............BFD1450B70166
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 77103225141004f3.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,
77103225141004f3.0320080200.aix.rpm to any temporary directory on the target
system.
3. Unpack the file. On the command line type:
rpm -ihv --ignoreos 77103225141004f3.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 77103225141004f3.0320080200 file
in /etc/microcode. On the command line type:
For the file size:
ls -al 77103225141004f3.0320080200
For the sum:
sum 77103225141004f3.0320080200
The output 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, 77103225141004f3.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/77103225141004f3.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 77103225141004f3.0320080200 file in /lib/firmware directory.
On the command line type:
For the file size:
ls -al /lib/firmware/77103225141004f3.0320080200
For the sum:
sum /lib/firmware/77103225141004f3.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 PCIe2
8Gb 2-Port FC Adapter , Feature Code EN0G or EN0F, 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 PCIe2 8Gb 2-Port FC
Adapters.
On
the command line type:
scli -b all -rg
all /lib/firmware/77103225141004f3.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
|
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 77103225141004f3.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 EN0G or EN0F 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 PCIe2 8Gb 2-Port FC Adapter (77103225141004f3)
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/20/2016
|
Initial document
|
Privacy
| Legal
| Contact IBM