Java Application Verification Kit (AVK) for the Enterprise 5.0 Installation Instructions

Print-friendly Version

• Installing Java AVK for the Enterprise
• Troubleshooting
• Uninstalling Java AVK for the Enterprise

Installing Java AVK for the Enterprise

You can install Java^TM AVK for the Enterprise along with a copy of Sun Java System Application Server Platform Edition 9, or you can use an already installed version of the Application Server. If you install the Application Server along with Java AVK for the Enterprise, you need at least 145 megabytes of free disk space and 145 megabytes of free temporary disk space. If you do not install the Application Server along with Java AVK for the Enterprise, you need at least 15 megabytes of free disk space and 15 megabytes of free temporary disk space.

To install Java AVK for the Enterprise software, you need version 5.0 Update 6 or higher of the Java Platform, Standard Edition Development Kit (JDK) already installed on your computer. The JDK can be downloaded from http://java.sun.com/j2se/downloads/.

You run the self-installing executable to unpack and install the Java AVK for the Enterprise software bundle.

During installation, the installer gives you the option of installing the Application Server or of pointing to a previously installed copy of the Application Server. It also asks which version of the JDK you will use; this version can be 5.0 Update 6 or above.

Note: Do not use spaces in the directory structure where you install Java AVK for the Enterprise. For example, avoid using directory names such as Program Files.

From a terminal window (on a Solaris or Linux system) or from the Windows Explorer (on a Windows System):

1. Change to the directory where you downloaded the software bundle.
2. (Microsoft Windows systems only) If you plan to point to a previously installed copy of the Application Server, start the Application Server.
3. Run the self-installing executable, which will have one of these names:

   javke-5-windows.exe
   javke-5-linux.sh
   javke-5-solaris-sparc.bin
   javke-5-solaris-i586.bin
   

   If you would rather use a command-line interface than the installation wizard, run this command with the -console option.

   Note: On a Windows system, the installer may crash if you do not run it with the -is:javahome option set to the location of your JDK installation.

4. After the installation completes, restart the Application Server.

After You Install

For ease of running Java AVK for the Enterprise commands, set the PATH environment variable to include the following directories:

<JAVKE_HOME>/bin

<JAVKE_HOME>/appserver/bin (if you installed the Application Server with the Java AVK)
or
<AS_HOME>/bin (if you used an existing Application Server installation)

<JAVKE_HOME>/appserver/lib/ant/bin (if you installed the Application Server with the Java AVK)
or
<AS_HOME>/lib/ant/bin (if you used an existing Application Server installation)

where JAVKE_HOME is the location of your Java AVK for the Enterprise installation, and AS_HOME is the location of your Application Server installation.

See the Java Application Verification Kit (AVK) for the Enterprise User's Guide for instructions on using this software.

Troubleshooting

This section documents the following installation problems:

• Installation error on Windows systems
• Failure to find JDK installation
• Existing Installation Detected error
• Failure to find a web browser
• Slow installer start on Linux systems

Installation Error on Windows Systems

If you install Java AVK for the Enterprise on a Windows system and specify a previously installed version of the Application Server, the installation fails with an error message partway through if you do not start the Application Server before you install Java AVK for the Enterprise.

If you encounter this problem, use the Cancel button to stop the installation wizard. Then start the Application Server and run the installation wizard again.

Failure to find JDK Installation

On a Windows Server 2003 or Windows XP system, the installer may fail to find an existing JDK 5.0 installation, even if you have specified the installation with the JAVA_HOME environment variable and placed its bin directory in your path. If this happens, run the installation with the -is:javahome option set to the location of your JDK installation.

Existing Installation Detected Error

Installation of Java AVK for the Enterprise may fail with an Existing Installation Detected error under the following circumstances:

• You previously installed a version of the Application Server while running with Administrator privileges (on a Windows system) or as the root user (on a UNIX system).
• You moved or removed this version of the Application Server instead of uninstalling it.

In this situation, the Application Server installation leaves a file named productregistry in the directory C:\<WINDOWS|WINNT>\system32 (on a Windows system), /var/sadm/install (on a Solaris system), or /var/tmp (on a Linux system). There are two possible workarounds for this problem:

• Choose a different directory in which to install Java AVK for the Enterprise.
• Edit the productregistry file and remove the entries for the previous installation of the Application Server. You can identify these entries by the path names in the <location> elements.

Failure to Find a Web Browser

If you choose the registration option, but the installer cannot find a web browser from which to launch the registration page at the end of the installation, the installation exits silently, leaving a message in the file log.txt in the directory where you installed Java AVK for the Enterprise. If you install with the -console option, the installer can never find a web browser.

If this happens, register by clicking here.

Slow Installer Start on Linux Systems

On certain versions of Linux, the installer may take several minutes to start. One possible reason is that the command du -s $HOME takes a long time to complete on your system.

Uninstalling Java AVK for the Enterprise

From a terminal window (on a Solaris or Linux system) or from the Windows Explorer (on a Windows System):

1. (Microsoft Windows systems only) Start the Application Server.
2. Run the uninstallation executable, which will have one of these names:

   <JAVKE_HOME>\_uninstall\uninstaller.exe
   <JAVKE_HOME>/_uninstall/uninstaller.sh
   <JAVKE_HOME>/_uninstall/uninstaller.bin
   

   If you would rather use a command-line interface than the uninstallation wizard, run this command with the -console option.