test

Sun Java System Directory Server Enterprise Edition 6.1 Troubleshooting Guide

Troubleshooting Java ES Installation Problems

This section describes how to troubleshoot problems installing the Java Enterprise System software distribution on Solaris and Linux operating systems.

Note –

If the problem concerns a general installation failure for Java Enterprise System, first check the installation troubleshooting chapter in the Installation Guide for your version of Java Enterprise System.

General Recommendations

Before you begin troubleshooting your Java ES installation, be certain that you have done your installation using the Java ES installer. You must install the Java ES distribution using this installer. The installer installs a large number of component packages.

Troubleshooting Java ES Installations on Solaris

This section provides information to help you troubleshoot problems installing Directory Server Enterprise Edition on Solaris using the Java ES distribution.

Collecting and Analyzing Data

Review the installation errors logs for information about what occurred during the installation failure. On Solaris, search for error messages in the /var/sadm/install/logs directory. On Red Hat and HP-UX systems, installations logs are located in the /var/opt/sun/install/logs directory. On Windows systems, installation logs are located in the C:\Docuemnts and Settings\current-user\Local Settings\Temp directory.

The logs directory contains the following log files:

Information about the installed components, including Directory Server, are included in these log files.

Contacting Sun Support

If you cannot complete Directory Server Enterprise Edition installation using the Java ES distribution on Solaris and are unable to troubleshoot your problem, collect the following data. This data can help the Sun Support Center resolve your problem.

In addition to the data described here, see To Collect Required Debug Data For Directory Server Installation Problems in Sun Gathering Debug Data for Sun Java System Directory Server 5.

Troubleshooting Java ES Installations on Linux

If you installed the Java Enterprise System distribution manually, meaning you installed only the packages you thought were required, restart a clean installation using the installer.

Procedure To Do a Clean Reinstall of Java ES on Linux

  1. Stop all of the Java ES processes.

  2. Remove everything under the install-path that you specified during the configuration phase.

    To help you locate this path, run the following:


    # grep location /var/tmp/productregistery

  3. Remove the /var/tmp/productregistry file and the /var/opt/sun/install/productregistry file.

    These product registry files contain a description of what packages have been installed for Java ES and where they were installed.

  4. Uninstall the Directory Server Enterprise Edition RPM packages.

    Locate all of the installed Directory Server Enterprise Edition RPM packages as follows:


    # rpm -qa | grep 'sun-ldap-(shared|directory|proxy|console)'

    Remove all of the RPM packages you locate as follows:


    # rpm -e list-of-rpm-packages

  5. Install the package again using the Java ES installer

Resolving a Java ES Permissions Problem

If after performing a clean install you still cannot launch the installer, you may be experiencing a problem with permissions. This problem typically occurs on Linux because of an incorrect default umask value. This problem arises when you install as one user, such as root, then use a regular LDAP user for Directory Server. When you launch Directory Server as the LDAP user, it fails because this user does not have access to files that have been installed as root because of a umask value that is too restrictive.

For example, you can reset the permissions using a simple script as follows:


# cd /opt/sun
# for i in `find . -perm 750`
do
chmod $i 755 $i
done
# for i in `find. -perm 640`
do
chmod $i 644 $i
done
# cd instance-directory
# for i in `find . -perm 750`
do
chmod $i 755 $i
done
# for i in `find . -perm 640`
do 
chmod $i 644 $i
done

Contacting Sun Support

If you cannot complete Directory Server Enterprise Edition installation using the Java ES distribution on Linux and are unable to troubleshoot your problem, collect the following data. This data can help the Sun Support Center resolve your problem.

In addition to the data described here, see To Collect Required Debug Data For Directory Server Installation Problems in Sun Gathering Debug Data for Sun Java System Directory Server 5.