# Installation Guide

# Troubleshooting and Limitations

## Troubleshooting

Here are solutions to common problems that may arise during the installation of the product:

Problem:

I installed the proper version of the JDK, but when I open a command window and type java - version, I get the wrong version number.

Solution:

Ensure that %JAVA_HOME%\bin is at the FRONT of your path setting.

Problem:

When attempting to install on a UNIX-like platform, I receive an error stating that the machine's temporary space is insufficient. The error varies, but looks something like the following:

    [my_username@qa-redhat 4.3]$ chmod +x *Lin*

    [my_username@qa-redhat 4.3]$ ./*Lin*

    Preparing to install...

    WARNING: /tmp does not have enough disk space!

    Attempting to use /home/my_username for install base and tmp dir.

    Extracting the JRE from the installer archive... Unpacking the JRE...

    Extracting the installation resources from the installer archive...The size of the extracted files to be installed are corrupted.  Please tryto download the installer again and make sure that you download using 'binary' mode. Please do not attempt to install this currently downloaded copy.

Solution:

The installer extracts the software to a temporary space before installing it. By default, the temporary space is in `/tmp`. Approximately 150 MB of free space is required. If `/tmp` doesn't have enough free space, specify a different directory as the temporary space. For example:

    	IATEMPDIR=/home/my_username/tmp

    	export IATEMPDIR

    	echo $IATEMPDIR

Typically, your home directory will provide enough free space as long as the disc has sufficient space.

Problem:

Users of Windows 2003 with SP1 or Later

ALSM might not launch, or might exit with a system error, because of a new security feature in Windows. This problem can also occur on certain configurations of Windows XP with SP2 or later installed.

Solution:

To avoid this problem, you must add the installer executable to an exclusion list. To find the exclusion list:

1. Open the System Properties control panel.
2. Click the Advanced tab.
3. Click the Performance Settings button.
4. Click the Data Execution Prevention tab on the Performance Settings window.
5. If DEP is turned on for all programs and services, then add the ALSM installer executable to the list.

For additional information on this subject, refer to the Microsoft technical note located at:

http://www.microsoft.com/technet/prodtechnol/winxppro/maintain/sp2mempr.mspx. The applicable section is titled, "Per-application DEP Configuration".

## Limitations

Limitation:

Plug-in agents cannot manage services in a web application in which there is a security constraint applied to the entire application.

Workaround:

Apply the security constraint to each service in the application.