Release Note for System Event Log (SEL) Viewer Utility
Version 10.0 Build 4
January 24, 2011

Copyright (c) 2010-11 Intel Corporation.

=======================================

Contents
---------

1. Introduction
2. Supported Platforms and Operating Systems
3. Pre-requisites
4. Installation and Un-installation
5. Usage
6. Known Issues
7. New/Unsupported Features
8. Instructions to End User
9. Legal Information

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

The System Event Log (SEL) viewer utility is used for displaying data from the  
BMC's system event log.

2. Supported Platforms and Operating Systems
--------------------------------------------

   Supported Platforms
      S1200BT series of platforms. 

   Supported Operating Systems
      UEFI 2.0
      Windows Server 2008 (32bit & EM64T)
      RHEL 6 (32bit & EM64T)
      SUSE 11 SP1 (32bit & EM64T)
     
3. Pre-requisites 
-----------------

   a. JRE must be installed to support the GUI of SEL Viewer utility. 
      SUN JRE can be downloaded from  
      http://www.java.com/en/download/manual.jsp#lin.
      
   b. On Linux after installing JRE, make sure that java would point 
      to the newly installed JRE. This can be done by creating a soft link
      (Can be created by using "ln -s <JRE_INSTALLATION_DIR>/bin/java /usr/bin/java".
   
      If the soft link already exists, delete the soft link and run the above command) 
      or by adding JRE installation directory to the system path 
      ("export PATH=<JRE_INSTALLATION_DIR>/bin:$PATH") where <JRE_INSTALLATION_DIR> is the 
      path of the directory where JRE is installed.

  
   c. Install JRE X32 version for supporting WinPE 2.0 (32 bit) OS and JRE X64 
      version for supporting WinPE 2.1 (EM64T) OS. Installation of JRE in a USB pen drive should be
      performed on the same version of the operating system i.e. for JRE x32 version use windows 32 bit OS
      and for JRE x64 version use Windows 64 bit OS. 

   d. In Windows/WINPE set the JRE path using "PATH=%PATH%;<>:\bin" (where <> is the USB directory shown on the cmd prompt i.e D: or E: etc. or the path where java is installed i.e. c:\Program Files\Java)

   e. While installing JRE on USB pen drive to support WinPE 2.0 and WinPE 2.1 
      change the installation directory USB pen drive (eg g:\).

4. Installation and Un-installation
-----------------------------------

   Installation:
   ---------------
  
 a. Master SELViewer package "SELViewerVxxx_BuildXX.zip" has all the executables intact with the following folder structure:

      SELViewerVxxx_BuildXX
      
      |------UEFI_x64
      |         |--selview.efi
      |         |--ipmi.efi      
      |         |--hrs_enu.ini
      |         |--selenus.hlp
      |         |--selenus.str
      |         |--SEL.ini 
      |         |--selview_gui.efi
      |         |--NShell.efi
      |         |
      |---Licenses
      |         |--EFIToolKit
      |         |    |--BSD-License-From-Intel.txt
      |         |--Others
      |         |    |--AES-License.txt.txt
      |         |    |--MD5_Message-Digest-License.txt
      |         |    |--SSL Implementation-License.txt
      |         |    |--NetBeansLicense.txt
      |         |----INTEL SOFTWARE LICENSE AGREEMENT WITH.doc
      |         |----license.txt 
      |         |   
      |------Windows
      |         |---x64
      |         |    |--imbdriver
      |         |    |    |--DeviceSetup.exe
      |         |    |    |--imbdrv.cat
      |         |    |    |--IMBDrv.inf
      |         |    |    |--imbdrv.sys
      |         |    |    |--install.cmd
      |         |    |    |--uninstall.cmd
      |         |    |----ui
      |         |    |    |--gui.jar
      |         |    |    |--appframework-1.0.3.jar
      |         |    |    |--beansbinding-1.2.1.jar
      |         |    |    |--swing-worker-1.1.jar
      |         |    |--selview.exe
      |         |    |--selview.bat
      |         |    |--imbapi.dll
      |         |    |--msipmi.dll
      |         |    |--hrs_enu.ini
      |         |    |--OpenSave.exe
      |         |
      |         |---x86
      |         |    |--imbdriver
      |         |    |    |--DeviceSetup.exe
      |         |    |    |--imbdrv.cat
      |         |    |    |--IMBDrv.inf
      |         |    |    |--imbdrv.sys
      |         |    |    |--install.cmd
      |         |    |    |--uninstall.cmd
      |         |    |----ui
      |         |    |    |--gui.jar
      |         |    |    |--appframework-1.0.3.jar
      |         |    |    |--beansbinding-1.2.1.jar
      |         |    |    |--swing-worker-1.1.jar
      |         |    |--selview.exe
      |         |    |--selview.bat
      |         |    |--imbapi.dll
      |         |    |--msipmi.dll
      |         |    |--hrs_enu.ini
      |         |    |--OpenSave.exe
      |         |
      |------Linux
      |         |---ui
      |         |    |--gui.jar
      |         |    |--appframework-1.0.3.jar
      |         |    |--beansbinding-1.2.1.jar
      |         |    |--swing-worker-1.1.jar
      |         |--selview.zip
      |         |--Selview.sh      
      
         
   b. For 32 bit windows, go to folder "windows\x86\imbdriver" and run install.cmd to install ipmi driver.
   c. For 64 bit windows, go to folder "windows\x64\imbdriver" and run install.cmd to install ipmi driver.
   d. For all supported Linux OS versions, the executables can be located in selview.zip unzip selview.zip and use the executable directly.
   e. For UEFI go to UEFI_x64 and execute the selview.efi in EFI shell.


   Un-installation:
   ---------------
    a. Run uninstall.cmd to uninstall all the drivers on Windows OS. 
    b. Manually delete the contents of the directory where the utility is installed for UEFI, Windows and Linux OS.

5. Usage
--------

   The following is the procedure to execute the SEL Viewer utility:

   I. GUI interface

      The SEL Viewer is invoked by entering the following command at a WINDOWS  prompt:
   
		selview	

      Shortcut keys for the SEL Viewer GUI for Windows and Linux OSes:

		'Alt  + F' to open the File menu
		'Alt  + S' to open the SEL menu
                'Alt  + H' to open the Help menu
                'Ctrl + S' to save the SEL entries to a file
		'Ctrl + O' to open a saved SEL file
		'Ctrl + Q  to exit the SEL Viewer GUI
                'Ctrl + R  to reload the SEL entries from the system
                'Ctrl + P  to View the properties window
                'Ctrl + K  to clear SEL
                'Ctrl + G  to go to a particular SEL record.
                'Alt  + V' followed by 'D' to Display in Hex
                'Alt  + V' followed by 'T' to Display in Text
                'Alt  + H' followed by 'A' to view the about window
                'F1' for General Help
               

   II. Command-line interface

      The SEL Viewer can be run as a command-line application for some of the actions that
      it performs, including clearing the SEL or saving SEL contents to a file.

		selview <switch> [SEL File Name] 

      a. To view the command-line help:

                selview /h or 
                selview /?  

      b. To clear the SEL entries:

                selview /clear
		
      c. To save the SEL entries to a file in hex format:

                selview hexlog.sel /save /hex or
                selview /save /hex hexlog.sel

      c. To save the SEL entries to a file in text format:

                selview textlog.sel /save or
                selview /save log.sel

* In place of '/', user can use '-' also.
* command line switches are case insensitive.

6. Known Issues
---------------
   
   Utility
   -------
   a. In UEFI GUI switching between the Menu and other windows (main window and SEL info window), the file menu is always seen highlighted.

   Operating System
   ----------------
   a. In RHEL 6 EM64T OS if the utility fails with error message "error while loading shared libraries: libncurses.so.5: cannot open shared object file: No such file or director      y" 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
          
7. New/Unsupported Features
------------------------

   a. RHEL 6 (32bit & EM64T) OS support.
  
8. Instructions to End User
---------------------------

   a. System needs to be updated with appropriate FRUSDR package.
   b. One needs to ensure that read-only attribute is disabled for SEL Viewer  
      utility's release folders before running SEL Viewer utility application. 
      If the release folders are read-only, user needs to disable the read-only  
      attribute of all the inner folders and all the files in the release folder,
      except for ReleaseNotes.txt file.

      If still user couldn't able to save the SEL entries to a file, it is wise  
      to do the following:
		a. Create a directory on your USB key or external hard disk,
		b. Copy SEL Viewer release files to the above created directory.
		c. Ensure that all the files are available in the folder.
		d. Run SEL Viewer application.

  c. Do not edit or delete or rename the SelView.bat, OpenSave.exe Selview.sh and Selview_gui.efi file from the installed 
     folder doing so will fail to launch the GUI and some GUI features.

  d. User cannot save the SEL entries to a file if the SEL Viewer application is running from CD ROM.
   
9. 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) 2010-11 Intel Corporation.



(end)
