How to Generate Debug for APT Installation Problems

If APT fails to install or fails to run once installed, it may require you to run in debug mode for the developers to diagnose the problem. Here are instructions for generating the debug output:

On a linux machine:

Figure out what shell you are using.
echo $SHELL
Set the LAX_DEBUG environment variable to true.

If your shell is tcsh or csh then:

setenv LAX_DEBUG true

otherwise:

LAX_DEBUG=true
export LAX_DEBUG

Rerun the installer or APT (depending on which gave you trouble) and include (not attach) the debug output that you get when you write to help@stsci.edu.

On a Windows machine:

Start the apt.exe installer from a DOS shell.

Hold the CNTL key down immediately after you launch the installer.

Let go of the CNTL key when output starts to appear.

Include (not attach) the debug output that you get when you write to help@stsci.edu.

On a Mac:

Go to the directory where you installed APT

Double click on ReallyRunAPT.command

This will bring up a terminal window which will show the debug as APT runs.