How to upgrade Mango

June 16th, 2020


Mango will automatically check for new updates each day and notify you on the Modules page displaying the number of modules that can be upgraded. New features and bug fixes are being released regularly so it's good to check here often. There is also an event triggered when new upgrades are available which you can configure to send you an email notification.

Look on the Administration > Admin home page and click on the Modules icon to check for upgrades

Screenshot 2018-05-04 15.55.12.png

On the Administration > Modules page you can click the Check for upgrades button to automatically check or you can do an Offline upgrade if your server does not have internet connection. For the offline upgrade download the Module manifest file and use it at https://store.mango-os.com/account/manualUpdate to download your offline updates files.

After you click the Check for upgrades button you will see a list of upgrades and modules available for installation.

Select the Modules to upgrade and click the Upgrade/Install button to download and install the modules. Mango will shut down and restart to complete the process.

Screenshot 2018-05-04 16.10.24.png

It is recommending that you read the release notes for every upgrade before preforming to insure it won't cause any changes with your Mango configuration.

Note: It is recommending that you read the release notes for every upgrade before preforming to insure it won't cause any changes with your Mango configuration.

Use caution when installing any new modules. Be sure you know what they are before you install them.

If your current version is less than 2.5.2 you can follow the manual instructions below.

See our forum for help with the upgrade


Upgrade for Windows Systems

Note for Windows users: If you are running a Mango version prior to 2.6 on Windows using the /bin/ma-start.bat file you need to first download the following two file and place into your MA_HOME/bin/ folder overwriting the files there.

What if I didn't get the new ma-start.bat and upgrade.bat before I attempted to upgrade?

Not to worry. You can recover from this mistake.

  • The result of this mistake will likely be you will still see your old version of Mango when you go to the Modules page and most or none of your modules will appear.
  • Stop Mango
  • Delete the “lib” folder in your MA_HOME directory
  • Go to your MA_HOME/ directory and unzip the m2m2-core-3.x.x.zip file. Be sure to unzip in the MA_HOME/ directory and choose Copy and Replace for all files
  • Remove the m2m2-core-3.x.x.zip from the MA_HOME folder
  • Now start Mango and allow it complete the upgrade

Note: If you are running Windows as a service first install the two files above and then do the upgrade but use the advanced option to NOT restart Mango. After all the files are downloaded stop the Mango service and start Mango once using the ma-start.bat file.

Standard Manual Upgrade Instructions

  1. Stop Mango

  2. Make a full backup of the MA_HOME folder and database. If using MySQL do a msql dump to backup the database.

  3. Make sure your /classes/env.properties file has been copied to /overrides/properties/env.properties (this will insure your changes will remain after upgrade)

  4. Delete the “lib” folder in your MA_HOME directory

  5. Download and unzip the Mango Automation 2.X.X zip file into the MA_HOME folder overwriting the existing files.

  6. Start Mango and verify the upgrade.

Note: Some users upgrading from 2.4.2 using a H2 database may get an error stating wrong username and password for the h2 database. To correct this edit the env.properties file and set the H2 database username and password to blank.

Copyright © 2024 Radix IoT, LLC.