STScI Logo

Hubble Space Telescope
Linux: How to Download, Install, and Start APT

Supported Systems

APT is supported on Redhat Enterprise Linux. APT is currently tested on a 64-bit machine with RHEL 6.4 and the Gnome windowing system. Because of the recent upgrade to Java 7 the basic requirement now is RHEL 5.5 (or better), Ubuntu 12.04 (or better), SuSE 10 SP2 (or better) (and equivalents).

APT requires a minimum of 512 Megabytes of RAM (memory), but we recommend 1 Gigabyte of RAM. Please see our memory discussion for more information.

APT is now available for both 32-bit and 64-bit kernal computers. (To determine which you have type: "uname -a". If you see "x86_64" you have a 64-bit kernel.)

You will need a PDF reader installed on your machine.

Depending on your institution's computer security measures (firewalls, blocked ports, etc.), you may initially have communication trouble with APT. If you have any concerns please see our firewall webpage.

1. UnInstall the previous version

Note: If you are going to install APT in the same directory as a previous version, please remove the previous version first. But if you are going to install in a separate directory, you would only need to uninstall to save disk space (and possible version confusion).

To get rid of the old version: Delete the entire directory tree where you installed it. (The unix command

rm -rf [directory]

makes this quick because it gets rid of all the subdirectories and does not ask you about overriding permissions.)

2. Download and Install

Choose your operating system: APT is available for both 32-bit and 64-bit kernal computers. (To determine which you have type: "uname -a". If you see "x86_64" you have a 64-bit kernel.)

Proceed to the Installation...

3. Start

Once you have installed APT you invoke it with a script. For instance to start APT type

./APT

in the installation directory. (By default the installation directory is placed in your home directory.) Links are no longer put in your home directory automatically. If you would like to create your own link, here is is the unix command to use in your home directory to create a link named 'apt':

ln -s [your_installation_directory]/APT apt

4. Help

There is a a series of short training movies which will help get you started (there are also web pages with screen shots available on the same page). APT also has documentation available from the "Help" menu (the right most menu on the menu bar).

If you can't find what you need, please contact us at help@stsci.edu.

How to find out about new releases

We maintain a distribution list for announcing new releases of APT. This may be helpful to people who install APT for others to use. Send an e-mail to majordomo@stsci.edu which contains the line:

subscribe apt-users

Troubleshooting

If there are problems with the installation you can turn on debug logging and sometimes that will reveal the problem. This debug log would also be useful to send us if you can't figure out the problem. Contact us (through help@stsci.edu) if you have problems with installation. It would also be useful to tell us your exact flavor of linux which you can get from the commands:

uname -a

and

more /etc/issue

To turn debug logging on during installation: Execute these commands in the directory where you downloaded the installer (install-linux-apt.sh):

sh install-linux-apt.sh --keep --noexec
    
cd install-linux-apt

jre/bin/java -DTRACE=true -jar install-linux-apt.jar

To turn debug logging on while running APT: add a command line switch when you invoke APT:

./APT -debug all

Known Installation/Download Problems: