F/C 4962 10/100 Mbps Ethernet PCI Adapter II REVISED: January 06, 2005 Table of Contents *_1.0 Microcode Change History_ <#1.0>* *_2.0 General Information_ <#2.0>* *_3.0.0 Determine Adapter Part Numbers and Current Microcode Level_ <#3.0.0>* *_3.0.1 Determine Dependencies_ <#3.0.1>* *_4.0.0 Downloading and Unpacking the Firmware Update Package from WEB_ <#4.0.0>* *_4.0.1 Downloading and Unpacking the Firmware Update Package from CORE_ <#4.0.1>* *_4.0.2 Downloading and Unpacking RPM File from Web to the Target Server_ <#4.0.2>* *_4.0.3 Downloading and Unpacking RPM File from the Microcode CD-ROM_ <#4.0.3>* *_5.0.0 Downloading Directly to the Target System_ <#5.0.0>* *_5.0.1 Downloading to an Intermediate AIX System and Using FTP_ <#5.0.1>* *_5.0.2 Downloading to an Intermediate AIX System and Using a Diskette_ <#5.0.2>* *_6.0.0 Updating the Adapter's Microcode_ <#6.0.0>* *_6.0.1 Updating the Adapter's Microcode from AIX or CORE packaging_ <#6.0.1>* *_6.0.2 Updating the Adapter's Microcode from RPM packaging via Diagnostic Task Selection Menu_ <#6.0.2>* *_6.0.3 Updating the Adapter's Microcode directly from Microcode CD-ROM via Diagnostic Task Selection Menu_ <#6.0.3>* *_7.0.0 Updating the Machine Records_ <#7.0.0>* ------------------------------------------------------------------------ 1.0 Microcode (Open Firmware) Change History Open Firmware Level - Used only for NIM install SCU015 * This code level fixes a problem with FC 4962 attached to hubs which are by default half duplex. The previous adapter code did not handle half duplex well when there was other traffic going to the client system as is the case with hubs. Switches are usually not a problem as they filter out traffic. SCU004 * Allows F/C 4962 to "remember" previous settings created by user in SMS. Passes auto/auto parameters to AIX (instead of what was detected) if selected by user in SMS. For auto/auto to work properly, you must have APAR IY32836 for AIX 5.1 and APAR IY34225 for AIX 4.3. * Fixes problem with minimum config on integrated FC4962. * Please see the important note below. SCU002 * Fixed problem in code to work in situations where there is a delay due to routers checking the spanning tree and there is a high amount of network traffic. SCU001 * Original (GA) Open Firmware level. The level contained in this update is:* SCU015* *Note:* The previous parameters selected from the SMS menus during a NIM install are stored in NVRAM and used on subsequent boots. However, if you go into the SMS menu for adapter parameters, the System Firmware assumes you want to change the parameters and resets them to the default of auto/auto. The SMS menus will be updated in the future via System Firmware to display the actual settings without changing the parameters to a default of auto/auto. *_Back to Contents <#Contents>_** * ------------------------------------------------------------------------ 2.0 General Information This package provides new Open Firmware for the Feature Code 4962, 10/100 Mbps Ethernet PCI Adapter II. To perform this update, please read these instructions completely. It is also recommended that you print them for quick reference. The typical time to install this Open Firmware is .2 hrs; the Open Firmware becomes active when installed and does not require a system reboot to become active. For multiple adapters in a system, each additional adapter will require about one minute per adapter to update. *NOTE: Before attempting this update, please ensure that you satisfy the _dependencies <#3.0.1>_ listed in this document.* *NOTE: Verify the following values for the following microcode files using ls -l and sum command:* *1410ff01.SCU015 Filesize: *65536 bytes* Checksum: *02011 *_ _* *_Back to Contents <#Contents>_ * ------------------------------------------------------------------------ 3.0.0 Determine Adapter Part Numbers and Current Microcode (Open Firmware) Level It is not necessary to physically remove the adapter from the system to determine its part number. Please follow the instructions below to electronically read it from its nonvolatile memory. Step 1. Reading Adapter's Part Number and Firmware Level from AIX The adapter part number resides in its VPD area. These instructions will also read the adapter's code level. 1) List the 10/100 Mbps Ethernet PCI Adapter II adapters installed in the system by typing: * lsdev -C | grep 1410ff01* The output should look like: ent0 Available 00-03 10/100 Mbps Ethernet PCI Adapter II (1410ff01) ent1 Available 00-04 10/100 Mbps Ethernet PCI Adapter II (1410ff01) The 10/100 Mbps Ethernet PCI Adapter II, if present, will be identified as ent0, ent1, ...ent(x). 2) To read the VPD, execute the following command, where (x) corresponds the adapter's identifier: * lscfg -l ent(x) -v* The output should be similar to the example below: DEVICE LOCATION DESCRIPTION ent0 10-70 10/100 Mbps Ethernet PCI Adapter II (1410ff01) 10/100 Mbps Ethernet PCI Adapter II: Part Number.................09P5023 EC Level....................H10971A Manufacture ID..............YL1021 Network Address.............0003474BDB7F FRU Number..................09P5023 Product Specific.(PA).......A5204205 Product Specific.(OF).......SCU015 or in AIX 5 as ROM Level.(alterable).......SCU015 Device Specific.(YL)........P1-I4/E1 The field, Product Specific.(OF) or ROM Level.(alterable).......SCU015, means the code level is SCU015. *_Back to Contents <#Contents>_ * ------------------------------------------------------------------------ 3.0.1 Determine Dependencies This new Open Firmware can be installed only if the following dependencies are met: · Adapter is installed in one of the supported models based on your Sales Manuals. · Potential part numbers must be from the list below: o P/N: 09P5023, 09P3196 o FRU: 09P5023, 09P3196 · AIX levels supported: o 4.3.3 and later o 5.1 and later Can Firmware Be Installed Concurrently? Yes! Yes, but the adapter must be available and will be detached and reattached to the network. The update process from AIX binary or CORE packaging will automatically detach the adapter from the network and will reattach to the network if the adapter was configured in SMIT. Otherwise, you will need to reattach via SMIT or AIX commands. 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. See *_6.0.0 Updating the Adapter's Microcode_ <#6.0.0>* for more details. *_Back to Contents <#Contents>_ * ------------------------------------------------------------------------ 4.0.0 Downloading and Unpacking the Firmware Update Package from WEB Instructions for downloading and unpacking the firmware update package follow. *NOTE: AIX Instructions are CASE (lower and UPPER) SENSITIVE, and must be entered exactly as shown, including the filenames. DOS commands are not.* This microcode update package, in AIX format is located at web site: *_http://techsupport.services.ibm.com/server/mdownload/download.html_* *NOTE: Once at the web site above, you must read and agree to the license agreement.* After reading the license agreement, return to this web site, locate the table of contents, and click on the entry labeled "Adapter Microcode." At the table labeled "Adapter Microcode," find the entry "F/C 4962 10/100 Mbps Ethernet PCI Adapter II." You are presented with this description (readme file) and the AIX download file under column heading "Files to read/download." To assist you making the correct choice, the next paragraph contains three sets of instructions for transferring the update files to your target system. Make this decision first and then download the description file and the appropriate self exploding file (described below). * Description (This document with complete instructions) * AIX Format (Self-exploding file for downloading to an AIX server or system) The update files may be transferred to the target system in one of several ways. Please select your preference below and refer to the appropriate section for a complete set of instructions. *_Downloading the update files directly to the target AIX system. <#5.0.0>_ _Downloading the update files to an intermediate AIX system and using ftp to transfer the files to the target system. <#5.0.1>_ _Downloading the update files to an intermediate AIX system and using a diskette to transfer the files to the target system. <#5.0.2>_ * *_Back to Contents <#Contents>_* ------------------------------------------------------------------------ 4.0.1 Downloading and Unpacking the Firmware Update Package from CORE *Note: *CORE is a microcode repository that it designed to work with the tools used by IBM Customer Engineers and is only available to IBM Customer Engineers. All others must use the Internet download and installation instruction described above. The latest 10/100 Mbps Ethernet PCI Adapter II Open Firmware level is available from: CORE (Current Object REpository) It is provided in AIX backup format in the package listed under the following structure: + *RS/6000-Microcode-Adapter* # *Open Firmware Update for F/C 4962* * *10/100 Mbps Ethernet PCI Adapter II* Producing the Firmware for installation from CORE The files contained in the CORE package are: CORE4962.HTM (these Instructions in HTML) FLSH4962.EXE (Diskette image of microcode files as AIX backups) Creating the diskettes It is recommended that you create the diskette from a *'local image'*. If you do not have a local image or a copy of image on a CD press *'Make a local copy'* on the Server line. Place a *1.44 Mbyte* diskette into your 'A' Diskette drive Press *'Launch' *on the line that represents the Firmware that you want to generate. Last*, Label Diskette* "AIX Backup: F/C 4962, 10/100 Mbps Ethernet PCI Adapter II Open Firmware Update." Transfer update files from this AIX backup diskette to the System or CWS or LPAR *Login or su as "root"* Enter the AIX commands: * mkdir /tmp/flash4962* (skip this command if already done) * cd /tmp/flash4962* * restore -xq* Proceed directly to *_Updating the Adapter's Microcode <#6.0.0>_. * *_Back to Contents <#Contents>_ * ------------------------------------------------------------------------ 4.0.2 Downloading and Unpacking RPM File from Web to the Target Server 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. a) Check to see if /tmp/microcode/RPM directory exists. If so, skip to step b). If not, Make a directory on an AIX system to receive the RPM format file. Enter: cd /tmp Enter: mkdir microcode Enter: cd microcode Enter: mkdir RPM b) Transfer the RPM format file to the /tmp/microcode/RPM directory (using "Save as ..."). You'll see the filename is *pci.1410ff01.SCU015.rpm* c) Unpack the file by executing the instructions below: Enter the commands: rpm -ihv --ignoreos pci.1410ff01.SCU015.rpm The microcode file named 1410ff01.SCU015 will be added to /etc/microcode/ d). Verify the following values for the following microcode files using ls -l and sum command: *1410ff01.SCU015 Filesize: *65536 bytes* Checksum: *02011 Proceed directly to *_Updating the Adapter's Microcode <#6.0.0>_. * *_Back to Contents <#Contents>_ * ------------------------------------------------------------------------ 4.0.3 Downloading and Unpacking the RPM File from the Microcode CD-ROM Copy microcode updates from the CD-ROM to standard locations on your local disk: 1. RPM packaged microcode files will be copied to "/tmp/microcode/RPM" 2. Unpack the file by executing the instructions below: Enter the commands: rpm -ihv --ignoreos pci.1410ff01.SCU015.rpm The microcode file named 1410ff01.SCU015 will be added to /etc/microcode/ 3. Verify the following values for the following microcode files using ls -l and sum command: *1410ff01.SCU015 Filesize: *65536 bytes* Checksum: *02011 *Notes:* - You must have root user access to copy rpm file from CD-ROM to your system. - "/etc/microcode" is a symbolic link to "/usr/lib/microcode". Proceed directly to *_Updating the Adapter's Microcode <#6.0.0>_. * *_Back to Contents <#Contents>_ * ------------------------------------------------------------------------ 5.0.0 Downloading AIX Binary Directly to the Target System To download directly to the system in which the adapter you intend to update resides. *Note:* If the system is running LPAR, you must determine what partition has the resources assigned. * NOTE:Keep in mind all installed adapters must be assigned to a partition to receive this code update.* * The other option is put the system in Full System Partition mode to update all adapters.* The code update will only occur on that LPAR. You must perform the same procedures across all LPARs to update the adapters in the entire system. If installing code from a floppy diskette, ensure that the floppy drive must be configured as part of that LPAR. Follow this procedure for each partition: 1) Provide a directory on your AIX system to receive the download. Enter: * mkdir /tmp/flash4962* 2) Transfer the AIX format file to the /tmp/flash4962 directory (using "Save as ..."). The name of the file is flash4962.bin. 3) Unpack the microcode package by executing the flash4962.bin file as shown below. Enter the commands: * cd /tmp/flash4962* * chmod +x flash4962.bin* * ./flash4962.bin* [Don't overlook the periods (.) in the above command.] These files are unpacked into the working directory /tmp/flash4962. NAME DESCRIPTION ---- ----------- flash Script file for walking the bus, testing, and flashing the adapter 1410ff01.SCU015 Actual microcode image that gets FLASHed onto adapter hxescurry_43 Test case used to flash code onto adapter on AIX43 hxescurry_51 Test case used to flash code onto adapter on AIX51 load_kern_ext System function to load kernel extension rule Test case sequencer Proceed directly to *_Updating the Adapter's Microcode <#6.0.0>_.* ------------------------------------------------------------------------ 5.0.1 Downloading AIX Binary to an Intermediate AIX System and Using FTP * NOTE:* If the system is running LPAR, you must determine what partition has the resources assigned. * Keep in mind all installed adapters must be assigned to a partition to receive this code update.* * The other option is put the system in Full System Partition mode to update all adapters.* The code update will only occur on that LPAR. You must perform the same procedures across all LPARs to update the adapters in the entire system. If installing code from a floppy diskette, ensure that the floppy drive must be configured as part of that LPAR. Follow this procedure for each partition: 1) Provide a directory on your intermediate AIX system to receive the download. Enter: * mkdir /tmp/flash4962* 2) Transfer the AIX format file to the /tmp/flash4962 directory (using "Save as ..."). The name of the file is flash4962.bin 3) Transfer this file to the target system via ftp, provided you have access to the target system. From your intermediate AIX system, enter the following commands: * ftp *{name of target system} {Login with a valid userid and password} * bin* * lcd /tmp/flash4962* * mkdir /tmp/flash4962* * cd /tmp/flash4962* * put flash4962.bin* * quit* 4) On the target system, unpack the update file by executing the flash4962.bin file as shown below. Enter the commands: * cd /tmp/flash4962* * chmod +x flash4962.bin* * ./flash4962.bin* [Don't overlook the periods (.) in the above command.] These files are unpacked into the working directory /tmp/flash4962. NAME DESCRIPTION ---- ----------- flash Script file for walking the bus, testing, and flashing the adapter 1410ff01.SCU015 Actual microcode image that gets FLASHed onto adapter hxescurry_43 Test case used to flash code onto adapter on AIX43 hxescurry_51 Test case used to flash code onto adapter on AIX51 load_kern_ext System function to load kernel extension rule Test case sequencer Proceed directly to *_Updating the Adapter's Microcode <#6.0.0>_.* ------------------------------------------------------------------------ 5.0.2 Downloading AIX Binary to an Intermediate AIX System and Using a Diskette * NOTE:* If the system is running LPAR, you must determine what partition has the resources assigned. * Keep in mind all installed adapters must be assigned to a partition to receive this code update.* * The other option is put the system in Full System Partition mode to update all adapters.* The code update will only occur on that LPAR. You must perform the same procedures across all LPARs to update the adapters in the entire system. If installing code from a floppy diskette, ensure that the floppy drive must be configured as part of that LPAR. Follow this procedure for each partition: 1) Provide a directory on your intermediate AIX system to receive the download. Enter: * mkdir /tmp/flash4962* 2) Transfer the AIX format file to the /tmp/flash4962 directory (using "Save as ..."). The name of the file is flash4962.bin 3) Create a diskette to transfer this file to your target system. Insert a blank, 2MB (HD) diskette in your intermediate AIX system diskette drive and enter the following commands: * cd /tmp/flash4962* * ls flash4962.bin | backup -ivr* Label the resulting diskette " F/C 4962 10/100 Mbps Ethernet PCI Adapter II Microcode Update." 4) Place the "F/C 4962 10/100 Mbps Ethernet PCI Adapter II Microcode Update" diskette in diskette drive of target machine and enter the following commands: * mkdir /tmp/flash4962* * cd /tmp/flash4962* * restore -xq* 5) Unpack the update file by executing the flash4962.bin file as shown below. Enter the commands: * cd /tmp/flash4962* * chmod +x flash4962.bin* * ./flash4962.bin* [Don't overlook the periods (.) in the above command.] These files are unpacked into the working directory /tmp/flash4962 NAME DESCRIPTION ---- ----------- flash Script file for walking the bus, testing, and flashing the adapter 1410ff01.SCU015 Actual microcode image that gets FLASHed onto adapter hxescurry_43 Test case used to flash code onto adapter on AIX43 hxescurry_51 Test case used to flash code onto adapter on AIX51 load_kern_ext System function to load kernel extension rule Test case sequencer Proceed directly to *_Updating the Adapter's Microcode <#6.0.0>_.* ------------------------------------------------------------------------ 6.0.0 Updating the Adapter's Microcode (Open Firmware) * NOTE:* If the system is running LPAR, you must determine what partition has the resources assigned. Please save current and older versions of the microcode update files in case you need to restore your system. * Keep in mind all installed adapters must be assigned to a partition to receive this code update.* * The other option is put the system in Full System Partition mode to update all adapters.* The code update will only occur on that LPAR. You must perform the same procedures across all LPARs to update the adapters in the entire system. If installing code from a floppy diskette, ensure that the floppy drive must be configured as part of that LPAR. Follow this procedure for each partition: *CAUTIONS/WARNINGS:* *Do not power down or reset the node while the update is in progress. If process is interrupted, the adapter may be left in an indeterminate state and may not be able to do NIM boots. * Ensure you're logged in as root, if not issue the following command and enter the password: *su** root* *_To flash from AIX Binary package go to section 6.0.1, Updating the Adapter's Microcode from AIX Binary Packaging._ <#6.0.1> * *_To flash from RPM packaging, go to section 6.0.2, Updating the Adapter's Microcode from RPM packaging via Diagnostic Task Selection Menu._ <#6.0.2> * *_To flash directly from Microcode CD-ROM, go to section 6.0.3, Updating the Adapter's Microcode from Microcode CD-ROM via Diagnostic Task Selection Menu._ <#6.0.3>* ------------------------------------------------------------------------ 6.0.1 Updating the Adapter's Microcode from AIX Binary or CORE Packaging *PLEASE NOTE: The language environment must be set to US-English before executing the flash script. To change the language environment, enter:* * * *CAUTIONS/WARNINGS:* *Do not power down or reset the node while the update is in progress. If process is interrupted, the adapter may be left in an indeterminate state and may not be able to do NIM boots. The flash microcode update program automatically detaches the LAN interfaces from the networks to run the update utility. The adapter interfaces will be unavailable after the flash utility completes until you perform one of the steps below to bring the interfaces back up.* * * After the update is complete, the network interfaces will automatically reconfigure if they were created in SMIT. If you configured the interface from the AIX command line, you will have to manually reconfigure the interface after the flash program completes. You may also use SMIT to manually re-configure the interfaces. With the machine powered ON and AIX operational, perform the following steps to install the FLASH code into your adapter. * * * * *NOTE: For AIX 5, you can flash the microcode on the adapter via the Diagnostics Task Selection_, 6.0.2 Updating the Adapter's Microcode from RPM Packaging via Diagnostic Task Selection Menu_ <#6.0.2> or use the flash command process which follows immediately.* *smitty* * *System Environments Manage Language Environment Change / Show Primary Language Environment Change / Show Cultural Convention, Language, or Keyboard 1) If you haven't already done so, cd to the temporary directory by typing: * cd /tmp/flash4962* 2) Change file permissions to allow their execution: * chmod 777 ** 3) You are now ready to FLASH the EEPROM in the ethernet adapter using the single command: .*/**flash* 4) Reset the language environment to the original settings. The flash update program in this package automatically detects every F/C 4962 10/100 Mbps Ethernet PCI Adapter II in the system and updates their microcode one adapter at a time. A normal screen message will look like: AIX 5.1.0.0 detected *************************** Update FLASH_ROM for ent1 *************************** Start FLASH_ROM update, please be patient FLASH_ROM update done FLASH_ROM post update test done The update procedure should take less than 2 minutes per adapter. Also, since the utility tests, flashes the adapter, and retests it, it is not necessary to verify the microcode level. However, if you would like to do so, follow this *_link for instructions _.* ------------------------------------------------------------------------ 6.0.2 Updating the Adapter's Microcode from RPM Packaging via Diagnostic Task Selection Menu *CAUTIONS/WARNINGS:* *Do not power down or reset the node while the update is in progress. If process is interrupted, the adapter may be left in an indeterminate state and may not be able to do NIM boots. You MUST manually detach the LAN interfaces from the networks to run the Diagnostic Task Selection Menu update process. The adapter interfaces will be unavailable after the flash utility completes until you perform one of the steps below to bring the interfaces back up.* * * *Note: You must have the following filesets or later installed to flash the image file extracted from the rpm file. AIX 43 does NOT support flashing the image file from the Diagnostic Task Selection Menu. * * * *AIX 51: APAR is IY40699 fileset - devices.pci.1410ff01.diag level 5.1.0.50 AIX 52: APAR is IY40710 fileset - devices.pci.1410ff01.diag level 5.2.0.10 * From the command line login, log in as root. Use the following command: *diag** -d ent(x) -T download* and follow the menus. OR Enter *diag* Select *Task Selection (Diagnostics, Advanced Diagnostics, Service Aids, etc.)* Page down and select *Download Microcode* Select the device(s) by pressing enter for appropriate devices *ent*** 10/100 Mbps Ethernet PCI Adapter II* * (1410ff01)* Press F7 to commit devices to download. Select source of microcode image */etc/microcode* Press enter when prompted to download the microcode and follow screen instructions. Upon completion, a message will state that the firmware has be successfully downloaded and that the new level is SCU015. *To enable the interface, you may either use smit or AIX command line.* Exit. ------------------------------------------------------------------------ 6.0.3 Updating the Adapter's Microcode from directly from Microcode CD-ROM via Diagnostic Task Selection Menu CAUTIONS/WARNINGS: Do not power down or reset the node while the update is in progress. If process is interrupted, the adapter may be left in an indeterminate state and may not be able to do NIM boots. You MUST manually detach the LAN interfaces from the networks to run the Diagnostic Task Selection Menu update process. The adapter interfaces will be unavailable after the flash utility completes until you perform one of the steps below to bring the interfaces back up. *Before updating microcode directly from Microcode CD-ROM, please review information in **_Section 6.0.0 Updating the Adapter's Microcode_ <#6.0.0> * *Note: You must have the following filesets or later installed to flash the image file directly from the Microcode CD-ROM.* *AIX 43 and AIX 51 do NOT support flashing the image file directly from the Microcode CD-ROM.* *AIX 52: APARS needed are IY** 52961 and IY53608 fileset - devices.pci.1410ff01.diag level 5.2.0.30* *AIX 53 and later: included in all releases* From the command line login, log in as root. Use the following command: *diag** -d ent(x) -T download* and follow the menus. OR Enter *diag* Select *Task Selection (Diagnostics, Adanced Diagnostics, Servicd Aids, etc.)* Page down and select *Download Microcode* Select the device(s) by presssing enter for appropriate devices *ent*** 10/100 Mbps Ethernet PCI Adapter II* * (1410ff01)* Press F7 to commit devices to download. Select source of microcode image */cd0 (an example resource)* Press enter when prompted to download the microcode and follow screen instructions. Upon completion, a message will state that the firmware has be successfuly downloaded and that the new level is SCU015. Exit. *To enable the interface, you may either use smit or AIX command line.* ------------------------------------------------------------------------ 7.0.0 Machine Records Update This is a "Use As Required" microcode change. *_Back to Contents <#Contents>_ * ------------------------------------------------------------------------