Release Notes for One-Boot Flash Update Utility(OFU) Version 13.1 Build 13 Jun 14, 2016 Copyright (c) 2016 Intel(R) Corporation. ===================================== Contents -------- 1. Introduction 2. Supported Platforms 3. Supported Operating Systems 4. Pre-requisites 5. Installation and Un-installation 6. Usage 7. Known Issues 8. Unsupported Features 9. Change List 10. Instructions for end-user 11. Legal Information 1. Introduction --------------- The One-Boot Flash Update Utility is a program used for updating the system BIOS, BMC, Sensor Data Records (SDR), Field Replaceable Unit (FRU) and ME of systems. 2. Supported Platforms -------------------------------- Intel(R) Server Board based on Intel(R) Xeon(R) processor E5-1600/2600/4600 v2 product family Intel(R) Server Board based on Intel(R) Xeon(R) processor E5-2400 v2 product family Intel(R) Server Board based on Intel(R) Xeon(R) processor E5-2600 v3/v4 product family Intel(R) Server Board based on Intel(R) Xeon(R) processor E3-1200 v2/v3/v4 product family 3. Supported Operating Systems ------------------------------ Windows* Server 2012 R2 EM64T Windows* Server 2016 EM64T Windows* 10 EM64T Windows* PE 4.x EM64T RHEL* 6.x and 7.x EM64T CentOS* 7.x EM64T SuSE* 11.x and 12.x EM64T The below OSes are not supported after Build 11: Windows* Server 2012 Enterprise (32bit & EM64T) Windows* Server 2008 Enterprise (32bit & EM64T) Windows* Server 2008 R2 SP1 EM64T Windows* 7 (32bit & EM64T) Windows* PE 3.x (32bit & EM64T) Windows* PE 4.x 32bit RHEL* 6.x 32 bit CentOS* 6.x 32 bit SuSE* 11.x 32 bit 4. Pre-requisites ----------------- 1. Install all the development and optional packages during RHEL* and SuSE* Operating system installation. 2. On RHEL* 6.x and RHEL* 7.x OS a. If the utility fails with error message "error while loading shared libraries: libncurses.so.5: cannot open shared object file: No such file or directory" Then install libstdc++-4.4.4-13.el6.i686.rpm and ncurses-libs-5.7-3.20090208.el6.i686.rpm from the OS CD itself using the below commands. #rpm -ivh libstdc++-4.4.4-13.el6.i686.rpm #rpm -ivh ncurses-libs-5.7-3.20090208.el6.i686.rpm example: rpm -ivh media\Packages\libstdc++-4.4.4-13.el6.i686.rpm where CD/DVD is mounted to "media" directory. b. If the utility fails with error message "Error: /lib/ld-linux.so.2: Bad ELF interpreter: No such file or directory" This indicates development and optional packages are not installed, please install the necessary packages accordingly. 3. On RHEL*, SLES*, CentOS*, UEFI aware Linux or other Linux 1. There might be a driver conflict between internal driver and kernel. You need to start up OpenIPMI driver. If the utility fails with any error such as "FW interface failed" when updating BMC or "terminate called after throwing an instance of 'ResultStatus' Aborted (core dumped)" when updating SDR with CFG file, then start up OpenIPMI driver and make sure "/dev/ipmi0" device is existed. BMC update cannot continue if OpenIPMI driver is not started. For RHEL* 6.x run the below command and make sure "/dev/ipmi0" device is existed. #modprobe ipmi_devintf For RHEL* 7.x run the below command and make sure "/dev/ipmi0" device is existed. #modprobe ipmi_si For SLES* run the below command and make sure "/dev/ipmi0" device is existed. #service ipmi start 2. After enabling OpenIPMI, if utility still reports errors during BMC, FRU and SDR update, for example "Failed to write SDR file.", "SDR auto-update failed" and "Error : Error while parsing the cfg file", there might be a BMC watch dog conflict with OpenIPMI driver. User needs to disable BMC watch dog, do update and enable it after update is finished. 4. Utility works only if it is executed with Administrator privilege on Windows* and with root privilege on Linux* OSes. 5. Updating of BIOS, ME, FRUSDR and BMC is not supported by the utility if the BMC Firmware is in Transfer Mode. 6. It's recommended to do a direct FRU update in EFI/WinPE before doing a FRU Resize with customized CFG file. 5. Installation and Un-installation ----------------------------------- Windows* Installation: ------------ 1. Copy the OFU zip package to local folder. 2. Unzip to local folder (example: .\flashupdt). Go to flashupdt folder (cd Flashupdt). 3. Go to the Drivers\Win folder, choose x86 or x64 (depending on the operating system). 4. Run "install.cmd" as administrator to install drivers. 5. Go to Win_x86 folder to execute flashupdt utility, the binaries are common for both x86 and x64 versions of Windows* Operating system. 6. Now you can run command with options (example: "flashupdt -u /tmp/flashupdt.cfg") Uninstallation: --------------- 1. Run uninstall.cmd to uninstall all the drivers. 2. Delete the Flashupdt folder. Linux* I. RPM Installation: ----------------- 1. Copy flashupdt rpm from Linux-RPM-package (for RHEL or SLES) to local folder. 2. If there is another version already has been installed previously, uninstall that version first before installing the new version. 3. Install flashupdt utility by using "rpm -ivh flashupdtxx.rpm". This will install the utility in "/usr/bin/flashupdt/". 4. On RHEL/SLES after installing the rpm close the terminal from which rpm was installed and then execute utility from a new terminal (example: "# flashupdt -u /tmp/flashupdt.cfg"). 5. For HTTP and FTP based updates please execute the utility from "/usr/bin/flashupdt/" as 'curl' and 'chaff2l.sh' files are needed for HTTP and FTP based updates. RPM Uninstallation: ------------------- 1. To uninstall the utility use "rpm -e flashupdt" command. II. Regular Installation: --------------------- 1. Copy the OFU zip package (for RHEL or SLES) to local folder. 2. Unzip to local folder (example: .\flashupdt). Go to flashupdt folder (cd flashupdt). 3. # chmod 755 install.sh and # chmod 755 flashupdt 4. Install the utility using the command: "#./install.sh" 5. Go to the RHEL or SLES directory (based on operating system). 6. # chmod 755 chaff2l.sh and #chmod 755 curl. 7. Unzip the file flashupdt.zip to get flashupdt executable for Linux* OS 8. Now you can run command with options (example: "# ./flashupdt -u /tmp/flashupdt.cfg") Regular Uninstallation: ----------------------- 1. Delete the Flashupdt folder using rm -rf Flashupdt command. 6. Usage -------- Syntax: flashupdt [-h] [-i] [-u {URL or path of update package}] where -h : (or -?) Display command line help. -i : Displays the current BIOS, BMC, and SDR versions of the system. This option can also be used in conjunction with -u to display the version information contained in the update package files. -u : Updates the BIOS, BMC and SDR as specified in the CFG file. The URL or path, if any, of the update package must immediately follow this option. The package files can reside on a local drive. The current directory is used if no location is specified. -set: Sets different FRU area as below flashupdt /set "area name" "frufield" "value" Were "area name" can be "product" or "chassis" depending on the FRU area to be modified. The following are the FRU field parameters. Pn - indicates product name Pver - indicates product version Pnum - indicates the part number Snum - indicates the serial number Mn - indicates the manufacturer name At - asset tag Note: For the chassis area, the fields "at", "pn" and "pver" are not supported. -u fru : Will do a direct update of platform specific FRU file. 7. Known Issues --------------- 1. While using the tags "@ENV:TYPE:NAME" and "@ENVFILE:TYPE:NAME:#" make sure that the environment variable values should be greater than one character. If only one character is used there might be a chance of FRU getting corrupted. 2. In Windows 7, BIOS update percentage might not be showed at the beginning of BIOS update. After a few seconds, the percentage will be showed and greater than 50%. This is a BIOS known issue. 3. In Linux, OpenIPMI driver needs to be started up manually. 4. Utilities, SNMP-SA and IASC cannot run at the same time due to KCS port conflict. There will be an error message as below. "Error: Application Cannot Communicate to the BMC." Please do the below steps. a. Disable services related to SNMP-SA and IASC b. Enable OPENIPMI driver c. Execute flashupdt utility for updating BIOS/BMC/FRUSDR on the server 5. The BMC update with force update jumper set is not supported. It is applicable only to UEFI(FWPIAUPD). 6. IO port access is not allowed in Linux when UEFI secure boot is enabled. Please disable UEFI secure boot in F2 menu before running utility. 7. In Linux RHEL 7.x, BMC update might be failed intermittently due to OpenIPMI driver conflict. Please try again if it happens. 8. Unsupported Features ------------------------ Utility cannot be executed successfully when UEFI secure boot is enabled under Linux because Linux closes all IO port access when UEFI secure boot is enabled. If customer wants to use it under Linux environment, please ensure UEFI secure boot is disabled in BIOS F2 menu. 9. Change List ---------------------------- Build 11 Add HSBP or PSU FW update status check after BMC update. Build 12 Enable product name update in FRU board area. Build 13 ReleaseNotes OS list update. Add wildcard letter support in *.cfg file. 10. Instructions for end-user ---------------------------- 1. After performing CFG based update using flashupdt utility, it is highly recommended to perform a power cycle. Continuous updates through CFG file without power cycle / reboot in between could cause system instability. 2. For CFG based update it is assumed that the HTTP/FTP server does not require any user name password. In order to access password protected servers, please change the chaff2l.sh or the batch file and include the username/password. The default in the .sh file - ./curl $1 -o $2 -s For password protected server please change the above as below - ./curl $1 --user admin:pwd -o $2 -s where admin & pwd are the username and password respectively 11. Legal Information -------------------- ======================================================== LEGAL INFORMATION ======================================================== Information in this document is provided in connection with Intel Products and for the purpose of supporting Intel developed server boards and systems. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. Except as provided in Intel's Terms and Conditions of Sale for such products, Intel assumes no liability whatsoever, and Intel disclaims any express or implied warranty, relating to sale and/or use of Intel products including liability or warranties relating to fitness for a particular purpose, merchantability, or infringement of any patent, copyright or other intellectual property right. Intel Corporation may have patents or pending patent applications, trademarks, copyrights, or other intellectual property rights that relate to the presented subject matter. The furnishing of documents and other materials and information does not provide any license, express or implied, by estoppel or otherwise, to any such patents, trademarks, copyrights, or other intellectual property rights. Intel products are not intended for use in medical, life saving, or life sustaining applications. Intel may make changes to specifications and product descriptions at any time, without notice. Intel is a registered trademark of Intel Corporation. *Other names and brands are the property of their respective owners. Copyright (c) 2016 Intel Corporation. (end)