6/26/2012: See Document Change History for details on changes to this document.
271304 (2.71x4) is the current level of microcode for the IBM 4 Gigabit PCI-X 2.0 Dual Port Fibre Channel Adapter that can be installed by a customer. Each port of this adapter is fully independent with its own microcode image. When updating microcode on this adapter, both ports should be updated.
Adapters shipped from manufacturing have a microcode level of 271310
(2.71x10) installed on them. This is a manufacturing-only version of the
microcode and is not available for installation on adapters already in the
field. Refer to section 3.0 for more information on this microcode level.
Both versions of microcode are supported.
This microcode is for:
To determine the part number of fibre channel adapters on an AIX system, on the command line key in:
lscfg -vl fcsX
where fcsX represents the adapter.
The typical time to install the microcode is .4 hr.
3.0 Microcode Description and Revision History
|
Microcode Level |
Changes |
|
271310 |
|
|
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 |
|
|
271304 |
READ CAUTIONS AND IMPORTANT NOTES (SECTION 4.0) PRIOR TO INSTALLING THIS FIRMWARE LEVEL
|
|
|
|
4.0
Cautions and Important Notes
The microcode installation supports concurrent download while the adapter and attached drives are available for use. HOWEVER, because of a hang problem that may occur when installing the 271304 microcode, it is recommended that installation of this level be scheduled during a maintenance window.
The following APARs are also required for support of the new microcode image and to correct a problem to ensure that the adapter is taken off-line if there are hardware problems with the adapter. It is recommended the APAR be installed prior to installing the new microcode.
Additionally, the
following APARs are required to be installed. Failure to do so may result in
LPAR hang while installing microcode.
·
IZ89104 for AIX
7.1 (Shipped in devices.pci.df1000f7.com
7.1.0.15)
·
IZ88330 for AIX 6.1,
TL7 (Shipped in
devices.pci.df1000f7.com 6.1.7.0)
·
IZ82960 for AIX for
AIX 6.1, TL6 (Shipped in devices.pci.df1000f7.com 6.1.6.15)
·
IZ82911 for AIX for
AIX 5.3, TL12 (Shipped in devices.pci.df1000f7.com 5.3.12.3)
·
IZ81003 for AIX for
AIX 5.3, TL11 (Shipped in devices.pci.df1000f7.com
5.3.11.6)
·
IZ80939 for AIX for
AIX 5.3, TL10 (Shipped in devices.pci.df1000f7.com 5.3.10.5)
Fixes can be obtained from the IBM Fix Central website located at http://www.ibm.com/eserver/support/fixes.
· VIOS Requirements
These are the equivalent
items to install for VIOS prior to installing microcode.
·
VIOS 2.2.1.0 or
Fixpack 25
·
VIOS 2.2.0.12-FP-24
SP-02
The Fix Pack can be obtained from the Virtual I/O Server website located at https://www14.software.ibm.com/webapp/set2/sas/f/vios/download/home.html.
Before you install the microcode, it is important to determine the current microcode level of the installed adapter.
1) List the fibre channel 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 5759/1910 adapter.
2) Determine the current microcode level on the adapter's port 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
fcs8 FC Adapter
The current microcode level for fcs8 is 210308.
Use Enter to continue.
F3=Cancel F10=Exit Enter
If the current microcode level is not 271304, then the microcode image on the adapter's port is not at the latest level.
5.2 Linux Systems
On Linux systems one of two possible methods may be used to determine the current level of microcode on installed adapters. The method used depends upon the version of Linux installed on the target server. If one method does not display the microcode level, try the other method. Both methods assume you are logged on as root user and one or more fibre channel adapters are installed.Method 1
The first method generally works on systems running Linux 2.4 kernels and some systems running 2.6 kernels which do not have full support for the /sys file system.
List fibre channel adapter information for all installed adapters by typing:
cat /proc/scsi/lpfc/*
The output will display information for each installed fibre channel adapter. Make note of the driver version, Emulex LightPulse model, and the firmware version:
Emulex LightPulse FC SCSI 7.2.4
Emulex LightPulse LP11002 4Gigabit PCI Fibre Channel Adapter
Firmware Version: 2.10 (H2D2.10x8)Method 2
The second method works on systems running Linux 2.6 and higher kernels which support the /sys file system.
- 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" -printThe 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
- 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. The driver version should be noted as it will be required later when the microcode is updated.
cat host{n}/lpfc_drvr_versionThe driver versions may vary but output will be similar to that shown here:
Emulex LightPulse FC SCSI 7.2.4
- Display the 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 LP11002 model hosts.
cat host{n}/modelname
Repeat for each host listed to identify the LP11002 models. Model will display as follows:
LP11002
- Display the firmware version for each installed Fibre Channel PCI adapter. Type the following command, replacing host{n} with the lpfc hosts for model LP11002 listed in step 3:
cat host{n}/fwrev
Repeat for each host model LP11002. The firwmare version will display as follows:
2.10 (H2D2.10x8)
If, as shown in bold text above, the Emulex LightPulse model is LP11002 and the microcode version is not 2.71x4, then the microcode needs to be updated.
6.0 Downloading and Unpacking the Microcode RPM
Package
There are two microcode packages available from this microcode download site; an RPM package for AIX systems and an RPM package for Linux systems. Use the appropriate method for the installed OS on the target server.
Use this method to install the AIX RPM package on an AIX system. Note that the commands are case senstitive and must be entered exactly as shown, including file names.
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, df1000fd-0002-271304.aix.rpm to any temporary directory on the target server.
3. Unpack the file. On the command line type:rpm -ihv --ignoreos df1000fd-0002-271304.aix.rpm
4. If the microcode package unpacks successfully, the microcode file will be added to the /etc/micrococde 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 checksum of the df1000fd-0002.271304 file in /etc/microcode.
File size: 876940
Checksum: 59370
Use this method to install the Linux RPM package on a Linux system. Note that the Linux commands are case senstitive and must be entered exactly as shown, including file names.
1. Transfer the Linux rpm file, 10dffd00-0002-2.71x4.Linux.rpm, to a temporary directory on the target server such as /tmp.
2. Unpack the rpm file by typing:
rpm -ihv /tmp/10dffd00-0002-2.71x4.Linux.rpm
3. If the microcode package unpacks successfully, the microcode file will be added to the /lib/firmware 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 2 and attempt to unpack the file again.3. Verify the microcode image, pci.10dffd00.02.271304, was installed in the /lib/firmware directory.
4. Verify the file size and checksum of the pci.10dffd00.02.271304 file in /lib/firmware.
File size: 876940
Checksum: 59370
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 AIX 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 microcodeUpon completion, a message will state that the microcode has be successfully downloaded and that
the new level is 271304.
7.3 Using the Linux lputil Method
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 pabes on the Emulex web site. Some driver versions may also requre 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 located at http://www.emulex.com/ts/docoem/framibm.htm. 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 dirver version if it is required.
Download the Application Kit and, if listed, the Application Helper Module to any temporary directory on the target server. Follow the installation instructions as provided in the User's Guide to install the downloaded packages.
- Begin by confirming proper installation of the Application Kit and the Application Helper Module.
- Verify the lputil command is present by typing: ls /usr/sbin/lpfc/lputil
- The output should list the file path for the lputil command.
- Verify the Driver Module (lpfc or lpfcdd) is loaded by typing: lsmod
- Examine the output for the presence of lpfc or lpfcdd in the loaded module list.
- If it is not present, type: modprobe -a lpfc or modprobe -a lpfcdd to examine the console messages for reported errors.
- If an Application Helper Module kit was installed, verify the Application Helper Module (lpfcdfc) is loaded by typing: lsmod
- Examine the output for the presence of lpfcdfc in the list.
- If it is not present, type: modprobe lpfcdfc to examine the console messages for reported errors.
If any of the verification checks fail, review the installation documentation and ensure all steps were completed. Look for any errors reported during installation. If problems can not be resolved, contact IBM service.
- Since the microcode update will reset the fibre channel adapters, you should ensure that all I/O activity to storage devices controlled by the adapter being updated is stopped prior to proceeding.
Caution: Do not interrupt this process, shutdown the system, or remove power until the microcode update process is complete.- Start the utility by typing: /usr/sbin/lpfc/lputil
- From the main menu, enter 1, List Adapters. Note which adapters are LP11002 adapters as each port on these adapters will need to be updated.
- From the main menu, enter 3, Firmware Maintenance.
- If more than one adapter is installed, select the adapter to be update.
- Enter 1, Load Firmware Image.
- Enter the full path name to the firmware image: /lib/firmware/pci.10dffd00.02.271304 and press enter
- Wait for a message indicating Image Successfully Downloaded and the Firmware Maintenance Menu to be displayed. the firmware update has now been written to the selected adapter.
- Repeat steps 4 through 10 to update firmware on each port of each LP11002 adapter.
- To exit the utility, enter 0, Return to Main Menu, followed by 0, Exit.
8.1 Verifying the Update on AIX
1) List the fibre channel adapters installed in the system by typing on the command line:
lsdev -C | grep fcsX
Note the device names of all the 4G fibre channel dual port 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 5759/1910 adapter.