RELEASE NOTES FOR Intel (R) System Information Retrieval Utility (sysinfo) ON Linux

Version 1.0 Build 1
Dec 16, 2010

Copyright (c) 2010 Intel 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. Legal Information.

1. Introduction
---------------

The System Information Retrieval UTILITY (sysinfo) used for 
collecting the system information. This utility dumps
the following information to log files:

    1. Platform Firmware Inventory

    2. sensor information

    3. Sensor Data Records
    
    4. BMC SEL (IN HUMAN READABLE FORM)

    5. BMC SEL (IN HEX FORM)
    
    6. Base Board FRU
    
    7. System BMC Boot Order

    8. BMC User Settings
    
    9. BMC LAN Channel Settings

    10. BMC SOL Channel Settings

    11. BMC Power Restore Policy Settings

    12. BMC channel settings

    13. SMBIOS Type 1, Type 2, Type 3
    
    14. Processor

    15. Memory

    16. Operating System Information

    17. List of device drivers installed

    18. List of s/w installed
    
    19. BIOS Settings (per BIOS SETUP F2 Screen).

    20. PCI Bus Device Information

    21. RAID settings and RAID log

    22. OS event log.

2. Supported Platforms
----------------------

     S5500 series of platforms,
     s5520 series of platforms;
     S3420 series of platforms(except S3420GPV);

Note: Platform must have a base board management controller with IPMI 2.0 support. 
      System Information Retrieval Utility will not support Intel Server Board S3420GPV
====

3. Supported Operating Systems
------------------------------

    RHEL 5.5 (32 bit & EM64T)
    SUSE 11 SP1 (32 bit & EM64T).

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

    1. Download the latest platform S/W stack (BIOS / FW / FRUSDR package) for the platform and install it. Ensure system
       is running with the latest platform S/W stack. For the latest platform S/W stack, refer the link http://support.intel.com

    2. System is booted and running with any of the supported operating systems.

5. Installation and Un-installation
-----------------------------------
     Installation
     ------------
   
     1. Copy the ZIP file into your local directory (e.g. /root/sysinfo/) on your Linux system.
     2. unzip using the standard Linux 'unzip' command
     3. GOTO Linux folder
     4. Run 'source install.sh' command on the shell prompt, to install the sysinfo components.
     5. Now run './sysinfo' on the shell promot, sysinfo logs
        system information in 4 different log files
            a. sysinfo_log.txt 
            ( Platform Firmware Inventory, Sensor information, Sensor Data Records, BMC SEL (IN HUMAN READABLE FORM), 
            BMC SEL (IN HEX FORM),  Base Board FRU, System BMC Boot Order, BMC User Settings, 
            BMC LAN Channel Settings, BMC SOL Channel Settings,  BMC Power Restore Policy Settings,
            BMC channel settings, SMBIOS Type 1, Type 2, Type 3, Processor,Memory,  Operating System Information, Device drivers installed,
            List of S/W installed, ).
                                
            b. RAID_NVRAMlog.txt (RAID settings and RAID log)
            c. PCI_Log.txt (PCI Bus info).
            d. OSEvents_Log.txt (operating System Events).

     Uninstallation:
     ---------------
     1. Run the './uninstall.sh' present in Linux
     2. Remove the Linux folder.

6. Usage
--------
   1. Command line Interface

             ./sysinfo
 
      a. To view the command-line help page:

             ./sysinfo -h or -?

      b. sysinfo logs system information in 4 log files (sysinfo_log.txt, RAID_NVRAMlog.txt, PCI_log.txt, OSEvents_log.txt).

             ./sysinfo

      c. sysinfo logs system information in 4 log files (sysinfo_log.txt, RAID_NVRAMlog.txt, PCI_log.txt, OSEvents_log.txt) in a non-interactive way.

             ./sysinfo -ni

7. Known Issues
---------------
      System BMC boot order may not displaying correctly.
      Similar errors as like "chcon: can't apply partial context to unlabeled file /opt/lsi/3rdpartylibs/libsysfs.so" may be displayed if your SELinux enabled when doing sysinfo installation bi "source install.sh"
      You may encounter error "sh: cat: command not found" when you perform "./sysinfo" to get sysinfo logs. It can be ignored.
       
8. Unsupported Features
-----------------------
      None.

9. Legal Information
--------------------
========================================================
                               LEGAL INFORMATION
========================================================

Informaton 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) 2010 Intel Corporation.
(end)