How the Log Viewer Works (Sun Java Communications Suite 5 Installation Guide)

Sun Java Communications Suite 5 Installation Guide

How the Log Viewer Works

The Communications Suite Log Viewer provides a graphical display for viewing the installer log messages in the Sun_Java_Communications_Suite_Install_log.timestamp file or the Sun_Java_Communications_Suite_UnInstall_log.timestamp file. There are three ways to filter messages so that the messages displayed are of sufficient importance or interest: by log level, by module ID, and by content.

Log level. There are eight log levels to choose from: SEVERE, ERROR, WARNING, INFO, CONFIG, FINE, FINER, and FINEST. If you select a log level, then only log records having that log level or are greater in severity are displayed. Selecting FINEST is equivalent to selecting all records for display.
Module ID. The module is the part of the installer that is writing the log message. If you select a module ID (JAVAESConfig, JAVAESInstall, or JAVAESUninstall), only messages associated with the module IDs you selected are displayed.
Content. The content filter prompts you for a string, such as “configure,” and then displays only those messages that contain that string.

Some typical filtering examples:

Display only the SEVERE log messages.
Display only the log messages with a log level greater than or equal to ERROR.
Display only the log messages from installation steps.
Display only the log messages from installation that have a log level greater than or equal to ERROR.
Save the result of a filtered scenario into a file.

The following table summarizes the basic functionality of the Log Viewer.

Table 10–2 Log Viewer Functions


Task	Capability
Open	Selects a log file for filter and display.
Save	Saves the filtered and translated messages into a file designated by the File>Save As option.
Save As	Chooses a separate file into which to write filtered and translated messages. Note: This file cannot exist in the directory used by the installer to store source logs.
Print	Prints the filtered and translated file.
Exit	Closes any open output file, closes the input file, and closes the Log Viewer page.
Filter for Log Level	Chooses a log level for filtering.
Filter for Module ID	Chooses none or one of the module IDs in the file you opened. The list is populated when you have chosen a log file for filtering.
Filter for Content	Selects messages that contain a user-defined string.
Choose Language	Chooses a translation language. Default is English. This list is populated from the translation resource bundles stored by the installer.

With this functionality, the Log Viewer can provide filtered information to help with your troubleshooting scenario. The messages that meet your filter criteria are displayed in a single log table. A row in the log table can then be selected for detailed display which allows a message to be displayed in a multiple line format.