Linux is our prefered operating system to run Mango on in production enviroments.  Although Mango runs fine on Windows and Mac Linux is very stable, offers excellent performance and can be much easier to manage the system.

It is however only recomened to use Linux as your Mango operating system if you are already familiar and confortable with administering Linux systems.  For this reason these installation instructions assume knowledge of the Linux systems already exsists.

Before installing Mango you need to have Java JDK 1.8 installed. You can use OpenJDK but we recommend using Ocale JDK as faster perfomance has been observed.

You can check to see if you have it installed with

java -version 

and

echo $JAVA_HOME

Installing mango to your system is easy. This is done by adding a directory to your system called mango

mkdir /opt/mango

Now download mango from Infinite Automation site, then move it to the newly created directory and unzip it (you may need to install the linux package 'unzip' first).

Start Mango with the start up script in the bin folder in your mango directory 

sudo ./bin/ma.sh start

Also see the wiki to install the Linux service so Mango start automatically on bootup.


Installing Oracle JDK on Linux

We recommend installing the Oracle JDK into /usr/local/java

These instructions are based on the jdk release version 1.8.0_131 you can adapt them to the latest version as needed.

Download and untar the JDK files into a path as /usr/local/java/jdk1.8.0_131

Example Commands assuming you have JDK tar file in /usr/local/java

cd /usr/local/java

Untar the zip the file:

sudo tar -xvzf jdk-8u131-linux-x64.tar.gz 

you should see the directory: 

/usr/local/java/jdk1.8.0_131

Edit the environment files to add system variables JAVA_HOME: 

sudo nano /etc/environment

Add the following to the file

JAVA_HOME=/usr/local/java/jdk1.8.0_131

If you have path settings add at the end of PATH following :/usr/local/java//jdk1.8.0_131/bin” 

save /etc/environment (ctrl+x) 

for this changes to take effect you need to logout/login to your user account
 

Run the following commands to register the JDK with the System:

sudo update-alternatives --install "/usr/bin/javac" "javac" "/usr/local/java/jdk1.8.0_131/bin/javac" 1

sudo update-alternatives --install "/usr/bin/java" "java" "/usr/local/java/jdk1.8.0_131/bin/java" 1

sudo update-alternatives --install java /usr/bin/java /usr/local/java/jdk1.8.0_131/bin/java


These command notifies the system that Oracle Java JDK is available for use

sudo update-alternatives --set javac /usr/local/java/jdk1.8.0_131/bin/javac 

sudo update-alternatives --set java /usr/local/java/jdk1.8.0_131/bin/java

Verify your JDK is installed correctly:

java -version

This should return:

java version "1.8.0_131"
Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode)

Run:

echo $JAVA_HOME

This should return:

/usr/local/java/jdk1.8.0_131