FPGA Firmware Update for Windows Installation README File Version: 4.01 BUILDID: G0UD88B (C) Copyright International Business Machines Corporation 2011. All rights reserved. US Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. CONTENTS ________ 1.0 Overview 2.0 Installation and Setup Instructions 3.0 Configuration Information 4.0 Unattended Mode 5.0 Web Sites and Support Phone Number 6.0 Trademarks and Notices 7.0 Disclaimer 1.0 Overview 1.1 This README file contains the latest information about installing the FPGA firmware update. 1.2 Limitations: - This flash utility is only able to update systems in which the Integrated Management Module (IMM) or Advanced Management Module (Blade systems only) can be reached via an ethernet connection. If the IMM cannot be reached due to lack of a connection or firewall protections, then the update will fail. 1.2.1 If the system being flashed is in DC Stand-by (Powered OFF) during the FPGA flashing, the system will automatically re-load the FPGA with the new version when the flash update completes. 1.2.2 If the system being flashed is Powered ON during the FPGA flash update, the new version of the flash update will be loaded after the the system has been powered down to the stand by state, then powered back on. For Blade systems, the AMM firmware VPD listing may not reflect the new version for up to 30 minutes after it is loaded. 1.3 Enhancements: - Refer to the change history file ibm_fw_fpga_G0UD88B_anyos_i386.chg for a history of enhancements and fixes. 1.4 Recommendations and Prerequisites for the Update: - In Windows 2008, the firewall may be enabled by default. In some configurations, this could prevent the flash utility from succeeding. The firewall may need to be disabled if it is suspected to be preventing the update traffic. - Updating the FPGA firmware using the Integrated Management Module(IMM) ethernet over USB interface requires operating system drivers and configuration for the USB interface. In order to install the device driver for LAN-over-USB device, there must be no network device on the system configured with an IP adress of 169.254.x.y other than the IBM USB Remote NDIS Network Device (the LAN-over-USB device). The update package will attempt to perform the setup if needed. If the automatic setup fails or it is desired to setup the USB LAN via manual intervention, the following process can be used: Windows Driver Installation =========================== Perform the following steps to install ibm_rndis_server_os.inf: These steps only need to be performed if the server is running a Windows operating system and the ibm_rndis_server_os.inf file has not been previously installed. The INF needs to be installed only once. It is required by Windows operating systems to detect and use the IMM's Ethernet over USB functionality. a). Extract the ibm_rndis_server_os.inf and device.cat files from this update package and copy them to the \WINDOWS\inf subdirectory. b). Go to Computer Management then Device Manager and find the RNDIS Device. Select properties -> Driver -> Reinstall driver Point the system to the \Windows\inf folder where it will find the .inf file and install the device. c). Go to Computer Management then Device Manager and right-click on "Network adapters" and select "Scan for hardware changes". You should see a small popup that says "Found New Hardware" and "Ethernet Device". d). The New Hardware Wizard should start automatically. When it asks "Can Windows connect to Windows Update to search for software?" select "No, not this time". Then click Next to continue. e). When it asks "What do you want the wizard to do?" select "Install from a list or specific location (Advanced)". Then click Next to continue. f). When "Please choose your search and installation options" is displayed, select "Don't search. I will choose the driver to install." Then click Next to continue. g). When "Select a hardware type, and then click Next." is displayed, select "Network adapters". Then click Next to continue. h). When the dialog comes up, displaying "Completing the Found New Hardware Wizard". Click Finish. i). A new Local Area Connection should come up. (for example Local Area Connection 4) and may state "This connection has limited or no connectivity." You can ignore this message. j). Go back to the Device Manager. "IBM USB Remote NDIS Network Device" should now show up under "Network Adapters". k). Open a command prompt and type "ipconfig". You should see the "Local Area Connection" for the IBM USB RNDIS and it should have an IP address in the range 169.254.xxx.xxx. l). Go to Start -> Control Panel -> Network Connections. Right click on the device named "IBM USB RNDIS Network Device" and select "properties". m). In the scroll down box, select "Internet Protocol(TCP/IP)" and click on the properties button. n). Select the radio button labeled "Use the following IP address". In the IP address field put an address in the range 169.254.95.xxx with a Subnet mask of 255.255.0.0. The recommended value for this step is 169.254.95.119. o). Click the advanced button in the lower corner of the window. Under the "IP Settings" tab click the "Add..." tab in the "IP addresses" frame. p). In the IP address field, put an address in the range 169.254.95.xxx with a subnet mask of 255.255.255.0. The recommended value for this step is 169.254.95.120. q). Click the add button, the OK button for the "Advanced TCP/IP Settings" window, and the OK button for the "Internet Protocol(TCP/IP) Properties" window. Then click close on "Wireless Network Connection Properties". 2.0 Installation and Setup Instructions The procedures to update the FPGA are as follows: Note: In Windows 2008, the firewall may be enabled by default. In some configurations, this could prevent the flash utility from succeeding. The firewall may need to be disabled if it is suspected to be preventing the update traffic. 2.1 Using the Windows graphical user interface - Run the FPGA Update by clicking the .EXE - Choose "Perform Update" and click the "Next" button - If the update is meant for the system on which it is running, the "Update" button will appear. Click the "Update" button to continue. - Click the "Exit" button. 2.1.1 Using the Windows command line interface - Run the FPGA Update with the following command line: "ibm_fw_fpga_G0UD88B_windows_32-64.exe -s" Note: "-u" is a supported synonym for command line switch "-s". - Optional command line parameters supported by the update --backup Target the secondary/alternate flash bank if available. If a alternate device is not supported, the IMM may ignore this option. --no-reboot If the firmware type being updated requires an activation step to be performed by the utility, this option will prevent that step. --user This option provides a method of setting the IMM user name to use during a LAN IPMI session. Use of this option will disable the IPMI KCS authentication failover. --password This option provides a method of setting the IMM password to use during a LAN IPMI session. --silent This option turns off text output from the update process. Use of this option also turns on the --unattended option. 2.2 Perform the following steps to update the FPGA firmware using the web interface: a). Open a Web browser. In the address or URL field, type the IP address or host name of the IMM or AMM to which you want to connect. The Login web page opens. Note: The IMM or AMM defaults to DHCP. If a DHCP host is unavailable, the IMM or AMM assigns a static IP address of 192.168.70.125. b). Type your user name and password on the Login page. If you are using the IMM for the first time, you can obtain your user name and password from your system administrator. All login attempts are documented in the event log. A welcome page opens in your browser. Note: The IMM or AMM is set initially with a user name of USERID and password of PASSW0RD (with a zero, not an O). This user has read/write access. Change this default password during your initial configuration for enhanced security. c). Select a timeout value, in minutes, in the field provided. If your browser is inactive for that number of minutes, the IMM or AMM logs you off the Web interface. d). Click Continue to start the session. The browser opens the System Health page, which gives you a quick view of the system status. e). In the navigation frame, click Firmware Update under Tasks on IMM, or Blade Tasks on AMM, then click Browse. f). Navigate to this package (ibm_fw_fpga_G0UD88B_linux_32-64.bin) and click Open. The file (including the full path) appears in the box beside Browse. g). To begin the update process, click Update. A progress indicator opens as the file is transferred to temporary storage on the IMM. A confirmation page opens when the file transfer is completed. h). Verify that the upd file shown on the Confirm Firmware Update page is what you intend to update. If not, click the Cancel button. i). To complete the update process, click Continue. A progress indicator opens as the firmware is flashed. A confirmation page opens to verify that the update was successful. j). After receiving a confirmation that the update process is complete, click OK. 2.3 Extracting the update contents Contents of the ibm_fw_fpga_G0UD88B_windows_32-64.exe update package: - This readme file - The FPGA firmware update file named ibm_fw_fpga_g0ud88b-4.01_anyos_i386.upd - An INF file, named ibm_rndis_server_os.inf and a CAT file, named device.cat are required by Windows operating systems to detect and use the IMM's Ethernet over USB functionality. - A 32-bit flash utility named iflash.exe - A 64-bit flash utility named iflash64.exe 2.3.1 Windows extraction graphical user interface - Run the FPGA Update by clicking the .EXE - Choose "Extract to Hard Drive" and click the "Next" button - Select a folder to extract the files and click OK. - Click the "Exit" button. 2.3.2 Windows extraction command line - Run the FPGA Update with the following command line: "ibm_fw_fpga_G0UD88B_windows_32-64.exe -x " where is the path to which the Windows update files will be extracted. 2.3.2.1 Mandatory command line parameters supported by iflash --package This option designates the update file to be processed by iflash. Typically, updates are upd files included in the update packages. The update file contained in this package is ibm_fw_fpga_g0ud88b-4.01_anyos_i386.upd. 2.3.2.2 Optional command line parameters supported by iflash --user This option provides a method of setting the IMM user name to use during a LAN IPMI session. Use of this option will disable the IPMI KCS authentication failover. --password This option provides a method of setting the IMM password to use during a LAN IPMI session. --unattended This option turns off the prompt for user confirmation of the update. The utility will not prompt the user and only continue with the update if it determines the firmware on the target is downlevel. --force Attempt to update even if the target is not downlevel. No prompt for user confirmation will be shown. This option overrides the --unatttended option. --backup Target the secondary/alternate flash bank if available. If a alternate device is not supported, the IMM may ignore this option. --no-reboot If the firmware type being updated requires an activation step to be performed by the utility, this option will prevent that step. --password-file : Pass the name of a file containing the password to use during a LAN IPMI session. --skip_min_level: Bypass the hard check for minimum firmware level. This option is not recommended for most users but is made available for advanced uses. -s, --silent These options turn off text output from the update process. Use of these options also turns on the --unattended option. -h, -?, --help These options print the command usage details. 3.0 Configuration Information - This update package does not provide the ability to set or modify FPGA configuration settings. 4.0 Unattended Mode 4.1 Performing the update in unattended mode - Run "ibm_fw_fpga_G0UD88B_windows_32-64.exe -s" 4.2 Extracting the update files in unattended mode - Run "ibm_fw_fpga_G0UD88B_windows_32-64.exe -x " where is the path to which the Windows update files will be extracted. 5.0 Web Sites and Support Phone Number 5.1 IBM Support Web Site: http://www.ibm.com/systems/support 5.2 IBM Marketing Web Site: http://www-03.ibm.com/systems/x/ 5.3 If you have any questions about this update, or problems applying the update go to the following Help Center World Telephone Numbers URL: http://www.ibm.com/planetwide/index.html 6.0 Trademarks and Notices 6.1 IBM and the e(logo) are registered trademarks of International Business Machines Corporation. 6.2 U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Contract with IBM Corporation. IBM web site pages may contain other proprietary notices and copyright information which should be observed. Microsoft, Windows, and Windows NT are registered trademarks of Microsoft Corporation in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others. 7.0 Disclaimer THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.