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 AMS2026 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 ams2026.101.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/ams2026.101.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/ams2026.101/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: Install optional features with the package manager
==========================================================

From the GUI, navigate to **SCM -> Packages**.

* Select the features you'd like to install or select all with ctrl+A
  and click Install

* Wait, and close the package manager when done.

See also: Package Manager: Installing Optional Components for more
about packages and command-line usage.


Step 6: 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 7: 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/ams2026.101/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.
