Project WebSynergy Milestone 4 Administration Guide

Troubleshooting for the Issues Related with Installation

If you are deploying WebSynergy on an existing installation of GlassFish, you need to determine the install location of GlassFish. If GlassFish is installed at the root directory, you can deploy WebSynergy either at the root directory or at the user directory. If GlassFish is installed at your user directory, you must install WebSynergy at the same user directory.

In the scenario involving JDK, GlassFish, and WebSynergy; WebSynergy is at the top layer, GlassFish is in the middle layer, and JDK is in the bottom layer. When you are using the GlassFish WebSynergy bundle, you need to determine the install location of JDK. If JDK is at the root directory, you can install the bundle either at the root directory or at your user directory. If JDK is installed at the user directory, you need to install the bundle at the same directory.


Note –

It is a good practice to have your GlassFish installation dedicated only for running WebSynergy.


Suppose you have JDK 1.5 installed in the root directly and you have installed JDK 1.6 in your user directory. Because WebSynergy often works better on a more recent JDK version, you might want to override the installation at the root directory.

ProcedureTo Reset the JAVA_HOME Variable to the User Directory

  1. Type the following commands in a terminal window:

    export JAVA_HOME JDK-install-dir
    export PATH=$JAVA_HOME/bin:$PATH
  2. To verify the change, type the following command:

    echo $JAVA_HOME

    The new directory should be listed.

ProcedureTo Set the JAVA_HOME Environment Variable to the User Directory on Non Solaris Operating Systems

  1. Open the GlassFish-install-dir/config/asenv.conf/asenv.bat file.

  2. Set the AS_JAVA variable to the JDK 1.6 user installation.

  3. Reinstall the WebSynergy bundle and start the domain.