MacOS Quickstart Guide

This quickstart guide is for installing AMS on an Apple MacOS machine. Please also read the generic Installation manual if you encounter problems.

Start with downloading AMS2023 for MacOS from the main download page, and save it on your computer. Open ams2023.104.arch.openmpi.dmg after the download is complete. Newer versions of AMS will have a different number in the file name.

Important

Stop! Make sure you have the right version of AMS for your CPU architecture before proceeding:

  • If you have an M1/M2/M3 mac, download the version labeled Apple Silicon.

  • if you are using an x86_64 intel mac, download the version labeled x86-64, Intel 64-bit.

Drag the AMS application (called AMS20XX) from the disk image to your disk, for example by dropping it on the icon of the Applications folder in the disk image.

Important: the folder in which you store the AMS application should not contain spaces in its name (or in the names of any of its parent folders)!

Installing in the standard /Applications folder should work fine.

The AMS package needs a valid license file to run.

Double click the AMS20XX application.

On MacOS Catalina and above when you open AMS20XX for the first time from your Applications, you’ll see a notice “AMS20XX can’t be opened because Apple cannot check it for malicious software”. To Fix this

  • In the Finder on your Mac, locate the app you want to open.

  • Control-click the app icon, then choose Open from the shortcut menu.

  • Click Open.

The app is then saved as an exception, and you can open it in the future by double-clicking it or open it from your Applications on the Dock.

If you have no valid license a window will appear that allows you to request and install a license file. If a license file is available for you it will be installed automatically.

Otherwise you will receive a mail when a license file is available. Double click the AMS20XX application again and request a license again to install it. Note that you will never get more than one license for a particular machine, so no need to worry about requesting a license twice.