Table of Contents
We test some of the best games on several Macs, ranging from powerful iMacs to older MacBooks, to help you figure it out. Mac Mini: Mac Mini: 2018: 3 GHz Intel.
- Installation using the self-extracting archive (osx_x64_64_sfx.exe)
To install GAMS, please follow the steps below as closely as possible. We advise you to read this entire document before beginning the installation procedure. Furthermore, we recommend to use the PKG installer for Mac OS X because it includes the GAMS Studio and it integrates GAMS into Mac OS X, e.g. it is possible to open the GAMS Studio via the Launchpad.
Two installation procedures are available for GAMS on Mac OS X:
- Obtain the GAMS PKG file, which is available from http://www.gams.com/download.
- Double click the package and follow the instructions. By clicking on
Customise
in the tabInstallation Type
you can decide to add GAMS to the PATH as well as to reject the installation of GAMS Studio. Note that adding GAMS to the PATH is done by modifying your shell profile file (~/.zprofile
,~/.bash_profile
etc.). A backup of your old profile is saved (~/.zprofile.gamsbackup
,~/.bash_profile.gamsbackup
etc.). - In order to test the GAMS installation with
GAMS Studio
open theLaunchpad
and click theGAMS Studio 33
icon to open the application. Alternatively, go to Applications and open theGAMS Studio 33
application. Install your license via the corresponding GAMS Studio dialog. The license file is nowadays sent via email, with instructions. You can also request a demo license from http://www.gams.com/download.
Optionally, you can create the license file 'gamslice.txt' in a directory that GAMS searches to find a license. GAMS searches a couple of system wide and user specific standard locations for a license file.
- Open the
Model Library Explorer
and open theTRNSPORT
model (sequence number 001). Run the model and check the contents of the process log, which should be similar to the Terminal output listed in the next bullet point. In order to test the GAMS installation without using
GAMS Studio
open a Terminal window. Execute the following commands to see if everything works as expected:The output should be similar to this:
To uninstall a GAMS installation that was installed using the PKG installer, run the following command from the terminal: sudo bash /Library/Frameworks/GAMS.framework/Versions/33/Resources/uninstall.sh
. Additionally, you can remove GAMS from the PATH in your shell profile file (~/.zprofile
, ~/.bash_profile
) if GAMS was added to the PATH during installation.
- Obtain the GAMS distribution file, which is available from http://www.gams.com/download, in one large self-extracting zip archive with a
_sfx.exe
file extension, e.g.,osx_x64_64_sfx.exe
. Check that it has the execute permission set. If you are not sure how to do this, just type in the commandchmod 755 osx_x64_64_sfx.exe
.- Attention
- The common way to install GAMS on a Mac is the PKG installer. When one tries to run the sfx installer (e.g. for unattended installation) under macOS 10.15 (Catalina) or newer, the installer and several related files will be tagged with the
com.apple.quarantine
flag. There are different solutions to this problem:- The flag can be removed by the following command:
- Instead of downloading the sfx installer through the browser, use a command line tool such as curl (note that by downloading the software, you agree to the License Agreement). The download link may need to be adjusted, depending on the distribution that should be downloaded.
- Choose a location where you want to create the GAMS system directory (the GAMS system directory is the directory where the GAMS system files should reside). At this location the GAMS installer will create a subdirectory with a name that indicates the distribution of GAMS you are installing. For example, if you are installing the 24.3 distribution in
/Applications/GAMS
, the installer will create the GAMS system directory/Applications/GAMS/gams24.3_osx_x64_64_sfx
. If the directory where you want to install GAMS is not below your home directory, you may need to have root privileges on the machine. - Create the directory that should contain the GAMS system directory, for instance
/Applications/GAMS
. Change to this directory (cd /Applications/GAMS
). Make surepwd
returns the name of this directory correctly. - Run the distribution file, either from its current location or after transfering it to the directory that should contain the GAMS system directory. By executing the distribution file, the GAMS distribution should be extracted. For example, if you downloaded the distribution file into your home directory, you might execute the following commands:
Create the license file
gamslice.txt
in a directory GAMS searches to find a license. The license file is nowadays sent via email, with instructions. You can also request a demo license from http://www.gams.com/download.- Attention
- Do not store the
gamslice.txt
in the GAMS system directory. This invalidates the code signature and cause Gatekeeper to reject the bundle!
GAMS searches a couple of system wide and user specific locations for a license file. For Mac OS X these locations include
/Library/Application Support/GAMS
and/Users/username/Library/Application Support/GAMS
. The locations can vary due to different system configuration. One can get an ordered list of data directories GAMS searches forgamslice.txt
by running the program./gamsinst -listdirs
from the GAMS system directory. Even though this list might contain locations in the system directory, e.g./Applications/GAMS31.1
we strongly discourage to placegamslice.txt
here.Change to the GAMS system directory and run the program
./gamsinst
. It will prompt you for default solvers to be used for each class of models. If possible, choose solvers you have licensed since unlicensed solvers will only run in demonstration mode. These solver defaults can be changed or overridden by:a. rerunning
./gamsinst
and resetting the default valuesb. setting a command line default, e.g.,
gams trnsport lp=bdmlp
c. an option statement in the GAMS model, e.g:
option lp=bdmlp;
- Add the GAMS system directory to your path (see below).
- To test the installation, log in as a normal user and run a few models from your home directory, but not the GAMS system directory:
- If you move the GAMS system to another directory, remember to rerun
./gamsinst
. It is also good practice to rerun./gamsinst
when you change your license file if this has changed the set of licensed solvers.
Access to GAMS
To run GAMS you must be able to execute the GAMS programs located in the GAMS system directory. There are several ways to do this. Remember that the GAMS system directory in the examples below may not correspond to the directory where you have installed your GAMS system.
- If you are using the C shell (
csh
) and its variants you can modify your.cshrc
file by adding the second of the two lines given below: - Those of you using the Bourne (
sh
) or Korn (ksh
) shells and their variants can modify their.profile
file by adding the second of the three lines below: If the.profile
file does not exist yet, it needs to be created. You should log out and log in again after you have made any changes to your path. - You may prefer to use an alias for the names of the programs instead of modifying the path as described above. C shell users can use the following commands on the command line or in their
.cshrc
file: The correct Bourne or Korn shell syntax (either command line or.profile
) is: Again, you should log out and log in in order to put the alias settings in.cshrc
or.profile
into effect. - Casual users can always type the absolute path names of the GAMS programs, e.g.:
Example
The following shows the log of a session, where a user downloads a GAMS 24.3.1 system and installs it under Applications/GAMS/gams24.3_osx_x64_64_sfx
. It is assumed that a GAMS license file has been stored as /Users/doe/gamslice.txt
.
Download GAMS Release 33.2.0 (December 01, 2020)
Please consult the release notes before downloading a system. Here are the detailed platform descriptions and installation notes.
The GAMS distribution includes the documentation in electronic form.
Platform
Microsoft Desktop and Server Operating Systems (x86_64 architecture)
2018 Mac Desktop
GNU/Linux System (x86_64 architecture)
Macintosh System (x86_64 architecture)
Notes
Model size limits with a demo license
- For linear models (LP, RMIP, and MIP) GAMS will generate and solve models with up to 2000 constraints and 2000 variables
- For all other model type GAMS will generate and solve models with up to 1000 constraints and 1000 variables
- Some solvers may enforce tigther limits. Please check the licensing chapter for details
The GAMS log will indicate that your system runs in demo mode
GAMS will terminate with a licensing error if you hit one of the limits above:
MD5-Hash values.
Use a program like md5sum to verify. This should come preinstalled on most Linux systems.
On Windows systems, open a powershell and enter
Get-FileHash .windows_x64_64.exe -Algorithm MD5
On Mac OS systems, you can use
md5
in the terminal.For Mac OS X, also a simple self-extracting archive is available, which you can download here.
Note, that this archive does not contain GAMS Studio.
The SmartScreen Filter on Microsoft Windows might give a warning during the installation. For more information please check our Support Wiki.
To deliver GAMS with the best performance we are using the Amazon CloudFront web service, a global network of edge locations for content delivery.
Older GAMS Distributions
Request even older distributionsSign up for Our Newsletters
2018 Mac Mini
To get informed when a new version of GAMS is released, receive information about new features or just to stay in touch, Sign up for Our Newsletters.