Start by downloading one of the Full Download files below.
|Mango Automation 3.7.4 Free||Free for personal & educational use with 300 Data Point Restriction|
|Mango Automation 3.7.4 Enterprise||Commercial / Enterprise Evaluation|
|Core Only - No Modules|
You need to have at least Java JDK 1.8 (also known as JDK 8) already installed on your system. Infinite Automation recommends using the Oracle JDK, available here. For Mango 3, we recommend use of Java 8.
Unzip the core zip file into any directory you like. To start Mango Automation, run one of the scripts provided, either ma-start.bat for Windows platforms or ma-start.sh for *nix. (Also note: for *nix you may have to run "chmod +x Mango/bin/*.sh" to make the script executable.)
In addition, for *nix users ensure that the Mango Automation home directory and all subdirectories are writable by the user under which Mango Automation will run.
To upgrade a core on a *nix system, simply restart Mango Automation with the new m2m2-core-x.x.x.zip file in the root directory of the instance. The process is the same on Windows if you are not running Mango Automation as a service. If a manual upgrade is necessary, you can find instructions here: help.infiniteautomation.com.
Download the module zip file into the <MA_HOME>/web/modules directory, and restart Mango Automation. Do not unzip the module files. The module file will be automatically expanded and any necessary installation will be performed upon start up. You can also download modules directly through Mango Automation on the modules.shtm page, and you will need to restart Mango Automation after the download to install them.
Mango Automation ships with the JSSC library, which is a cross-platform serial package. The OneWire module requires you to get an RXTX jar and an OS specific library. These are available for your O/S from rxtx.org. The DLL files for Windows installations can be put into the Mango Automation "overrides" directory. For *nix, object files need to be put into directories on the library path, which typically includes /lib and /usr/lib. All other serial data sources such as Modbus, BACnet or the generic serial module will work without extra effort.
A number of application settings are kept in the classes/env.properties file. You should not modify this file directly since new versions of the core will overwrite your changes. Instead, create the file overrides/properties/env.properties and override the properties as necessary. A core distribution will never contain this file, so your changes are safe!
Do not delete modules from your instance's 'modules' directory. If you no longer need a module, be sure to mark it for deletion in the module list page, and then restart your instance. This gives the module code an opportunity to clean up after itself when you restart your instance.
If you are upgrading an instance of Mango 2.x to Mango 3.x, you should be aware your license will not remain valid. License restrictions changed in Mango 3.x to provide more modules in the free version. For instance, where previously a module like Scripting had a one data point limit for the free version, now all Infinite Automation data sources are only restricted by a total point limit of 300. You should take care to backup your existing Mango instance and license when performing the upgrade! More notes about the upgrade procedure can be found here: Upgrade Notes