If a problem occurs during installation or uninstallation, the first place to look for information on what happened is the installation logs. Messages on installation, uninstallation, and install-time configuration are gathered into the source log files. Informational, warning, and error messages are issued after such operations as user choices, package manipulations, and installation or uninstallation steps. Information that is displayed for each message includes date and time, log level, module ID, and the message text.
There are four types of log files that capture information on an installation or uninstallation:
A summary provides a high-level description of what was installed and configured.
A detail version A file contains completion information.
A detail version B file contains more details on the log messages.
A debug file contains information that is relevant when installation fails. Use the debug file when one of the other logs indicates an error.
After an uninstallation, the uninstaller removes itself, the installer, and the Log Viewer. However, source log files are not removed and are stored in the following locations:
Solaris: /var/sadm/install/logs
Linux: /var/opt/sun/install/logs
The following table lists the formats of the source log files.
Table 10–1 Log File Formats
Logged Entity |
Log File Name Format |
---|---|
Installer |
Sun_Java_Communications_Suite_install.Atimestamp |
Sun_Java_Communications_Suite_install.Btimestamp |
|
Sun_Java_Communications_Suite_log.timestamp |
|
Sun_Java_Communications_Suite_Summary_Report_install.timestamp |
|
Uninstaller |
Sun_Java_Communications_Suite_uninstall.Atimestamp |
Sun_Java_Communications_Suite_uninstall.Btimestamp |
|
Sun_Java_Communications_Suite_UnInstall_log.timestamp |
|
Sun_Java_Communications_Suite_Summary_Report_uninstall.timestamp |
The log messages are stored in Unified Logging Format (ULF). If you find this format difficult to read, you can edit the source files with a text editor such as vi, or you can use the Communications Suite Log Viewer to view the log messages.
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. |
|
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.
Because the Log Viewer operates in read-only mode, multiple users can use the Log Viewer at the same time. After installation, the Log Viewer is located here:
Solaris SPARC: /var/sadm/prod/SUNWcomm-entsys5i/Solaris_sparc
Solaris x86: /var/sadm/prod/SUNWcomm-entsys5i/Solaris_x86
Linux: /var/sadm/prod/sun-comm-entsys5i/Linux_x86
Review the summary file, for example, Sun_Java_Communications_Suite_Summary_Report_install.timestamp.
If a problem occurred, determine which component caused the problem. If multiple problems occurred, address the first problem. You will probably need to look at one or both of the detail logs.
Review the detail logs (A and B), for example, Sun_Java_Communications_Suite_install.Atimestamp.
Examine the debug log, for example, Sun_Java_Communications_Suite_Install_log.timestamp.