Updating MX to new version: Difference between revisions

m
Line 314: Line 314:




====if using any 3.7.y release, any 3.8.x  release, or 3.9.y release====
====if using 3.7.0 release, any 3.8.x  release, or 3.9.y release====


See sub-section directly above, that describes similar process, '''upgrade directly to 3.9.6, or any later build, within 3.9.x''', without any major change or to 3.12.0 with major change  (find either release from [https://github.com/cumulusmx/CumulusMX/releases this Github page]).
See sub-section directly above, that describes similar process,
* EITHER '''upgrade directly to 3.9.6, or any later build, within 3.9.x, without any major change,'''
* or to 3.12.0 with major change
* (find either release from [https://github.com/cumulusmx/CumulusMX/releases this Github page]).


If you are using 3.7.0 note there were no other builds in 3.7.y series, but because 3.7.0 introduced a lot of changes these staged upgrades recommend that this version is implemented, and run for a while, before continuing to upgrade.
If you are using a release earlier that 3.7.0, you can note 3.7.0 was only build in 3.7.y series, but because 3.7.0 introduced a lot of changes these staged upgrades recommend that 3.7.0 is implemented, and run for a while, before continuing to upgrade.


Version 3.8.0 was a major release, as it introduced the ability to run Cumulus MX as a service. However, there were bugs in the builds in all 3.8.z versions, and in some 3.9.x versions, so that is why you need to skip through intermediate builds to release  3.9.6 build 3101 as a minimum, doing the one-off changes noted as IMPORTANT here:
Be aware that 3.8.0 was a major release, as it introduced the ability to run Cumulus MX as a service, but there is no reason to install it as the ability to run either interactively, or as a service, continues to be available in all subsequent releases.  
 
It is optional to install release 3.9.6 build 3101, because that is a safe release to use while there were bugs in the builds in all 3.8.z versions, and in other 3.9.x releases, however please action the one-off changes noted as IMPORTANT here:


'''IMPORTANT''' one-off actions needed:
'''IMPORTANT''' one-off actions needed:
Line 326: Line 331:
* There is a further on-off change described in [https://cumulus.hosiene.co.uk/viewtopic.php?p=147329#p147329 release announcement for Patch release 3.9.1 - b3096] for those who use '''Mono''' to enable the executables to run.
* There is a further on-off change described in [https://cumulus.hosiene.co.uk/viewtopic.php?p=147329#p147329 release announcement for Patch release 3.9.1 - b3096] for those who use '''Mono''' to enable the executables to run.


If you do implement release 3.9.6 build 3101, you can continue to upgrade, as soon as you are happy to change your web server contents (if you are using web pages that MX provides).  You should continue in stages because it is mandatory to install 3.12.0 as only that release can rewrite your [[Cumulus.ini]] file ready for subsequent release, so ensure that 3.12.0 is working before installing current release as instructed in sub-sections for those using subsequent releases.
Be aware that 3.10.0 was withdrawn, but it was a major release that totally changed the files in [[Web folder]] and [[Webfiles folder]] within the release download. However, you can skip directly from 3.9.6 (if you have implemented that) to 3.12.0 as soon as you are happy to change your web server contents (if you are using web pages that MX provides), see sub-section above for further advice re web pages.  You should continue in stages because it is mandatory to install 3.12.0 as only that release can rewrite your [[Cumulus.ini]] file ready for subsequent release, so ensure that 3.12.0 is working before installing current release as instructed in sub-sections for those using subsequent releases.


====If using a 3.5.x release ====
====If using a 3.5.x release ====
5,838

edits