Sun Java Enterprise System 2005Q4 Installation Guide for UNIX

Troubleshooting Techniques

This section provides general guidelines for analyzing and identifying the source of problems during installation and uninstallation of Java ES.

This section contains the following subsections:

Examine Installation Log Files

If a problem occurs during installation or uninstallation, check the appropriate log file in the logs directory:

Solaris OS: /var/sadm/install/logsLinux: /var/opt/sun/install/logs

Examining the uninstall and installer log files (along with the Java ES configuration log and component logs) can help locate the source of problems. For example, you can compare the packages listed in the installation log to the packages listed in the uninstallation log.

Most logs have two versions:

The following table lists the formats of the log files.

Table 9–1 Java ES Log File Name Formats

Logged Entity 

Log File Name Format 

Installer: components 






Installation summary 

Java_Enterprise_System_Summary_Report_install. timestamp




Java_Enterprise_System_Summary_Report_ uninstall. timestamp

To use the log files for troubleshooting, attempt to isolate the first problem that occurred. Often, the first problem leads to successive problems.

ProcedureTo Use Log Files for Troubleshooting

The log files can give you clues that determine your next steps, such as these:

  1. Review the installation summary file, which provides a high-level description of what was installed and configured.

    If a problem occurred, see what component caused the problem. If multiple problems occurred, isolate the first.

  2. Review the detailed log files.

    1. Look for the first error or warning that occurred and attempt to 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.

Examine Component Log Files

If a problem occurs starting a component, examine its log files. Locations of many component log files are listed in Component Troubleshooting Tips.

Verify Product Dependencies

A number of components have installation-time interdependencies. Problems that affect one component can affect other components. First, you should familiarize yourself with the information in Sun Java Enterprise System 2005Q4 Installation Planning Guide

In addition to component interdependencies, some components depend on the existence of Solaris packages that might not be installed on the host, and their absence could cause installation failures. Read the “Software Requirements” section of the Release Notes for details.

Check Resources and Settings

The following host-level issues can cause installation problems.

Check Postinstallation Configuration

If you are having problems starting components, verify that the procedures outlined in Chapter 6, Configuring Components After Installation were done correctly.

Check the Distribution Media

If you are installing from a DVD or CD, examine the media for dirt or damage. Dirty discs can result in installation problems.

Check Directory Server Connectivity

If you are installing a component that relies on Directory Server, problems can be caused by one of these problems:

Remove Web Server Files and Directory

To prevent the overwriting of customized files, such as edited configuration files, Web Server cannot be installed into a directory that contains files.

If you are reinstalling Web Server, check the installation directories to ensure that they are empty. If they are not empty, archive the files elsewhere and retry the installation.

Verify Passwords

The installer requires that you enter a number of passwords for components. If you are installing different components on different hosts, it is important to ensure that you supply matching passwords on each host.

To resolve password problems, you might need to uninstall and then reinstall. If the uninstall fails, refer to Installation Fails Due to Leftover Files During Uninstallation.

Examine the Installed or Uninstalled Components

If you have installed components but are having problems and cannot reinstall or uninstall, check the packages installed using the Solaris pkginfo or the Linux rpm command. Compare the results with the Java ES packages listed in Chapter 5, List of Installable Packages, in Sun Java Enterprise System 2005Q4 Installation Reference uninstalled. Additional information is in Installation Fails Due to Leftover Files During Uninstallation.

Tip –

On Solaris 9 and Solaris 10, you can also use the prodreg tool which provides a graphical interface to the product registry that indexes both components and their packages, superseding the pkg utilities. To invoke prodreg, type the command name at the command line. For more information, refer to the prodreg(1) man page.

Verify Administrator Access

During uninstallation, you might need to grant administrator access to the uninstaller, as described in Granting Administrator Access for the Uninstaller.