Linux Quickstart Guide

This quickstart guide is for installing AMS on a Linux desktop/laptop machine.

For cluster installations please read the generic Installation manual

NOTE: The following steps should be taken under a normal user account. Do not use the root account or superuser!

Step 1: Download

Start with downloading AMS2025 for Linux from the main download page, and save it in your Downloads folder. You do not need to open the file.

Tip

Download the IntelMPI (default) version, if you are unsure which version to download. The IntelMPI runtime is included with the download.

If you have an AMD Zen processor (Ryzen/EPYC), then download the “Linux Intel MPI, optimized for AMD-Zen” binary instead.

Step 2: Extract the archive

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

Make sure to replace the ams2025.102.pc64_linux.intelmpi part to match the name of the file you downloaded (in case of a newer version). 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/ams2025.102.pc64_linux.intelmpi.bin.tgz

Step 3: Set up the environment, source the amsbashrc.sh file

Run the following command to source the amsbashrc.sh file. Do not forget the dot and space at the beginning of the line! Also make sure to replace 2025.102 with the version you downloaded.

. $HOME/ams2025.102/amsbashrc.sh

Step 4: Start the AMSjobs graphical user interface

Start up the AMSjobs graphical user interface (GUI) with this command:

amsjobs &

If this fails to launch a GUI window, then you can try to run our GUI in software mode:

export SCM_OPENGL_SOFTWARE=1
amsjobs &

If this still 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!

Step 5: Create desktop icon

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

$AMSBIN/create_linux_icon.sh

Step 6: Automatically set up environment for all sessions

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

echo '. $HOME/ams2025.102/amsbashrc.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.