Release notes for One-Boot Flash Update Utility
Version 12.0 Build 4

May 16, 2013
Copyright (c) 2013 Intel(R) Corporation.
=====================================

Contents
--------

1. Introduction.
2. Supported Intel(R) Server Boards.
3. Supported Operating Systems.
4. Pre-requisites.
5. Installation and Un-installation.
6. Usage.
7. Known Issues.
8. Supported features in the release.
9. Instructions for end-user.
10. 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 Intel(R) Server Boards
--------------------------------

	Intel(R) Server Board S1200RP platform series.
   
 
3. Supported Operating Systems
------------------------------

   Windows* Server 2008 R2 SP1 x64
   Windows* Server 2012 Enterprise
   RHEL6* update1/update2/update3/update4 (32 bit & EM64T)  
   SLES* 11 SP1/SP2 (32 bit & EM64T)


4. Pre-requisites
-----------------

   1. Install all the development and optional packages during RHEL* and SuSE* Operating system installation. 

   2. On RHEL* 6 update1 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* 6 update4 OS
      If the utility fails with error message "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 using the below command. (It will make sure "/dev/ipmi0" device is existed)
         #modprobe ipmi_devintf
            
   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." to install the 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. Install flasupdt utility by using "rpm -ivh flashupdt-Vxx.x-Bxx.ixxx.rpm". This will install the utility in "/usr/bin/flashupdt/"	
        3. 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").
        4. 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
        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 <FRU file name>: 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. 
  
          
8. Supported features in the release
------------------------------------

  1. This release supports feature of displaying Boot Area Information of BIOS.
  

9. 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


10. 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) 2013 Intel Corporation.



(end)



