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.