Microcode Level df1000fe.27315 (2.71x15) with FCode Level 1.50x1 for FC 5773 *02/06/2014: See Document Change History <#Change_history> for details on changes to this document.* Contents * 1.0 Overview <#ov> * 2.0 Adapters Affected <#2.0_Systems_Affected> * 3.0 Microcode Description and Revision History <#3.0_Firmware_Description_and_Revision_H> * 4.0 Cautions and Important Notes <#4.0_Cautions_and_Important_Notes> * 5.0 To Determine Adapter Microcode Levels <#5.0_To_Determine_Adapter_Microcode_Leve> o 5.1 AIX Systems <#5.1_AIX_Systems> o 5.2 Linux Systems <#5.2_Linux_Systems> * 6.0 Downloading and Unpacking the Microcode RPM Package <#6.0_Downloading_and_Unpacking_the_Micro> o 6.1 AIX RPM Package <#6.1_AIX_RPM_Package> o 6.2 Linux RPM Package <#6.2_Linux_RPM_Package> * 7.0 Installing the Adapter's Microcode <#7.0_Update_the_Adapter's_Microcode> o 7.1 Using the AIX Command-Line Method <#7.1_Using_the_AIX_Command-Line_Method> o 7.2 Using the AIX Diagnostic Service Aid Method <#7.2_Using_the_Download_Microcode_Diagno> o 7.3 Using the Emulex hbacmd Method <#7.3_Using_the_Linux_lputil_Method> * 8.0 Verifying the Update <#8.0_Verifying_the_Update> o 8.1 Verifying the Update on AIX <#8.1_Verifying_the_Update_on_AIX> o 8.2 Verifying the Update on Linux <#8.2_Verifying_the_Update_on_Linux> * Document Change History <#Change_history> ------------------------------------------------------------------------ 1.0 Overview This is the current level of microcode for the IBM 4 Gigabit PCI Express Single Port Fibre Channel Adapter, Feature Code 5773. Back to Contents <#Contents> ------------------------------------------------------------------------ *2.0 Adapters Affected* This microcode is for featue code 5773: PN 10N7249: CCIN 5773 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. Back to Contents <#Contents> ------------------------------------------------------------------------ *3.0 Microcode Description and Revision History* *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 <#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 <#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 <#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 <#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 ** is already installed", you will need to uninstall the rpm package. On the command line type: *rpm -e * where 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 <#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 ** is already installed", you will need to uninstall the rpm package. On the command line type: *rpm -e * where 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 <#Contents> ------------------------------------------------------------------------ *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 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 <#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 <#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. 1. 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. 2. 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. 3. 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. 4. 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. 5. 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 6. 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. 7. Repeat steps 5 and 6 for each adapter needing to be updated. Back to Contents <#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 <#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 (Z3L*2.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 <#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 <#Contents> ------------------------------------------------------------------------ Privacy | Legal | Contact IBM