You will need to purchase a new license for Mango v5. You can do so here
General upgrade tips
Here are a few general reminders to look over before attempting to upgrade Mango to v5.
You should always back up your database and have a recovery plan before upgrading Mango!
- You should always test upgrades in a development environment before upgrading production instances of Mango.
If you have not created a separate data directory, now is the time to do this. If you have been upgrading Mango since. version 3.x this may apply to you. See the instructions at upgrade-to-v4.
When you first upgrade to Mango 5.0, your users may see a cached version of and older UI in their browser.
- If using Mango 4.x you should see a prompt to update in your UI
Users should close all their browser tabs which have Mango open and reopen them.
Alternatively hold shift and press refresh (Chrome), note that this may not work if you have multiple Mango tabs open.
As a last resort, completely clear your browser's cache.
Be sure to read the release notes for the core and any modules which you use!
Java / JDK Requirements
Mango v5 now requires Java 17. Please install OpenJDK 17 prior to upgrading to Mango v5 and ensure your JAVA_HOME environment variable points at the correct OpenJDK installation.
Radix IoT recommends the Azul Zulu builds of OpenJDK, however you can use your preferred vendor.
Upgrade Via the UI
- Navigate to the modules page and press the "Check for Upgrade" button.
Upgrade Via Store
Download the latest version of Mango, but don't unzip the file.
Place the zipped Mango file on the root directory of your Mango installation.
- If you have a pre-grant license, place this in the root directory as well.
Important Information about Future Upgrades
Beginning in version 5 we have introduced new unified versioning. Everything is now being released in blocks. Hence any updates (regardless of if they are in the core or a module) will be released in tandem as a new version. For example should the watchlist module receive a minor update, a new bundle would be released of the module and core as 5.0.1.