*10 Gb Ethernet-SR PCI-X 2.0 **DDR** Adapter (FC: 5721)* *10 Gb Ethernet-LR PCI-X 2.0 **DDR** Adapter (FC: 5722)* * * *DATE: August 07, 2008* *Table of Contents* *1.0** ** Microcode** and Document Revision History* <#1.0_Microcode_Change_History:_> *2.0** * <#2.0_General_information> *General Information* <#2.0_General_information> *3.0** * <#3.0_Installation_Time:_>* Installation Time* <#3.0_Installation_Time:_> *4.0** * <#4.0_Machines_Affected:_> *Machine's Affected* <#4.0_Machines_Affected:_> *5.0** * <#5.0_AIX_Requirements:> *AIX Requirements* <#5.0_AIX_Requirements:> *6.0** * <#6.0_Determine_the_Current_Microcode>* Determine the Current Microcode Level for AIX* <#6.0_Determine_the_Current_Microcode> *7.0** * <#7.0_Downloading_the_RPM_Format_File_to>* Downloading the RPM Format File to the Target Server* <#7.0_Downloading_the_RPM_Format_File_to> *8.0** * <#7.0_Downloading_the_RPM_Format_File_to> *Discovery Tool Microcode CD-ROM creation and download instructions for AIX * <#7.0_Downloading_the_RPM_Format_File_to> <#7.0_Downloading_the_RPM_Format_File_to> <#9.0_Verifying_microcode_before_download>*9.0 Verifying microcode before download and notes for AIX <#9.0_Verifying_microcode_before_download> * *10.0 Microcode Download Procedure for AIX* <#10.0_Microcode_Download_Procedure_for> * * *=====================================================================================* *1.0 Microcode and Document Revision History:* *Firmware Level* *Description* KN0130 Original Release KN0150 New Link Establishment Routine. Includes iSCSI boot support. *Document Revision History* *Description* 07/09/2008 Change to Section 10.0: - Added specific steps on how to update the firmware for the 10GB Ethernet adapter when running VIOS. 08/07/2008 Changed the RPM file to contain both the SR and LR microcode files and updated the README file to reflect these changes. *2.0 General information* *10 Gb Ethernet-SR PCI-X 2.0 **DDR** Adapter (#5721) 10 Gb Ethernet-LR PCI-X 2.0 **DDR** Adapter (#5722)* ******* PLEASE READ THIS ENTIRE NOTICE ********* *3.0 Installation Time:* Approximately 30 minutes *4.0 Machine's Affected:* 7314-G30 , 8203-E4A , 8204-E8A , 9110-510 , 9110-51A , 9111-285 , 9111-520 , 9113-550 , 9115-505 , 9116-561 , 9117-570 , 9117-MMA , 9118-575 9119-590 , 9119-595 , 9119-FHA , 9125-F2A , 9131-52A , 9133-55A *5.0 AIX Requirements:* AIX 5L Version V5.3 technology level 5300-04 or AIX 5L Version V5.2 technology level 5200-08 or later If you are using another release of AIX, ensure that the adapter is supported on that release before you install the adapter. Contact service and support for assistance. *6.0 Determine the Current Microcode Level for AIX:* Before you install the microcode, it is important to determine the microcode level of the Adapter installed in the target system. Use the following instructions to read the ROM level stored in the Adapter's VPD. 1) List the Ethernet adapters installed in the system by typing: lsdev -C | grep ent Note: All of the Ethernet adapters that are installed will be displayed. They will be listed as entX, where X is 0, 1, etc. 2) To check the current microcode level for the adapter or controller enter the following command lscfg -vl entX Where ?x? is the instance of the adapter. The command will produce output similar to: # lscfg -vpl ent0 ent0 U0.1-P2-I5/E1 10 Gigabit Ethernet-SR PCI-X 2.0 DDR Adapter (1410eb02) 10 Gigabit-SR Ethernet PCI-X Adapter: Part Number................. 10N9775 FRU Number.................. 10N9774 EC Level....................D76473 Manufacture ID..............1312 Network Address.............0011257B2026 ROM Level.(alterable).......KN0150 Product Specific.(Z0).......YL1020747033 Device Specific.(YL)........U0.1-P2-I5/E1 # lscfg -vl ent0 ent0 U787F.001.DNZ0GHB-P1-C4-T1 10 Gigabit Ethernet-LR PCI-X 2.0 DDR Adapter (1410ec02) 10 Gigabit-LR Ethernet PCI-X Adapter: Part Number................. 10N9777 FRU Number.................. 10N9776 EC Level....................D76473 Manufacture ID..............1312 Network Address.............0011257B1401 ROM Level.(alterable).......KN0150 Product Specific.(Z0).......YL1020741001 Hardware Location Code......U787F.001.DNZ0GHB-P1-C4-T1 If the *ROM Level* is less than *KN0150* you should update the microcode. *7.0 Downloading the **RPM** Format File to the Target Server for AIX* Use this method to download to 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 two directories on your AIX system to receive the RPM format file. Enter: "mkdir /tmp/microcode" and then create this directory Enter: "mkdir /tmp/microcode/RPM" 2) Transfer the RPM format file to the /tmp/microcode/RPM directory (using "Save as ..."). Change to that directory, "cd /tmp/microcode/RPM". You'll see the filename for the RPM file. "rpm -ihv --ignoreos pci.1410xx02-KN0150-1.aix.noarch.rpm" *NOTE: *The rmp file pci.1410xx02-KN0150-1.aix.noarch.rpm supports both the 10 Gb Ethernet-SR PCI-X 2.0 DDR Adapter (#5721) and the 10 Gb Ethernet-LR PCI-X 2.0 DDR Adapter (#5722). 3) For AIX: The microcode files will be added to /usr/lib/microcode/. *8.0 Discovery Tool Microcode CD-ROM creation and download instructions* To obtain information how to burn a CD-ROM and run the Discovery Tool for an AIX or Linux System please go to: http://techsupport.services.ibm.com/server/mdownload/CDROMhelp.html 1) After running the Discovery Tool successfully the "/tmp/microcode/RPM" directory was created and your rpm files are copied from the CD-ROM. 2) Change to that directory, "cd /tmp/microcode/RPM". 3) Unpack the file by executing the instructions below: Enter the commands: *rpm -ihv --ignoreos *pci.1410xx02-KN0150-1.aix.noarch.rpm 4) Two microcode files will be copied to "/etc/microcode". The file size and checksum of the microcode image will be verified in Section 10.0. File Names: 1410ec02.KN0150 -10 Gb Ethernet-LR PCI-X 2.0 DDR Adapter (#5722) 1410eb02.KN0150 - 10 Gb Ethernet-SR PCI-X 2.0 DDR Adapter (#5721) *NOTE:* - "/etc/microcode" is a symbolic link to "/usr/lib/microcode". - If permission does not allow the copy to the above stated directory or file then the user will be prompted for a new location. *9.0 Verifying microcode before download and notes for AIX* *NOTE:* Microcode download must be performed separately for each Adapter bus under distinct Logical Partitions (LPAR's). Please save current and older versions of the microcode update files in case you need to restore your system. /Installation Time: /Approximately 30 min System Time. Please verify the file size and checksum of the raw microcode files matches the below. For AIX : "ls -l /usr/lib/microcode/1410ec02.KN0150" to verify file size is 131072. 10 Gb Ethernet-LR PCI-X 2.0 DDR Adapter (#5722) microcode image "sum /usr/lib/microcode/1410ec02.KN0150" to verify Checksum is 13261. "ls -l /usr/lib/microcode/1410eb02.KN0150" to verify file size is 131072. 10 Gb Ethernet-SR PCI-X 2.0 DDR Adapter (#5721) microcode image "sum /usr/lib/microcode/1410eb02.KN0150" to verify Checksum is 13261. The update process from RPM packaging or CD ROM via Diagnostic Task menus will NOT automatically detach the adapter from the network. The interfaces must be detached manually prior to updating the Open Firmware. *NOTE: *Please save off the ip address and any other pertinent information for the interface before detaching the adapter. You will need this information again when bringing the interface back up after you perform the microcode update. Under normal conditions, to detach the adapter from the network use the following command: ?ifconfig en?X? detach? ? where ?X? is the interface number for the adapter. *NOTE:* The microcode update process requires detaching the Ethernet interfaces whether the port is used as a single port or part of an etherchannel interface. Follow the steps in section 10.0 Microcode Download Procedure for AIX to download the latest microcode to the adapter. *10.0 Microcode Download Procedure for AIX: * 1) *Stop all applications.* 1.5 VIOS Customers ****Specifically, for VIOS customers, detach the **SEA** adapter interface before removing the **SEA** (Shared Ethernet adapter):**** # lsdev -C |grep ent ent3 Available 02-08 10 Gigabit Ethernet-SR PCI-X 2.0 DDR Adapter (1410eb02) ent4 Available Shared Ethernet Adapter i) ?ifconfig en?X? detach? ? where ?X? is the interface number for the Shared Ethernet Adapter. ii) ?rmdev ?l ent?X? ? where ?X? is the interface number for the Shared Ethernet Adapter. 2) At the command line type ?diag? 3) Select the "Task Selection" from diagnostics menu. 4) Select "Download Microcode" or "Microcode Tasks? then select ?Download Microcode" from the menu. 5) Select all of the 10 Gb Ethernet-SR PCI-X 2.0 DDR and/or 10 Gb Ethernet-LR PCI-X 2.0 DDR Adapters that need to be updated from the list of devices by using the arrow keys to highlight the entry and pressing "Enter" to mark it. The devices will be displayed as ent#, where # is the number of the device. Press "F7" when you are done mark all the adapters you want to flash. 6) Select "/usr/lib/microcode" or ?/etc/microcode?. 7) A dialogue box may be displayed on screen. It will state that the current microcode level on the adapter is not in the /usr/lib/microcode directory. This is acceptable because the adapter will reject any incorrect code. Press "Enter" to continue. 8) Select *KN0150* level and press "Enter" to flash the adapter. 9) The following message will appear on the screen when download is completed: "Microcode download complete successfully. The current microcode level for the device ent# is ... Please run diagnostics on the adapter to ensure that it is functioning properly." 10) If you selected more than one adapter to update, then steps 6-9 will repeat until all adapters are updated. 11) Exit diagnostics. 12) Verify the code level is KN0150 by typing "lscfg -vl ent#" for each Ethernet adapter updated. ****Specifically, for VIOS customers:**** Re-configure the SEA adapter by executing the following command: ?cfgmgr? *If the customer runs into VIOS specific issues please contact **IBM** VIOS support.*** *NOTE:* _Once the firmware has been successfully updated, you must use /smitty/ to reconfigure the network._