Sun Java System Directory Server Enterprise Edition 6.3 Troubleshooting Guide

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.