Installation Manual 2026.1
**************************

This document describes the installation of the Amsterdam Modeling
Suite (AMS).

* Quickstart instructions: Windows | Linux | MacOS

* Complete installation guide: Installation

* License information: Set up the license

AMS is bundled as a mostly complete package. All engines and graphical
user interface modules are installed at once. **Your license file
determines which of the functionality will be available after
installation**.

Some optional packages can be added after the initial installation:
Package Manager.

More information: Hardware requirements | Additional Information and
Known Issues | FAQ

**Table of Contents:**

* Windows Quickstart Guide

  * Step 1: Download

  * Step 2: Run the installer

  * Step 3: Launch AMSjobs

  * Step 4: Provide license information

  * Step 5: Tutorials

  * Next steps

* Linux Quickstart Guide

  * Step 1: Download

  * Step 2: Extract the archive

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

  * Step 4: Start the AMSjobs graphical user interface

  * Step 5: Install optional features with the package manager

  * Step 6: Create desktop icon

  * Step 7: Automatically set up environment for all sessions

* MacOS Quickstart Guide

* Introduction

  * Requirements

  * Important changes since AMS2025

  * Important changes since AMS2024

  * Important changes since AMS2023

  * Important changes since AMS2022

  * Important changes since AMS2021

  * Important changes since AMS2020

  * Important changes since AMS2018

  * Important changes since ADF2017

* Installation

  * Decide which version to install

  * Download and install the software

  * Set up the environment

  * Set up the license

  * Set up the scratch space

  * Test your installation

  * Configure AMSjobs queues and 3rd party software (optional)

* Package Manager: Installing Optional Components

  * What's new

  * Breakdown

  * Recommended Installation

  * Offline Usage Guide

  * FAQ and Troubleshooting

  * Need more control?

* Additional Information and Known Issues

  * Windows Subsystem for Linux (WSL) and Docker

  * Shared memory and batch systems (SLURM)

  * GPFS file system

  * Running MPI jobs

  * More on running MPI jobs

  * IntelMPI and core-binding

  * IntelMPI and SLURM

  * IntelMPI and SGE

  * IntelMPI and ABI compatibility

  * Multi-node issues

  * OpenMPI on Linux

  * Corrupted License File

  * Windows: running jobs from the command line

  * Windows: Installing a license from the command line

* Using the GUI on a remote machine

  * More detailed information

  * X11 over SSH

  * X11 with OpenGL over SSH (3D graphics)

  * Using ThinLinc for Remote GUI

  * Sources

* Deploying AMS in the cloud using AWS ParallelCluster

  * Introduction

  * Prerequisites

  * Setting up your cluster with AWS ParallelCluster

  * Installing and configuring AMS

  * Using the queues on your local AMS installation

  * Considerations

  * Appendix

* Appendix A. Environment Variables

  * More on the SCM_TMPDIR variable

* Appendix B. Directory Structure of the AMS Package

  * The bin directory

  * The atomicdata directory

  * The data directory

  * The examples directory

  * The src directory

  * The Utils directory

  * The Doc directory

  * The scripting directory

* Appendix C. Debugging MPI Problems

  * Technical introduction into AMS

  * Debugging MPI issues

  * IntelMPI on Linux Quirks

* Appendix D: Advanced package manager usage

  * Overview

  * Managing packages from the command line

  * Helpful commands and global options

  * Finding available packages

  * Installing a package

  * Installing a package from a script

  * Check if a package is installed

  * Removing a package

  * Updating a package

  * Locating an installed package

  * Cleaning cached files

  * Debugging and environment inspection

  * Using a local mirror with AMSpackages

  * Instructions for administrators

  * Installing python packages for users

  * Persistent configurations

  * Environment variables

* Appendix E: Mirroring the SCM package repository

  * Overview

  * Using "amsrepomirror"

  * Manual mirroring methods

  * MacOS and Linux

  * Windows

  * Using the mirror with AMSpackages

* Compiling AMS from Sources

  * Unpacking the distribution

  * Setting up environment

  * Running Install/configure

  * Compiling AMS

* Platform Specific Information

  * Machine-specific comments

* FAQ
