Release Notes for System Configuration Utility(Syscfg)
Version 13.1 Build 9

May 07, 2015
Copyright (c) 2015 Intel Corporation.
=====================================

Contents
--------

1. Introduction.
2. Supported Intel(R) Server Boards.
3. Supported Operating Systems.
4. Pre-requisites.
5. Getting started.
6. Usage.
7. Reference Documentation.
8. Known Issues.
9. New/Unsupported Features & Changes
10. Legal Information.


1. Introduction
---------------
   
The Save and Restore System Configuration utility (syscfg) is used for saving and restoring Firmware and BIOS 
settings to a binary/INI file, and for configuring Firmware and BIOS settings via a command line interface.

2. Supported Intel(R) Server Boards
----------------------
 
   Intel(R) Server Board S2600 series (Intel(R) Xeon(R) processor E5-2600 v3 product family)  
   Intel(R) Server Board S1200RP series
   Intel(R) Server Board S1200, S1400, S1600, S2400, S2600, S4600 series 
   
3. Supported Operating Systems
------------------------------

   UEFI 2.1/2.3.1
   Windows* Server 2012 R2 EM64T
   Windows* Server 2012 Enterprise (32 bit & EM64T)
   Windows* Server 2008 R2 SP1 EM64T
   Windows* Server 2008 SP2 (32 bit & EM64T)   
   Windows 7 (32 bit & EM64T)
   Windows 8 (32 bit & EM64T)
   Windows 8.1 (32 bit & EM64T)
   WinPE* 3.x/4.x (32 bit & EM64T)
   RHEL6* update1/update2/update3/update4/update5 (32 bit & EM64T)
   RHEL7*
   CentOS* 6.x (32 bit & EM64T)
   SLES* 11 SP1/SP2/SP3 (32 bit & EM64T)
   SLES* 12

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

   1. On RHEL* 6 update1/update2 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.
   
   2. On RHEL*, SLES*, CentOS*, UEFI aware Linux or other Linux
      There might be a driver confliction between internal driver and kernel. You need to start up OpenIPMI driver and make sure "/dev/ipmi0" device is existed.
	  
      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.
         #/etc/init.d/ipmi start
   
5. Getting started
------------------

   1. For 32 bit Windows and WinPE, go to folder "SysCfgxx\Drivers\win\x86" and run "install.cmd" as administrator to install ipmi, smi and memory map drivers.
   2. For 64 bit Windows and WinPE, go to folder "SysCfgxx\Drivers\win\x64" and run "install.cmd" as administrator to install ipmi, smi and memory map drivers.
   3. For 32/64 bit Windows and 32 bit WinPE, please use syscfg in "SysCfgxx\Win_x86".
   4. For 64 bit WinPE, please use syscfg in "SysCfgxx\Win_x64".
   5. Linux*   
     I.  RPM Installation:
         --------------------
          1. Copy syscfg rpm from "Linux" folder (for RHEL or SLES) to local folder.
          2. Install syscfg utility by using "rpm -ivh syscfgxx.rpm". This will install the utility in "/usr/bin/syscfg/"	
          3. On RHEL utility can now be executed from any terminal (example: "# syscfg -i").
          4. On SLES after installing the rpm close the terminal from which rpm was installed and then execute utility from a new terminal (example: "# syscfg -i").
         RPM Uninstallation:
         -------------------
          1. To uninstall the utility use "rpm -e syscfg" command.
     II. Regular Installation:
         ---------------------
          1. Linux OS version, unzip package and use "# chmod 755" to change executable. The executable can be executed directly. 
        
6. Usage
--------
   1. Command line Interface

      Linux Shell>> ./syscfg [Switches] [parameters]
			 			 
      Examples
      --------
      a. To display the system BIOS/BMC Version:

             >> ./syscfg -i

      b. To display the BIOS Parameters:

             >> ./syscfg /d biossettings <"BIOS variable Name">
	     >> ./syscfg /d biossettings group <"BIOS Group Name"> <"BIOS variable Name">

      c. To Set the BIOS Parameters:

             >> ./syscfg /bcs <AdminPw> <"BIOS variable Name"> <Value>
	     >> ./syscfg /bcs <AdminPw>  <"BIOS Group Name"> <"BIOS variable Name"> <Value>

         Note: If AdminPw is not set use ""

 * "BIOS Group Name" and "BIOS variable Name" should be the same as shown in BIOS F2 screen.
 * "AdminPw" is the BIOS administrator password if not set use "". 

      d. To save BIOS and BMC settings to INI file use
   
            >> ./syscfg /s BIOSBMC.ini /b /f
                 or
            >> ./syscfg /s BIOSBMC.ini

      e. To save only BIOS settings to INI file use

            >> ./syscfg /s BIOS.ini /b 

      f. To save only BMC settings to INI file use

            >> ./syscfg /s BMC.ini /f


      g. To restore BIOS and BMC settings from saved INI file use
   
            >> ./syscfg /r BIOSBMC.ini /b /f
                
            Note: If AdminPw is set use 

            >> ./syscfg /r BIOSBMC.ini /b /f /bap <"AdminPw">

          
      Windows and UEFI Shell>> syscfg [Switches] [parameters]
			 			 
      Examples
      --------
      a. To display the system BIOS/BMC Version:

             >> syscfg -i

      b. To display the BIOS Parameters:

             >> syscfg /d biossettings <"BIOS variable Name">
	     >> syscfg /d biossettings group <"BIOS Group Name"> <"BIOS variable Name">

      c. To Set the BIOS Parameters:

             >> syscfg /bcs <AdminPw> <"BIOS variable Name"> <Value>
	     >> syscfg /bcs <AdminPw>  <"BIOS Group Name"> <"BIOS variable Name"> <Value>

         Note: If AdminPw is not set use ""  

 * "BIOS Group Name" and "BIOS variable Name" should be the same as shown in BIOS F2 screen.
 * "AdminPw" is the BIOS administrator password if not set use "". 


      d. To save BIOS and BMC settings to INI file use
   
            >> syscfg /s BIOSBMC.ini /b /f
                 or
            >> syscfg /s BIOSBMC.ini

      e. To save only BIOS settings to INI file use

            >> syscfg /s BIOS.ini /b 

      f. To save only BMC settings to INI file use

            >> syscfg /s BMC.ini /f


      g. To restore BIOS and BMC settings from saved INI file use
   
            >> syscfg /r BIOSBMC.ini /b /f
                
            Note: If AdminPw is set use 

            >> syscfg /r BIOSBMC.ini /b /f /bap <"AdminPw">


7. Reference Documentation
--------------------------
  
    IPMI v2.0 specification
    SYSCFG Utility User Guide
    
8. Known Issues
---------------
     
  1. To be noted, any BIOS setting changed by SYSCFG, it requires reboot to make BIOS setting change take effective.
  2. Reordering boot devices using /bbo should be followed by a system reset as per IPMI spec. 
     Otherwise an immediate display command using /bbo switch may not display the correct boot device order.
  3. Restore of BIOS variables will not work for Read only variables or variables which may become read only due to dependent variables.
  4. BIOS variables with leading/tailed space can't be restored successfully.
  5. As some BIOS settings have dependencies, using syscfg INI file to save/restore BIOS settings only once may not be able to achieve the goal. 
     The solution is to use command line or INI file to change/restore twice. 
     For example, if you want to restore "ATS Support", you have to restore "Intel(R) VT for Directed I/O" from "Disable" to "Enable" first in order to make "ATS Support" visible, then to do second restore to change "ATS Support" value. Upon system reboot, the new BIOS settings will take effect.
  6. Utilities, SNMP-SA and IASC cannot run at the same time due to KCS port conflict. There will be error message 
     "Error: Application Cannot Communicate to the BMC.".
  7. The settings under server management are saved in BMC. For some of the settings under server  
     management, after a reboot the values from BMC will override the values set through "/bcs" switch.  
	 
           The following settings will be overwritten 
                1. Resume on AC Power Loss
                2. Shutdown Policy
     "Resume on AC Power Loss" BIOS variable can be set using BMC switch "/prp".
     "Shutdown Policy" BIOS variable can be set using BMC switch "/sdp".
     Please refer to the help for more details.
  8. When using syscfg to get BIOS setting, there will be some difference between UEFI shell and OS. For example, syscfg cannot get "Processor PCIe Link Speed" in OS.
  
  For Intel (R) Server Board S1200RP/S1200/S1400/S1600/S2400/S2600/S4600 series:
    1. Make sure that BIOS variables saved in the INI file should have some default value, 
       if it has empty/null then while restoring utility will fail with Error message.
    2. The settings under server management are saved in BMC. For some of the settings under server management, 
       after a reboot the values from BMC will override the values set through "bcs" switch.  

           The following settings will be overwritten 
                1. Resume on AC Power Loss
                2. Clear System event log.
        However "Resume on AC Power Loss" BIOS variable can be set using BMC switch "/prp", please refer to the help for more details.                   
    3. Reordering boot devices using /bbo should be followed by a system reset as per IPMI spec. 
       Otherwise an immediate display command using /bbo switch may not display the correct boot device order.
    4. Make sure that "Static Boot Order" is disabled if using /bbo to reorder boot devices. 
	   Otherwise the expected boot order can only apply to next boot.
    5. /sole option will not work and receive error messages.
    6. For /bup option, if the new user password is same as current admin password, syscfg would not throw error in EFI.

9. New/Unsupported Features & Changes
------------------------
   New Features
   None.
   
   Unsupported Features
   None.
  
   Changes
   Fix: "Alert Destination Type"  will  be changed automatically after run command with /lacipv6 option
   Fix: Run "syscfg /bbosys "" " to change boot order won't take effective once after use "syscfg /bbo "" " change
   Fix: Shutdown policy will not display the correct value in F2 BIOS setup after Syscfg set the value(refer to known issue 6)

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



(end)


