Sun Java Communications Suite 5 Installation Guide

Examining Installation Log Files

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.

Log File Formats

There are four types of log files that capture information on an installation or uninstallation:

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:

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.

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.

Some typical filtering examples:

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.

ProcedureTo Run the Log Viewer

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:

  1. Start the Log Viewer.

    To run the Log Viewer in graphical mode:

    ./viewlog

ProcedureTo Use Log Files for Troubleshooting

  1. 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.

  2. Review the detail logs (A and B), for example, Sun_Java_Communications_Suite_install.Atimestamp.

    1. Look for the first error or warning that occurred and resolve it. Sometimes resolving one error resolves a number of seemingly unrelated errors that follow.

    2. Find the name of the component or package that caused the problem. If attempts to resolve the problem fail, examine the debug log.

  3. Examine the debug log, for example, Sun_Java_Communications_Suite_Install_log.timestamp.