test

Sun Java Enterprise System 5 Update 1 Installation FAQs for UNIX

Troubleshooting Java ES Installation Problems

This section contains questions about troubleshooting problems with Java ES installation or uninstallation.

Q37: What do I do if I have trouble during installation?

Answer: When troubleshooting, try to identify the first problem you encountered. The first problem often leads to subsequent problems, so solving the first problem could resolve other problems.

Tip –

Sun Forums can be very helpful in identifying problems that have already come up for discussion and also for screening solutions that might apply to your installation. See http://www.sun.com/bigadmin/hubs/javaes/community/index.jsp

The general process for troubleshooting Java ES installation includes the following activities:

  1. Examine the logs to see if errors exist that indicate what is wrong. See Q38: What logs are available and how will they help me?

  2. Verify that you met all of the installation prerequisites for the components you installed. See Verifying Installation Prerequisites in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

  3. Check to see if your resources fulfill Java ES system requirements. See System Requirements in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

    • Adequate disk space

    • Adequate memory

    • Correct patches applied

    • Correct ports specified

    • Correct IP addresses specified

  4. Check the media for dirt or damage.

  5. Verify that you have installed correctly with regard to the interdependencies of the Java ES components you installed. See Q12: Are there component interdependencies that I need to know about?

  6. Verify that you have configured the Java ES components correctly according to the postinstallation configuration instructions. See Chapter 6, Completing Postinstallation Configuration, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

  7. Check your Directory Server connectivity.

  8. Verify that the Java ES packages that should be installed are installed. See Chapter 5, List of Installable Packages, in Sun Java Enterprise System 5 Update 1 Installation Reference for UNIX.

  9. Verify that the passwords you are using are correct.

    Note –

    In the Java ES installer, neither white space nor the following symbols can be used in administrator passwords: ; & ( ) ! | < > ' ? $ ^ \ # / , @ %

For additional material on these activities, see How to Troubleshoot Problems in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

Q38: What logs are available and how will they help me?

Answer: Information on all installation events is captured in the installation logs described in Examining Installation Log Files in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX. Always start any troubleshooting by scanning the log events to see what errors occurred. The logs usually give you an idea of what to do next. Two types of tracking files are available after Java ES installation:

The graphical Log Viewer is a utility that can be used to view Unified Logging Format (ULF) messages from the Java ES installation log. See Using the Log Viewer in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

Links to the installation logs and summary are on the last page of the installer. Log files are located here:

If a problem occurs when starting a particular component, examine the troubleshooting tips tables to find the location of log files for the individual Java ES components. See Product Component Troubleshooting Tips in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

Q39: What are the known Java ES installation issues?

Answer: Known issues (bugs) are problems in the Java ES software or documentation. Some of these issues might impact installation. You should be aware of all known installation issues before doing an installation. Known issues are discussed in the following Java ES release notes:

Q40: What is the product registry and why should I care about it?

Answer: The product registry is a repository where all packages are registered when they are installed. The registry contains information such as installation location, product version, and component dependencies. All installed packages have entries in the product registry. The Solaris product registry provides a graphical interface.

Note –

Before installation, make a copy of your product registry so that you can restore it if installation fails. The product registry is located here:

When packages are removed by the uninstaller or the package remove commands (Solaris pkgrm or Linux rpm -e), those package entries are deleted from the product registry. However, you might encounter a situation where your product registry has not been fully updated. This situation causes a subsequent installation to fail because those components are still considered to be on the host (they are still in the product registry). In this case, update the product registry to correctly reflect the packages that are actually installed on your host.

In rare cases, the installer allows installation to proceed but only installs and registers some of the packages. You might not discover this fact until you try to start the components. In this case, run the uninstaller allowing it to update the registry. If the registry is still not correct after uninstalling the Java ES components, the registry might be corrupted. In this case, restore the original product registry and perform a new Java ES installation.

Q41: What troubleshooting topics are addressed in the Java ES Installation Guide?

Answer: The following topics are addressed in the Chapter 9, Troubleshooting, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX:

Q42: If I made a mistake and want to erase everything and start over, what do I do?

Answer: You can cancel an installation up to the point where the installer has begun copying the software to the host. If you have gone past the point where you can cancel the installation, you need to complete the installation, and then run the uninstaller. The high-level steps for this process are as follows:

  1. Complete the installation, even if it is wrong. You need the uninstaller, which is not available until the installation is complete.

  2. Run the uninstaller and uninstall everything. The uninstaller will also uninstall itself. See Chapter 8, Uninstalling, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

  3. Examine the product registry to see what is recognized on the host. The Java ES components should be removed. See Q40: What is the product registry and why should I care about it?

  4. Check to see if any Java ES directories or packages are present. See Chapter 5, List of Installable Packages, in Sun Java Enterprise System 5 Update 1 Installation Reference for UNIX. If any packages are present, remove them manually using the UNIX remove commands:

    • Solaris OS: pkgrm

    • Linux: rpm -e

  5. Recheck the product registry to verify that any Java ES components you removed are no longer present.

  6. Start a new installation.

Note –

If you cannot resolve issues that are preventing a new installation, you might have to reinstall the operating system on the host. Be sure to back up any important data before reinstalling the operating system.

Q43: What packages are installed for Java ES 5 Update 1?

Answer: The Java ES Update 1 packages are listed here:

See Also

Default Installation Directories in Sun Java Enterprise System 5 Update 1 Installation Reference for UNIX

Q44: Where do I get troubleshooting information for individual components?

Answer: The Java ES documentation contains various troubleshooting tools and tips for the product components. See Product Component Troubleshooting Tips in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX. In addition, the Java ES Troubleshooting task page contains links to more specific troubleshooting solutions for the product components. See the Troubleshooting page.