03/06/2008:
Updated Section 4.0. See Description Revision History
for details
This is the current level of firmware for the IBM pSeries 2 Gigabit Fibre Channel PCI-X Adapter.
This level of firmware is for FC
6239, PNs 00P4295, 80P4381, and 80P6415.
The typical time to install the microcode is .4 hr.
This firmware update contains the following features and fixes:
Firmware Level |
Changes |
1.92a1 |
READ CAUTIONS AND IMPORTANT NOTES (SECTION 4.0) PRIOR TO INSTALLING THIS FIRMWARE LEVEL
|
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 |
|
1.91x4 |
|
1.81X3 |
|
1.81X1 |
|
1.00X5 |
GA Level |
Some customers running with a
64-bit kernel and AIX software may experience a condition where the hdisks
don't appear or the system can not do a SAN boot following installation of this
firmware level. This is due to an AIX software problem in 5.2 and 5.3.
Prior to installing the 1.92a1 firmware, the following APAR fixes should be
installed:
Fixes
can be obtained from the IBM Fix Central website located at http://www.ibm.com/eserver/support/fixes.
· Concurrent Download Support
The microcode installation occurs while the adapter and any attached dries are available for use. Whenever doing a concurrent download, it is recommended that the download be scheduled during non-peak production periods or during a maintenance window. The following APARs are required:
· AIX 5.1 APAR IY69858
· AIX 5.2 APAR IY69751
· AIX 5.3 APAR IY69796
· Damage to Adapter Following Firmware Download
Prior to downloading the firmware, the following APARs are required to be installed. Failure to do so will result in damaging the adapter.
· AIX 5.1 APAR IY35308
· AIX 5.2 APAR IY35747
Fixes can be obtained from the IBM Fix Central website located at http://www.ibm.com/eserver/support/fixes.
Before you install the microcode, it is important to determine the FRU number and microcode level of the adapter installed in the target system. Use the following instructions to read the FRU number stored in the adapter's non-volatile memory.
List the Fibre Channel PCI adapters installed in the system by typing:
lsdev -C | grep "fcs"
Note the device names of all the Gigabit Fibre Channel PCI Adapters installed. The adapter device names will be fcsX, where X is 0,1, or some other number.
There are two methods to check the current microcode level on the adapter.
lscfg -vl fcsX
Where X is the number of the adapter returned by the previous lsdev command.
The Command will produce output similar to
DEVICE LOCATION DESCRIPTION
fcs0 3F-08 FC Adapter
Part Number.................80P6415
EC Level....................A
Serial Number...............1D51406697
Manufacturer................001D
Feature Code/Marketing ID...5704
FRU Number.................. 80P6416
Device Specific.(ZM)........3
Network Address.............10000000C9492EF6
ROS Level and ID............02E01971
Device Specific.(Z0)........2003806D
Device Specific.(Z1)........00000000
Device Specific.(Z2)........00000000
Device Specific.(Z3)........03000909
Device Specific.(Z4)........FF601410
Device Specific.(Z5)........02E01971
Device Specific.(Z6)........06631971
Device Specific.(Z7)........07631971
Device Specific.(Z8)........20000000C9492EF6
Device Specific.(Z9)........HS1.91X1 <============== firmware level
Device Specific.(ZA)........H1D1.91X1
Device Specific.(ZB)........H2D1.91X1
Device Specific.(YL)........P1-I5/Q1
If the firmware level in the "Z9" field is not 1.92a1, then the microcode should be upgraded.
lsmcode -d fcsX
Where X is the number of the adapter returned from the "lsdev" command above.
Example:
lsmcode -d fcs3
DISPLAY MICROCODE LEVEL 802111
fcs3 FC Adapter
The current microcode level for fcs3 is 181301.
Use Enter to continue.
F3=Cancel F10=Exit Enter
181301 is the extension of the firmware image (df1080f9.181301) that was last loaded on the adapter.
If the current microcode level is not 192101, then the firmware should be upgraded.
On Linux systems one of two possible methods may be used to determine the current level of microcode on installed adapters. The method used is dependent upon the version of Linux installed on the target server. If the one method does not display the microcode level, try the other method. Both methods assume you are logged in as root and one or more Fibre Channel PCI adapters are installed.
1. List Fibre Channel PCI adapter information for all installed adapters by typing:
cat /proc/scsi/lpfc/*
Output will display various information for each installed Fibre Channel PCI adapter. Make note of Driver version, Emulex LightPulse model and Firmware Version:
Emulex LightPulse FC SCSI 7.2.4
Emulex LightPulse LP9802 2 Gigabit PCI Fibre Channel Adapter
Firmware Version: 1.81 (H2D1.81X1)
2. Determine which host numbers are assigned to all installed Fibre Channel PCI adapters by typing:
cd
/sys/class/scsi_host
find . -name "lpfc_drvr_version"
-print
Output will list relative path names for each installed Fibre Channel PCI adapter. Note the host{n} portion of each path.
./host2/lpfc_drvr_version
./host1/lpfc_drvr_version
3. Determine the common driver version for installed Fibre Channel PCI adapters. Type the following command, replacing host{n} with one of the lpfc hosts listed in step 1. Driver version should be noted as it will be required later when the microcode is updated.
cat host{n}/lpfc_drvr_version
Driver versions may vary but output will be similar to that shown here:
Emulex LightPulse FC SCSI 7.2.4
4. Display Emulex LightPulse model name for each installed Fibre Channel PCI adapter. Type the following command, replacing host{n} with one of the lpfc hosts listed in step 1. Take note of all LP9802 model hosts.
cat host{n}/modelname
Repeat for each host listed to identify the LP9802 models. Model will
display as follows:
LP9802
5. Display firmware version for each installed Fibre Channel PCI adapter. Type the following command, replacing host{n} with the lpfc hosts for model LP9802 listed in step 3:
cat host{n}/fwrev
Repeat for each host model LP9802. Firmware version will display as follows:
1.81 (H2D1.81X1)
If, as shown in bold text above, the Emulex LightPulse model is LP9802 and the firmware version is not 1.92a1, then the microcode should upgraded.
There are two firmware packages available, from the internet and CORE; an RPM package for AIX systems and an RPM package for Linux systems. Use the appropriate method for the Operating System installed on the target server.
Use this method to install the AIX RPM package on 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 a directory on an AIX system to receive the RPM format file.
Enter: mkdir /etc/microcode
2. Transfer the RPM format file as a bin (binary) image to a temporary directory on the target server.
You'll see the filename is pci.df1080f9-1-92a1.aix.rpm
3. Unpack the file by executing the instructions below:
Enter the commands:
rpm -ihv --ignoreos pci.df1080f9-1-92a1.aix.rpm
4. If the firmware unpacks successfully, the microcode files will be added to /etc/microcode/ directory.
/etc/microcode/df1080f9.192101
5.The file size and checksum will be verified on the firmware image, NOT the RPM file.
File size: 701264
Checksum: 54720
If step 3 returns with: " package package_name is already installed"
You will need to uninstall the rpm package as follows:rpm -e package_name
Where "package_name" is the package name returned in the failure of step three.
Now go to step 3 above to unpack the firmware.
Note: The steps that follow list specific Linux commands. Linux commands are CASE (lower and upper) SENSITIVE, and must be entered exactly as shown, including filenames.
1. Transfer the Linux RPM format file, pci.10dff980-1-92a1.Linux.rpm to a temporary directory on the target server, /tmp in this example.
2. Unpack the RPM file by typing:
rpm -ivh /tmp/pci.10dff980-1-92a1.Linux.rpm3. Verify the firmware update file, pci.10dff980.192101, was installed in /lib/firmware directory.
4. If not, carefully review previous steps and carefully examine output from rpm command for any reported errors.
5. If the firmware unpacks successfully, the microcode files will be added to the correct directory.
6.The file size and checksum will be verified on the firmware image, NOT the RPM file.
File size:701264
Checksum: 54720
If step 2 returns with: " package package_name is already installed"
You will need to uninstall the rpm package as follows:rpm -e package_name
Where "package_name" is the package name returned in the failure of step 3.
Now go to step 2 above to unpack the firmware.
The Diagnostic Microcode Download software supports the following AIX naming convention for the microcode binary file :
df1080f9.192101 where 192101 is the version of the file.
The Diagnostic Microcode Download software supports the following Linux naming convention for the microcode binary file {vendor_id}{device_id}.{version}:
pci.10dff980.192101 where 192101 is the version of the file.
You are now ready to FLASH the adapter using the single command:
diag -d fcsX -T download
Where X is the number found from the "lsdev -C | grep fcs " command.
Self-explanatory menus will step you through the microcode installation.
Repeat each step in 7.1 above for all the cards that need the update.
To Back level the firmware
diag -d fcsX -T "download -f -l previous"
From the command line login, log in as root.
Enter
diag
Select
Task Selection (Diagnostics, Advanced Diagnostics, Service Aids, etc.)
Select
Microcode Tasks
Select
Download Microcode
Select the device returned for above
fcs*
Press enter when prompted to download the microcode
Upon completion, a message will state that the firmware has been successfully downloaded and that
the new level is 192101.
Exit.
To update the Fibre Channel PCI adapter microcode on installed adapters in a Linux system the Emulex lputil flash program must be used. The lputil flash program must be installed on the system using an Application Kit available only from the IBM OEM web pages on the Emulex web site. Some driver versions may also require an Application Helper Module Kit. If the Application helper Module Kit is required, it will be listed on the IBM OEM web page along with the Application Kit. Be sure to look at all Kits on the web page.
To begin, open the IBM OEM web page by entering http://www.emulex.com/ts/docoem/framibm.htm in an internet browser. The page is a matrix with Driver versions in the first column and storage systems/platforms in the first row. Find the OS release and driver version currently installed on your system as determined in section 5.2. Click on any link in this row. This page will contain the Application Kit, a User's Guide, and the Application Helper Module for this driver version if it is required.
Download the Application Kit and, if listed, the Application Helper Module to a temporary directory on the target server. Follow the installation instructions as provided in the User's Guide to install the downloaded packages.
Once the Application Kit and, if required, the Application Helper Module Kit have been installed on the target system, the microcode update can proceed as follows.
Verify lputil
command is present by typing: ls /usr/sbin/lpfc/lputil Output should
list file path for lputil command.
Verify Driver Module (lpfc or lpfcdd)
is loaded by typing: lsmod Examine
output for presence of lpfc or lpfcdd in loaded module list. If not present, type: modprobe -a lpfc or
modprobe -a lpfcdd
and examine console messages for error reported.
If an Application Helper Module kit was installed, verify the Application
Helper Module (lpfcdfc) is loaded by typing: lsmod Examine output for presence of lpfcdfc in list. If not present, type modprobe lpfcdfc
and examine console messages for error reported.
If any of the verification checks fail, review the installation documentation and insure all steps were completed. Look for any errors reported during installation. If problems cannot be resolved, contact IBM service support.
Caution: Do not interrupt this process, shutdown the system, or remove power until the firmware update process is complete.
List the Fibre Channel PCI adapters installed in the system by typing:
lsdev -C | grep "fcs"
Note the device names of all the Gigabit Fibre Channel PCI Adapters installed. The adapter device names will be fcsX, where X is 0,1, or some other number.
There two methods to check the current microcode level for the adapter.
lsmcode -d fcsX
Where X is the number of the adapter returned from the "lsdev" command above.
Example:
lsmcode -d fcs3
DISPLAY MICROCODE LEVEL 802111
fcs3 FC Adapter
The current microcode level for fcs3 is 192101.
Use Enter to continue.
F3=Cancel F10=Exit Enter
If current microcode level is 192101, then the firmware has been upgraded.
lscfg -vl fcsX
Where X is the number of the adapter returned by the previous lsdev command.
The Command will produce output similar to
DEVICE LOCATION DESCRIPTION
fcs0 3F-08 FC Adapter
Part Number.................00P4295
EC Level....................A
Serial Number...............1A31600450
Manufacturer................001A
FRU Number.................. 00P4297
Device Specific.(ZM)........3
Network Address.............10000000C9332A79
ROS Level and ID............02E01871
Device Specific.(Z0)........2003806D
Device Specific.(Z1)........00000000
Device Specific.(Z2)........00000000
Device Specific.(Z3)........03000909
Device Specific.(Z4)........FF601032
Device Specific.(Z5)........02E01871
Device Specific.(Z6)........06631871
Device Specific.(Z7)........07631871
Device Specific.(Z8)........20000000C9332A79
Device Specific.(Z9)........HS1.91X1
Device Specific.(ZA)........H1D1.91X1
Device Specific.(ZB)........H2D1.91X1
Device Specific.(YL)........U1.9-P2-I1/Q1
If the firmware level in the "Z9" filed is 1.92a1, then the firmware has been upgraded
On Linux systems one of two possible methods must be used to determine the current level of microcode on installed adapters. If the first method does not display the microcode level, the second method should display the microcode level for installed adapters. Both methods assume you are logged in as root and one or more Fibre Channel PCI adapters are installed.
1. List Fibre Channel PCI adapter information for all installed adapters by typing:
cat /proc/scsi/lpfc/*
Output will display various information for each installed Fibre Channel PCI adapter. Verify Firmware Version:
Firmware Version: 1.92A1 (H2D1.92A1)
1. Determine which host numbers are assigned to installed Fibre Channel PCI adapters by typing:
cd
/sys/class/scsi_host
find . -name "lpfc_drvr_version"
-print
Output will list relative path names for each installed Fibre Channel PCI adapter. Note the host{n} portion of each path.
./host2/lpfc_drvr_version
./host1/lpfc_drvr_version
2. Display firmware version for each installed Fibre Channel PCI adapter by typing:
cat host{n}/fwrev
Where host{n} is one from step 1. Firmware version will display as follows:
1.92A1 (H2D1.92A1)
If the firmware level displayed using either method above is 1.92A1, then the firmware has been upgraded.
Date
Changes
03/06/08
Section 4.0: Updated Notice for Customers Installing 1.92a1 Firmware. All customers now directed to link for 5.2 and 5.3 fixes.
12/07/07
Section 4.0: Updated link to APARs. 5.2 customers instructed to install 5.2 fix. Modified date when 5.3 fix will be available.
10/04/07
Section 4.0: Updated Notice for Customers Installing 1.92a1 Firmware
Privacy | Legal | Contact IBM