Microcode Level df1000fe.27315 (2.71x15) with FCode Level 1.50x1 for FC 5773

Microcode Level	Changes
271315 (2.71x15) with FCode Level 1.50x1	Fixes a false parity error that intermittently occurs in a SAN environment with tape drives. With the 271102 (2.71a2) level of firmware, AIX would post SRN 2603-706 and the adapter would be taken offline. If the adapter has this current level of firmware installed and SRN 2603-706 occurs, take the corrective action specified by the SRN. Enhances the FCode by adding a "set-post-linkup" command. Refer to the Important Notes in Section 4.0 for details.
271308 (2.71x8) with FCode Level 1.50x1	Fixes a false parity error that intermittently occurs in a SAN environment with tape drives. Prior to this level of firmware, AIX would post SRN 2603-706 and the adapter would be taken offline. If the adapter has this level of firmware or later, and SRN 2603-706 occurs, take the corrective action specified by the SRN. This firmware level had a limited distribution and is commonly referred to as "the iFix".
271102 (2.71a2) with FCode Level 1.50x1	This is the level of microcode that initially shipped with the adapter when it became generally available.

Back to Contents

4.0 Cautions and Important Notes

Concurrent Download

The microcode installation supports concurrent download while the adapter and attached storage are available for use. HOWEVER, it is recommended that installation be scheduled during a maintenance window or during non-peak production periods.

Enhancement to FCode

The FCode has been enhanced by adding a "set-post-linkup" command. By default, link up and initialization on the adapater occurs after the Power On Self Test (POST). The new command will allow customers to switch to bringing the link up and initializing it during POST by turning the support on. Once turned on, it will remain on until the command is run again to turn it off. Customers who would like to utilize this function should contact the IBM Support Center for instructions.

APAR's 'Required' for Microcode hang issue on Fiber Adapters "prior to" updating FW on these products:

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)

Back to Contents

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 adapters installed in the system by typing on the command line:

lsdev -C | grep fcsX

Note the names of all the fibre channel adapters installed. The adapter names will be fcsX, where X is 0, 1, or some other number. There will be an fcsX listing for each FC 5773 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 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 271308.

Use Enter to continue.

F3=Cancel             F10=Exit             Enter

If the current microcode level is not 271315, then the microcode image on the adapter is not at the latest level.

Back to Contents

5.2 Linux Systems

The following steps are for Linux Red Hat or Novell (SuSE) systems running 2.6 kernels which support the /sys filesystem. These steps assume you are logged on with root permissions and one or more IBM 4 Gigabit PCI Express Single Port Fibre Channel Adapters, FC 5773, are installed.

1. Display the model name for each installed fibre channel adapter. Type the following commands to display a list showing the model for each installed adapter.

cd /sys/class/scsi_host
find -L host* -maxdepth 1 -name "modelname" -printf %h: -exec cat {} \;

The output will be similar to that shown here:

host1: LPe11000
host2: LPe11000

These values are needed for the next step. If the list is empty, either there are no LPe11000 adapters installed or there was an error in typing the command. If the list contains other adapters but no LPe11000 adapter is listed, none are installed.

2. Display the firmware version for each LPe11000 adapter. Type the following command replacing hostN for each LPe11000 listed in step 1.

cat hostN/fwrev

The microcode level listed may vary but output will be similar to that shown here:

2.71A2 (Z3L2.71A2), sli-3

Repeat this command for each LPe11000 hostN adapter. Any adapter that does not list a microcode version of 2.71x15 needs to be updated.

3. Display the Emulex fibre channel adapter driver version. Type the following command:

modinfo -F version lpfc

The driver versions may vary but the output will be similar to that shown here:

0:8.2.0.48.2p

Only the portion following the colon is important. Make a note of the driver version as it will be needed later.

4. Display the Linux Operating System version.

For Red Hat type the following command:

cat /etc/redhat-release

The output will be similar to that shown here:

Red Hat Enterprise Linux Server release 5.3 (Tikanga) eClipz 2009601

For Novell type the following command:

cat /etc/SuSE-release

The output will be similar to that shown here:

SUSE Linux Enterprise Server 11 (ppc64)
VERSION = 11
PATCHLEVEL = 0

Back to Contents

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 system.

6.1 AIX RPM Package

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, df1000fe.271315.aix.rpm to any temporary directory on the target system.

3. Unpack the file. On the command line type:

rpm -ihv --ignoreos df1000fe.271315.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 sum of the df1000fe.271315 file in /etc/microcode. On the command line type:

For the file size:

ls -al df1000fe.271315

For the sum:

sum df1000fe.271315

The ouput of these commands should be:

file size: 960740
sum: 48537

Back to Contents

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 senstitive and must be entered exactly as shown, including file names.

1. Transfer the Linux rpm file, 10dffe00-2.71x15.Linux.rpm, to a temporary directory on the target system such as /tmp.

2. Unpack the rpm file by typing:

rpm -ihv /tmp/10dffe00-2.71x15.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.

4. Verify the file size and sum of the pci.10dffe00.271315 file in /lib/firmware. On the command line type:

For the file size:

ls -al pci.10dffe00.271315

For the sum:

sum pci.10dffe00.271315

The ouput of these commands should be:

file size: 960740
sum: 48537

Back to Contents

7.0 Installing the Adapter's Microcode

7.1 Using the AIX Command-Line Method

diag -d fcsX -T download
where fcsX is the adapter 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.

Back to Contents

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 microcode

Upon completion, a message will state that the microcode has been successfully downloaded and that
the new level is 271315.

Back to Contents

7.3 Using the Emulex hbacmd Method

To update the fibre channel adapter microcode on installed adapters in a Linux system, the Emulex hbacmd program must be used. The hbacmd program must be installed on the system using an Application Kit available only from the IBM OEM web pages hosted on the Emulex web site.

To begin, open the IBM OEM web page located at http://www.emulex.com/downloads/ibm/drivers.html. The page is formatted as a matrix with driver versions listed in the first column and storage systems/platforms listed in the header row. Locate the OS release and driver version currently installed on your system as determined in section 5.2. Click on any link in this row. The link will take you to a page containing the Application Kit, a Driver User's Guide, and an Application Kit User Guide.

Download the Application Kit to any temporary directory on the target system. Untar the .tar archive by entering the following command on the command line:

tar -xvf {application-kit.tar}

After extracting the application kit, the destination directory will contain a README.txt file with steps to complete the installation and release notes. It will also include prerequisites and known issues. Read the entire README.txt file before starting the installation.

Begin by confirming proper installation of the Application Kit.

Verify the hbacmd command is present by typing: ls /usr/sbin/hbanyware/hbacmd

The output should list the file path for the hbacmd command.

Verify the Driver Module lpfc is loaded by typing: lsmod

Examine the output for the presence of lpfc in the loaded module list.

If it is not present, type: modprobe -a lpfc to load the driver module. 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, shut down the system, or remove power until the microcode update process is complete.

The hbacmd program provides a large number of functions to manage Emulex fibre channel adapters. A complete list of available functions can be displayed by typing: /usr/sbin/hbanyware/hbacmd with no arguments.

List installed Emulex adapters. Type on the command line

/usr/sbin/hbanyware/hbacmd listhbas

Output from this command will be similar to the following for each discovered adapter.

Port WWN : 10:00:00:00:c9:57:16:9c
Node WWN : 20:00:00:00:c9:57:16:9c
Fabric Name : 10:00:00:05:1e:34:f2:69
Flags : 8000fd00
Host Name : testsys
Mfg : Emulex Corporation
Serial No. : 1F6300C0C3
Port Number: n/a
Mode: Initiator

Adapters will be listed in hostN order. For each LPe11000 adapter, make a note of the Port WWN value as it will be required as an argument for commands in the following steps.

List hba attributes for each LPe11000 adapter listed in step 4. Type on the command line:

/usr/sbin/hbanyware/hbacmd hbaattributes {wwpn}

where {wwpn} is one of the port WWN values listed in step 4. The output will look similar to the following and will list current versions of FW Version, SLI2 FW, SLI3 FW, and Boot Code. Save this information for each LPe11000 adapter listed for comparison after the firmware update.

HBA Attributes for 10:00:00:00:c9:57:16:9c
Host Name: elm3c101
Manufacturer : Emulex Corporation
Serial Number : 1F6300C0C3
Model: LPe11000
Model Desc : emulex LPe11000 4b PCIe Fibre Channel Adapter
Node WWN : 20 20 00 00 00 c9 57 16 9c
Node Symname : Emulex LPe11000 FV2.71A2 DV8.2.0.48.2p
HW Version : 2057706d
Opt ROM Version : 5.02x1
FW Version : 2.71A2 (Z3L2.71A2), sli-3
Vendor Spec ID : 0000
Number of Ports: 1
Driver Name : lpfc
Device ID : FE00
HBA Type : LPe11000
Operational FW : SLI-3 Overlay
SLI1 FW : 2.70a5
SLI2 FW : 2.71a2
SLI3 FW : 2.71a2
IEEE Address : 00 00 c9 57 16 9c
Boot Code : 5.02x1
Driver Version : 8 8.2.0.48.2p; HBAAPI (I) v2.1.g, 12-07-07
Kernel Version : 1.20a2
HBA Temperature: Normal

Update the microcode on each LPe11000 adapter. This step assumes that the microcode image.rpm package has been installed on the system as described in section 6.2.
Warning: Do not interrupt or power off the system while microcode update is in progress.
To start the download, type on the command line:

/usr/sbin/hbanyware/hbacmd download {wwpn} /lib/firmware/pci.10dffe00.271315

where {wwpn} is one of the port WWN values listed in step 4.

Completion of the download will be indicated by a "Download Complete" message.

Repeat steps 5 and 6 for each adapter needing to be updated.

Back to Contents

8.0 Verifying the Update

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 names of all the 4G fibre channel single port adapters installed. The adapter names will be fcsX, where X is 0, 1, or some other number. There will be an fcsX listing for each FC 5773 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 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 271315.

Use Enter to continue.

F3=Cancel             F10=Exit             Enter

If the current microcode level is 271315, then the microcode has been updated.

Back to Contents

8.2 Verifying the Update on Linux

List the hba attributes for each LPe11000 adapter listed in Section 7.3, step 4. On the comman line type:

/usr/sbin/hbanyware/hbacmd hbaattributes {wwpn}

where {wwpn} is one of the port WWN values listed.

The output will look similar to the following:

HBA Attributes for 10:00:00:00:c9:57:16:9c
Host Name: elm3c101
Manufacturer : Emulex Corporation
Serial Number : 1F6300C0C3
Model: LPe11000
Model Desc : emulex LPe11000 4b PCIe Fibre Channel Adapter
Node WWN : 20 20 00 00 00 c9 57 16 9c
Node Symname : Emulex LPe11000 FV2.71A2 DV8.2.0.48.2p
HW Version : 2057706d
Opt ROM Version : 5.02x1
FW Version : 2.71A2 (Z3L2.71X15), sli-3
Vendor Spec ID : 0000
Number of Ports: 1
Driver Name : lpfc
Device ID : FE00
HBA Type : LPe11000
Operational FW : SLI-3 Overlay
SLI1 FW : 2.70a5
SLI2 FW : 2.71x15
SLI3 FW : 2.71x15
IEEE Address : 00 00 c9 57 16 9c
Boot Code : 5.02x1
Driver Version : 8 8.2.0.48.2p; HBAAPI (I) v2.1.g, 12-07-07
Kernel Version : 1.20a2
HBA Temperature: Normal

Compare the attribute data with the data gathered prior to the update. Values for FW Version, SLI2 FW, and SLI3 FW will list 2.71x15. If it does not, carefully retrace steps for omissions and examine console output for errors. Repeat this step for each adapter to confirm the update was successful.

Updated microcode is now active. The system can be returned to use without a reboot.

Back to Contents

Document Change History

Date

Changes

02/06/2014

Add APAR's 'Required' in Section 4.0

10/21/2009

Correct adapter part number in Section 2.0

10/19/2009

Initial Document

Back to Contents

Privacy | Legal | Contact IBM

Date	Changes
02/06/2014	Add APAR's 'Required' in Section 4.0
10/21/2009	Correct adapter part number in Section 2.0
10/19/2009	Initial Document