cpqimlview(8) cpqimlview(8) NAME cpqimlview - hp ProLiant Integrated Management Log Viewer SYNOPSIS cpqimlview DESCRIPTION The cpqimlview utility provides a Tcl/Tk-based graphical and a text (ncurses) interface to the hp ProLiant Integrated Management Log (IML). It displays the system events, critical errors, power-on messages, mem- ory errors and any catastrophic hardware or software errors that typi- cally cause a system to fail, and allows the manipulation of this data. The graphical version of the cpqimlview utility is based on Tcl/Tk and uses Tixwish to launch the application. The user needs to install these packages on systems where the graphical version of the cpqimlview utility will be used. The text version of the cpqimlview utility uses the standard "ncurses" library to provide windowing functionality. The "ncurses" interface uses the "Tab" key to switch between the menu bar at the top and the data displayed on the bottom. When the data area in the lower part of the display is selected, there will be a "double box" around the data area. When the menu bar is selected, there will only be a "single box" around the data area. This is all typical of ncurses text interfaces. The user should only launch the ProLiant Integrated Management Log (IML) utility using the "cpqimlview" script file provided. The script will determine whether to run the graphical (i.e. Tcl/Tk) version or the text (i.e. ncurses) version of the IML viewer. If the text based version is forced to run in a graphical (or X Windows) evironment, the ncurses "windows" may not display correctly. When using the text ("ncurses") based IML viewer and the data area in the lower part of the display is selected, the arrow keys can be used to scroll vertically and horizontally through the data area to view all the records. There are no scroll bars or indicators in this interface. The graphical interface is fully functional and is easier to use than the ncurses text interface. The ncurses text interface is designed for servers such as in a "headless" (i.e. Server Blade) environment or when using telnet to connect to a server and a graphical interface is not available. Each event in the IML Viewer has one of the following statuses to iden- tify the severity of the event: Informational - General information about a system event. Repaired - An indication that the entry has been repaired. Caution - An indication that a non-fatal error condition has occurred. Critical - A component of the system has failed. The severity of the event and other information in the IML Viewer helps to quickly identify and correct problems, thus minimizing server health. Detail information about the most common events logged to the ProLiant Integrated Management Log (IML) can be found in the hpasm(4) man page. File Menu Options * Open... - open a previously saved file and display the contents in the IML Viewer. * Save As... - save the current entries of the IML to a file. This operation does not affect the current contents of the IML. This allows archival of IML data for input into a text editor or spreadsheet application or other IML Viewer utility. The File Name entry should specify the full path for the desired file name. If no path is specified, the file will be saved in the current directory. * Exit - close the IML Viewer window and exit the application. Log Menu Options * Clear All Entries - clear the IML. It is recommended to save the current contents into a file before emptying the log. * Mark As Repaired - mark a specific entry as repaired. * Add Maintenance Note - mark a specific entry with maintenance information. Note that there is a 228 character limit to the field but there is no warning that the limit has been exceeded until the "OK" button has been pressed. This is a limitation of the TK tool used to create the IML Viewer. View Menu Options * Filter - filter IML events to display only desired event types. * Refresh Now - re-read and re-display entire current IML. * Sort Events - sort IML events by event types. Known Issues Text (ncurses) version is not fully functional The text (ncurses) version is not fully functional. This ver- sion will allow the IML log to be viewed, saved, an entry to be marked repaired or the entire log to be cleared. Display issues on RedHat 8.0 distributions There is an issue on RedHat 8.0 distributions when using the text based (ncurses) version of the cpqimlview utility. Other "ncurses" applications are also affected. RedHat is aware of the issue and is investigating. Special Features If the IML Viewer is started immediately after the hpasm package is installed or after the package is loaded, there may be a delay up to one minute before anything is displayed. This is a result of all access blocked to the driver until initialization completes. The driver initialization can be extensive on some ProLiant servers due to the number of features (such as fans) to be initialized and monitored. FILES /sbin/cpqimlview The script used to launch the text and the graphical based IML viewer. /sbin/hpimlview This is the "ncurses" (or text) version of the IML viewer. This should not be executed independently of the cpqimlview script file or unexpected results may occur. This application may not display correctly in an X Windows environment as it is designed for text mode. /sbin/imlbe This is the "backend" application for the Tcl/Tk IML viewer. This should never be executed directly from the command line. SEE ALSO hpasm(4) AUTHOR Hewlett-Packard Company Copyright Notice copyright 2002 Compaq Information Technologies Group, L.P. 2 October 2002 cpqimlview(8)