Linux Quickstart Guide¶

This quickstart guide is for installing ADF/AMS on a Linux desktop/laptop machine. For cluster installations please read the generic Installation manual

Start with downloading AMS2018 for Linux from the main download page (click the orange Download button below the penguin), and save it in your Downloads folder. You do not need to open the file.

Now open a terminal (Ctrl+Alt+T usually works, otherwise browse your application menus), and run the commands below to extract the download into your homefolder. Make sure to replace the adf2018.101.pc64_linux.intelmpi part to match the name of the file you downloaded (in case of a newer version, or if you downloaded a snapshot or development version). Try to use copy and paste (right-click with your mouse in the terminal screen to paste) to avoid mistyping the commands.

cd $HOME
tar -xf $HOME/Downloads/adf2018.101.pc64_linux.intelmpi.bin.tgz

Run the following command to source the adfbashrc.sh file, do not forget the dot and space at the beginning of the line! Also make sure to replace 2018.101 with the version you downloaded.

. $HOME/adf2018.101/adfbashrc.sh

Start up the GUI with this command:

adfjobs &

If this does not open a gui, then use your mouse to select all the text in the terminal window, copy it (right-click and select copy), and send us an email at support@scm.com with the text. DO NOT PROCEED WITH THE NEXT STEP!

If the ADF GUI started without problems, go back to ther terminal window and run the following command to create a desktop icon for ADF:

$ADFBIN/create_linux_icon.sh

Finally we can set up our terminal to automatically source the adfbashrc.sh file when starting. Add the source command to the .bashrc file with the following command in the terminal window:

echo '. $HOME/adf2018.101/adfbashrc.sh' >> $HOME/.bashrc

You can also open the .bashrc file in a text editor, and manually paste the part between the quotes on a new line at the end of the file.