MacOS System Requirements, Conventions, and Installation
This toolkit is known to run on MacOS El Capitan 10.11.x (latest
update). We no longer test on previous versions of MacOS, although
previous versions of MAT have been known to run straightforwardly on
This toolkit depends on a number of external tools which must be
installed before you install MAT. For the Mac version, they are:
- Python, version 2.6 or later. Most of our development is
currently on 2.7. 3.x is known not to work. See the installation notes below for more
- Java, version 1.6.0_04 or later.
- MacOS X Developer Tools (optional)
The conventions are identical to the Unix conventions.
To prepare MacOS for installation of this toolkit, follow these
- Optionally, if you have not done so already, install the
Terminator tabbed terminal application. This application, if
found, is used by the MAT Web server
as a graphical interface; the Web server also runs in the
terminal, so you do not need this application. Terminator is
distributed with this toolkit; you can find the zip file in the
external/ subdirectory. The zip file will expand into a
directory named "terminator" which contains the Terminator
application; drag the Terminator application out of that
directory and into /Applications.
- Ensure that you have a recent version of Java. If you have
1.6.0_04 or later in
/System/Library/Frameworks/JavaVM.framework/Versions, you're all
Once you've completed these steps, you may proceed with the
installation, as follows:
During the installation, you might be prompted for various paths
and locations which the toolkit requires.
When the installation is complete, your runtime environment will be
configured for you.
dependencies, changing the configuration, or moving the
While it is possible to override MAT's runtime environment using
environment variables, it's not recommended. So you may have to do
something special if you want to change your installation in any
- If you want MAT to use a new version of Java or Python because
the Java or Python on your machine has been upgraded and the old
version is no longer present, just rerun the installer. The
installer will find the updated versions and reconfigure your
- If you want to change your runtime environment (e.g., enable
subprocess monitoring), you can edit
your config file and run the setup utility.
- If you want to move the MAT installation from one location to
another on the same machine, just move the toplevel MAT
directory and run
the setup utility (no config file variables need to be
updated by hand).
- If you want to move or copy the MAT installation to another
machine, the safest thing to do is rerun the installer on that