Windows Native System Requirements, Conventions, and Installation

System requirements

This toolkit is known to run on Windows 7. It has run in the past on Windows XP, but we no longer have access to Windows XP for testing. We have no access to Windows Vista, and don't expect to. We do not have access to Windows 8.

This toolkit depends on a number of external tools which must be installed before you install MAT. For the Windows version, they are:

Conventions

MAT is primarily a Unix-based tool, so the documentation is written mostly with reference to Unix. As a result, you should first familiarize yourself with the Unix conventions, and make sure you know the DOS CMD equivalents of basic Unix operations like pwd, cd, etc. We'll assume throughout that you've set your MAT_PKG_HOME cmd shell variable to the directory src/MAT inside the unpacked zip file.

The documentation assumes you've added Python to your Windows path.

MAT may be installed in directories whose paths contain spaces. If you do this, you'll likely have to wrap double-quotes around any references to MAT_PKG_HOME or subdirectories thereof:

> cd "%MAT_PKG_HOME%"
> dir "%CD%"

If you don't do this, you'll likely encounter bizarre behavior due to the path being expanded and split into command-line tokens according to the whitespace in the path.

Installation

First, ensure that you have Java installed. You'll need version 1.6.0_04 or later. The installer looks for any version of Java found in C:\Program Files\Java. The installer will probe all the Java versions and choose the newest one that meets the system requirements. If you don't have Java, you can get it from Sun.

Next, install Python. You don't need any of Mark Hammond's Python win32 extensions. You may want to add Python to your Windows path. None of the instructions in this documentation should require that, but if you do find an instruction to run python.exe, use the full executable path for Python if you haven't added it to your path..

Next, open a Windows cmd shell, e.g., via Start -> Run -> cmd. We recommend that you ensure that the output history is longer than the default 50 lines; click left on the leftmost icon in the top window bar in the "cmd" window, select Properties, select the Layout tab, and change "Height" under "Screen Buffer Size" to, say, 500.

Next, open the unzipped directory containing this distribution in your file viewer (e.g., navigating from "My Computer"). In the top directory of the distribution, you should see a file "install.py". In your cmd shell window, type "python" (if you've added Python to your Windows path), or the full path to the executable (probably "C:\Python27\python.exe"), and then a space, and then drag the "install.py" file to the cmd shell window. Switch to the cmd shell and press <return>. This will run the MAT installer.

The output of the installer is fairly verbose. If it does not print out "Done" at the end, it hasn't completed appropriately.

When the installation is complete, your runtime environment will be configured for you. The installed directory is not relocatable; you must rerun the installer if you move the installation.

Upgrading dependencies or moving the installation

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 tools.

If you want to move the MAT installation from one location to another on the same machine, just move the toplevel MAT directory - it's completely self-contained. If you want to move the MAT installation to another machine, the safest thing to do is reinstall on that new machine.