This section describes how to troubleshoot problems installing the Java Enterprise System software distribution on Solaris and Linux operating systems.
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.
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.
This section provides information to help you troubleshoot problems installing Directory Server Enterprise Edition on Solaris using the Java ES distribution.
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:
Java_Enterprise_System_5_install.B04251905
Java_Enterprise_System_5_install.A04251905
JavaES_Install_log.45487014
Java_Enterprise_System_5_Summary_Report_install.04250719
Information about the installed components, including Directory Server, are included in these log files.
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.
Identify the step-by-step procedure used for the installation
Send a copy of the log files located in the /var/sadm/install/logs directory.
Send a copy of the /var/sadm/install/contents file.
Send the output of showrev -p.
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.
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.
Stop all of the Java ES processes.
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 |
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.
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 |
Install the package again using the Java ES installer
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 |
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.
Identify the step-by-step procedure used for the installation
Get the errors log for Directory Server.
Send a copy of the log files located in the /var/opt/install/logs directory.
Get the output of rpm -qalv command.
Send a copy of the /var/opt/sun/install/productregistry file
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.