|
|
|
Version 1.9.0 now available! See below for instructions to download, install, or upgrade.
See the list of changes here.
|
|
Download
| Java JDK |
|
Mango requires the pre-installation of Java JDK 1.6. Serotonin recommends using the SUN JDK
(available here).
|
| RXTXcomm |
Serial-based data sources (such as Modbus RTU) require the presence of the RXTXcomm API software.
If you do not use these protocols, you can skip this section.
Download the following files to the given directories. RXTXcomm.jar is required for all host types.
Note that the Linux library is for x86 hosts only. For other host types, please see
rxtx.org.
|
| Apache Tomcat |
|
Mango is a web application that requires a Java Servlet/JSP container within which to run. It has
been tested with Apache Tomcat, but has no known dependencies. If you already have Tomcat or another
container installed, you should be able to install the Mango WAR file as a web application. If you do
not have a container installed on your host system, you can download Tomcat below, or from
here.
|
| Mango M2M Binaries |
|
If you only wish to run Mango as an application, download the binary package for your system below.
The upgrade packages are for upgrading existing Mango installations; the others are for new
installations.
|
| Mango M2M Source |
|
Download Mango M2M source code here.
|
|
|
Upgrade instructions
If you already have an earlier version of Mango running, you can simply upgrade your existing installation.
If you do not have an existing installation, please follow the 'Installation instructions' below.
| Database backup |
|
It is recommended that you make a backup of your database in case there are problems during the
upgrade process. This can easily be done by making a copy of the entire database directory, by
default named 'mangoDB'. On Windows hosts, by default the database will be in the directory
<tomcat-home>/bin/mangoDB. On *nix, by default the database location depends on the current
working directory at startup, and so will probably be found in the directory from which the
'startup.sh' script is run.
|
| Upgrading Mango M2M |
Stop your instance of Tomcat. Delete the <tomcat-home>/work directory. (This is a cache of
compiled JSPs that are known to sometimes not update following an upgrade.)
Upzip the Mango binary upgrade archive file into the <tomcat-home>/webapps/ROOT directory. When
you start Tomcat next Mango will be automatically upgraded. Depending on the speed of your system and
the amount of existing data in your tables it could take a few minutes to update the database.
Restart the Tomcat server. Before logging in, press Ctrl+F5 on the login page (to refresh your
browser's cache of resources.) After logging in, validate that your system has properly upgraded by
checking the "System information" page ( ).
|
| Problems? |
|
If you are having problems, please post questions in the
Mango installation forum.
|
|
|
Installation instructions
| Prerequisites |
These instructions assume that you have successfully installed the Java JDK 1.6.0 (or higher), and
RXTXcomm if required). See Download above for more information.
Ensure that JDK 1.6.0 runs by default by executing the command "java -version" at a
command prompt. (It should print out "java version "1.6.0"".) Mango will not start properly
under an older version of Java. If the correct version of Java is not displayed, set your JAVA_HOME
environment variable to <jdk1.6-home>.
Note that Mango is designed to operate in an "always-on" environment. Mango can tolerate
frequent system restarts, power failures, and other interruptions, but optimal monitoring and data
logging will be achieved in an environment that runs continuously.
|
| Installing Apache Tomcat |
Create a directory in which to unzip Tomcat. We will refer to this directory as <tomcat-home>.
Unzip Tomcat in this directory. By default, Tomcat will service requests at port 8080. To change this
to another port, edit the "Connector" element in <tomcat-home>/conf/server.xml.
To start Tomcat, execute either <tomcat-home>/bin/startup.bat (Windows) or
<tomcat-home>/bin/startup.sh (*nix), depending on your host system type. If Tomcat started
successfully, you should see a Tomcat welcome page when you direct your browser to
http://localhost:8080/ (if you did not change the port in server.xml).
Shut down Tomcat before continuing with the installation. Either close the Tomcat window, or execute
either <tomcat-home>/bin/shutdown.bat (Windows) or <tomcat-home>/bin/shutdown.sh (*nix),
depending on your host system type.
|
| Installing Mango M2M |
These instructions assume that you will be installing Mango as the root application within Tomcat.
Mango can also be installed in an application path if desired, but such an installation is not
described here.
You may optionally clear out the applications that are shipped with Tomcat, as they are not required.
To do so, delete all directories under <tomcat-home>/webapps. Then, recreate the ROOT
subdirectory.
Unzip the Mango binary archive into the <tomcat-home>/webapps/ROOT directory. When you start
Tomcat next (see above), Mango will be started as well. Depending on the speed of your system it
could take a few minutes to create the database tables. Tomcat (and Mango) will have completed
starting up when the Tomcat console displays the message "INFO: Server startup in xxx ms"
(where "xxx" is the number of milliseconds it took to start up). When you direct your
browser to your Tomcat installation, you should now see the Mango login page.
Upon installation, Mango creates a single login account with username "admin" and password
"admin". Once you log in, you are strongly encouraged to change at least the password for
this account on the "Users" page ( ). Also, you
can set various system properties on the "System settings" page
( ).
Congratulations! Mango is now ready to use!
|
| Problems? |
|
If you are having problems, please post questions in the
Mango installation forum.
|
|
|
