Using the Log Viewer

The Java ES Log Viewer provides a graphical display for viewing the ULF log messages from the JavaES_Install_log.timestamp file or the JavaES_UnInstall_log.timestamp file. You display a log file by selecting Open in the File menu on the Log Viewer main page. If the file you specify already exists or cannot be opened for writing, a Log Viewer error occurs and you are returned to the Log Viewer main page. Such a file cannot exist in the directory used by the installer to store source logs.

The messages that meet your filtering criteria are displayed in a single log table when you click the Search button. After the log table is displayed, an individual row in the log table can then be selected for detailed display, including display in multiple-line format.

How Filtering Works

To tailor your logging output, you indicate your display preferences and search criteria on the Log Viewer main page after you have selected a ULF log file. Display Preferences indicate what language you want your selection displayed in, and what limitations to apply in displaying the filtered records.

• Language. Chooses a translation language for viewing messages. The default is English. This list is populated from the translation resource bundles stored by the installer. If a resource bundle is not specified, messages and the Log Viewer interface are displayed in English.

• Timestamp. Sets the records to be filtered or displayed. Choices are View All, Most Recent, and Oldest.

  • View All. All data is filtered and displayed.

  • Most Recent. All data is filtered, and the most recent data is displayed first.

  • Oldest. All data is filtered, and the oldest data is displayed first.

There are three ways to filter messages so that the messages displayed are of sufficient importance or interest: by log level, by logger, and by content.

• Log Level. Chooses a log level for filtering messages. Choices are SEVERE, ERROR, WARNING, INFO, CONFIG, FINE, FINER, and FINEST. Selecting FINEST is equivalent to selecting all records for display. When you select a log level, only messages having that log level or a level greater in severity are displayed. If you do not want to include any message except those that have the exact log level you specify, click the Do not include more severe messages checkbox.

• Logger. Chooses none or one of the loggers that apply to the file you opened. A logger (moduleID in a ULF file) indicates what part of the installer is writing the log message. The main loggers are JAVAESConfig, JAVAESInstall, or JAVAESUninstall. Only messages associated with the logger you selected are displayed. In addition, product component loggers can be specified. For example, WebServerInstall, AccessManagerConfig, DirectoryServerUnInstall.

• Content. When you enter a string, such as “configure,” in the Only Show Entries Containing text box, only messages that contain that string are selected.

Some typical search criteria:

• Display only the SEVERE log messages in this file.

• Display only the log messages with a log level greater than or equal to ERROR.

• Display only the log messages from installation that have a log level greater than or equal to ERROR.

• Display only the log messages from uninstallation events.

To Run the Log Viewer

Because the Log Viewer operates in read-only mode, multiple users can run the Log Viewer at the same time.

1. On the command line, navigate to the location of the Log Viewer:

   • Solaris SPARC: /var/sadm/prod/SUNWentsys5i/Solaris_sparc

   • Solaris x86: /var/sadm/prod/SUNWentsys5i/Solaris_x86

   • Linux: /var/sadm/prod/sun-entsys5i/Linux_x86

   • HP-UX: /var/sadm/prod/sun-entsys5i/HPUX_PA-RISC

2. Start the Log Viewer.

   ./viewlog

   The Log Viewer main page is displayed.

3. In the File menu, select a log file for display.

   If the file you select is not ULF, you receive a message saying the selected file is not ULF and cannot be selected. Only ULF files can be displayed using the Log Viewer.

   If no ULF log files are available, the installation or uninstallation might not be completed yet. Wait and try again.

4. Choose Display Preferences and Search Criteria for your scenario.

5. Click Search.

   The log table displays the records that match your filtering criteria.