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

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

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 .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.

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/...:$LD_LIBRARY_PATH

Here the '...' corresponds to the actual path on your system. It depends on the distribution and to some extend 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.

Mac OS X

Installing .tar.gz packages

WARNING: contrary to their Linux counterparts, these packages are not relocatable and must be installed to /Applications/ATSAS.

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

NOTE: If you consider the following steps overly complicated and would like to have an easy to use installer, please complain to Apple; they made the path to libraries part of the binaries which makes them not relocatable and they keep changing their supported tools more often than we, and other projects, are capable of following.

• In Finder: Applications -> Utilities -> Terminal
• wipe your previous installation:

  $ rm -rf /Applications/ATSAS

• Unpack the .tar.gz:

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

  This will create /Applications/ATSAS-X.Y.Z
• Rename the unpackaged directory:

  $ mv /Applications/ATSAS-X.Y.Z /Applications/ATSAS

• Set up the PATH if not done before:

  open $HOME/.bash_profile

  a text editor opens
• in the text editor, add:

  PATH=$PATH:/Applications/ATSAS/bin

  save and close
• close the Terminal and reopen
• type:

  which dammif

  the output should be

  /Applications/ATSAS/bin/dammif

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.