Installing ATSAS

Please note that installing packages generally requires superuser (root, Administrator) privileges. Depending on your institues policies you may not be able to install the package. If unsure, please check with your local IT group before attempting an installation of ATSAS.

Please remove any existing ATSAS installations before installing a new version.

The ATSAS program suite is currently supported on three major platforms and a number of versions thereof. Please download the package for your platform and choose the appropriate installation description from the table below.

Any questions about ATSAS should be posted on the Forum.

Linux

The Linux packages for ATSAS are available for a number of distributions and architectures:

Installing .deb packages (Ubuntu and Debian)

Download the latest package and install at the command line as superuser:

$ sudo dpkg --install ATSAS-X.Y.Z-1_ARCH.deb

Here X.Y.Z corresponds to the current version and ARCH to either i386 or amd64, depending on your hardware. If in doubt use the package with the same ARCH as given by:

$ dpkg-architecture -qDEB_BUILD_ARCH

If there is an error message saying "dpkg: dependency problems prevent configuration of atsas:", you can fix this by running:

$ sudo apt-get install --fix-broken

Installing .rpm packages (CentOS)

Download the latest package and install at the command line as superuser:

$ sudo yum install ATSAS-X.Y.Z-1.VERSION.ARCH.rpm

Here X.Y.Z corresponds to the current version of atsas, VERSION to either el5 or el6, depending on the distribution version and ARCH to either i386 or x86_64, depending on your hardware. If in doubt use the package with the same VERSION and ARCH as given by:

$ cat /etc/issue

$ uname -i

Installing .rpm packages (openSUSE)

Download the latest package and install at the command line as superuser:

$ sudo zypper install ATSAS-X.Y.Z-N.x86_64.rpm

Here X.Y.Z corresponds to the version of ATSAS.

Installing .tar.gz packages

These archives may be installed anywhere in the system, including a user home directory, and thus may not require superuser privileges to install. However, you will need to install dependency packages that are required for ATSAS to work since, unlike when installing with the package manager, the dependencies will not be installed automatically.

WARNING: The following description assumes that you are familiar with your Linux system. If you are a novice on the command shell, please ask your local IT support for help!

Depending on your distribution, open a terminal and verify that this is a bash shell:

$ echo $SHELL

If the output is not /bin/bash, do not continue!

Unpack the downloaded binaries and support files into a convenient directory, e.g. $HOME/atsas:

$ mkdir $HOME/atsas
$ tar xfz atsas-X.Y.Z-1*.tar.gz -C $HOME/atsas

This will create $HOME/atsas/ATSAS-X.Y.Z-1.

Tell the system where to find the binaries and libraries:

$ export ATSAS=$HOME/atsas/ATSAS-X.Y.Z-1
$ export PATH=${ATSAS}/bin:$PATH
$ export LD_LIBRARY_PATH=${ATSAS}/lib/VERSIONPATH:$LD_LIBRARY_PATH

Here 'VERSIONPATH' corresponds to the actual path on your system. It depends on the distribution and to some extent even the version of the distribution, so make sure that the correct library path is set.

Validate:

$ dammif -v

If an error is given or a previously installed old version is shown, something went wrong.

Dependencies that may have to be installed manually:

• LAPACK
• Qt 4 (including QtGui, QtSVG, QtNetwork and Qt Assistant, if these are packaged separately)
• libgfortran
• libtiff
• libxml2

Mac OS X

Installing .tar packages

• Double-click on the ATSAS-X.Y.Z.tar file; it will unpack to give a file called ATSASinstall.command in the same directory
• Double-click the ATSASinstall.command file; it will open a Terminal window
• If asked for your password, type it in
• Wait for the install to finish

GUI applications can then be found in Applications->ATSAS. To run any non-GUI applications, open a Terminal to enter the commands.

Windows

Double click the installer application, follow the wizard. There should be nothing else to do.