Draft Release (Ubuntu 20.04)

Setup

• Extract the zip folder and change directory to the root directory
• Run the configure.sh script
  • Note that if you do not have ROS installed, you can simply hit "ENTER" when asked for your ROS distribution.
• Run source ~/.bashrc to make sure environment variables are set properly

Running

• In the root directory of the extracted files, run ./bin/MACE
  • This will run the configuration file located at MaceSetup_Configs/Default.xml

NOTE:

You do not need ROS to run MACE, however these binaries were built with ROS support. If you do not have ROS installed, simply remove the ROS module from the configuration file.

Draft Release (Ubuntu 18.04)

This release is valid for Ubuntu 18.04. It has not yet been tested for other operating systems or versions.

1. Download the assets available below

2. Unpack the OpenMACE_RELEASE zip file

3. To run an instance of MACE, run the following command, where <MACEPATH> is the location where OpenMACE_RELEASE directory has been unpacked:
   $ <MACEPATH>/OpenMACE_RELEASE/MACE.sh

If you are already in the /OpenMACE_RELEASE directory, simply enter
$ ./MACE.sh

Note:
This will launch the default configuration file MaceSetup_Configs/Default.xml
To identify a new directory holding configuration files, modify the "MACE_ROOT" environment variable by entering

$ export MACE_ROOT="<mynewpath>"

Where <mynewpath> is a directory containing the folder with the configuration files. For example, another instance of MACE.

Draft Release (Ubuntu 16.04)

This is a draft release of the OpenMACE software. Binaries for the MACE GUI for several operating systems have been provided. Supported operating systems are:

• linux-armv7l
• linux-ia32
• linux-x64
• win32-ia32
• win32-x64

Binaries for OpenMACE have also been provided for both ROS and non-ROS builds for Ubuntu 16.04 (gcc 5.4.0).

Instructions:

1. Unpack the tar.gz file, which contains three .tar.gz files (one with the GUI binaries, one with the OpenMACE-ROS binaries, and one with OpenMACE-non-ROS binaries).
2. Unpack the GUI binaries. Note that the configuration file for the GUI is located in the top-level directory
3. Unpack the version of OpenMACE you wish to use
4. Run the configure.sh script by running: . configure.sh
   • Note: the space is important after the . to ensure environment variables are persistent
5. Navigate to the /bin directory and run ./MACE to launch with the default XML configuration file (i.e. MaceSetup_Configs/Default.xml