Updating MX to new version: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search

Updating MX to new version (view source)

Revision as of 17:54, 3 July 2024

728 bytes added ,  3 July 2024
m
→‎Installer Option
 
(3 intermediate revisions by 3 users not shown)
For a Linux Operating system: <code>sudo systemctl stop cumulusmx</code>.
 
For Microsoft Windows Operating System: (a contributor who uses Microsoft Windows needs to modify this page)<br>
 
Open Windows Administration Tools from Windows Task Bar, select Component Services, click on Services (local)
In middle window select CumulusMX service from the list; click on Stop the service option. (click on Start the service after upgrade)
 
==Upgrading if you run MX interactively==
[https://cumulus.hosiene.co.uk/memberlist.php?mode=viewprofile&u=9016 HansR] on support forum has developed an multi-platform installer, see [https://cumulus.hosiene.co.uk/viewtopic.php?f=44&t=18916 Multiplatform Installer for CumulusMX] which makes life a lot easier if you do not wish to dive into the (file level contents) internals of CumulusMX.
 
#Copy the contents of the '''[https://cumulus.hosiene.co.uk/viewtopic.php?p=150084#p150084 InstallCMX.exezip]''' to any directory you want, on the drive where you wish to install (or have previously installed) MX.
#Copy the CumulusMX release distribution zip(s) to that same directory, if you have not already done so. You may have more than one distribution in the same directory.
#*The install procedure gives you the possibility to select, or define, the Archive to install, and the location where to install.
#Stop CumulusMX
#Run '''InstallCMX''' and confirm / fill in (on the console) where you wish to install (or update) CMX. The default for Windows is C:\CumulusMX\ and for Linux it is : /home/CumulusMX. The Installation directory can be modified. Note that for an ''image install'' you have to use /opt/CumulusMX.
#* You can give the '''build number''', for the release distribution zip, to install as command line '''argument'''.
#Start CumulusMX
 
'''NOTE:''' On Windows you run the installerit as any other command linecommandline executable and it is best to open a command window in which you start the installer. On Linux you run it on the command linecommandline as "mono ./InstallCMX.exe", theor mono"dotnet command./InstallCMX.dll". canNote bethat omittedon ifwindows monoyou iscan already active (e.g. if youalso run CumulusMX as a service, and stop it, mono remains active)./InstallCMX.exe
'''NOTE:''' In an existing installation with modified files, make sure those are in a different, either filename or folder (a safe place). If they have the same name as files in the distribution, they will be overwritten.
'''NOTE:''' Check in the <code>webfiles</code> directory to see if any files there have been modified, since your last upload to your web server. If so, move those new files to the website.
 
After the installation, there is a '''log file'''. Check the log file to see everything has gone well.
There is also an '''ini file''' where you can control:
* NormalMessageToConsole=true or (default) NormalMessageToConsole=false
* TraceInfoLevel=Warning (out of: Error, Warning, Info, Verbose, None)
Any reactions (thank you, issues and questions) please post in the [https://cumulus.hosiene.co.uk/viewtopic.php?f=44&t=18916 download thread of the installer].
 
Modifications and additions on user request can be discussed (e.g. think about automated start/stop, upload of webfiles to the directory etc....), use the talk for this page and create a post in the above thread.
 
==Upgrading if you are running MX on a Linux computer==
 
 
====if using any 3.7.y0 release, any 3.8.x release, or 3.9.y release====
 
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 a release earlier that 3.7.0, you can note there were3.7.0 nowas otheronly buildsbuild in 3.7.y series, but because 3.7.0 introduced a lot of changes these staged upgrades recommend that this version3.7.0 is implemented, and run for a while, before continuing to upgrade.▼
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]).
 
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.
▲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.
 
VersionIt 3.8.0is wasoptional ato majorinstall release, as3.9.6 itbuild introduced3101, thebecause abilitythat tois runa Cumulussafe MXrelease asto ause service. However,while there were bugs in the builds in all 3.8.z versions, and in someother 3.9.x versionsreleases, sohowever that is why you need to skip through intermediate builds to release 3.9.6 build 3101 as a minimum,please doingaction the one-off changes noted as IMPORTANT here:
 
'''IMPORTANT''' one-off actions needed:
* 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.
 
IfBe youaware dothat implement3.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 build 3101,(if you canhave continueimplemented that) to upgrade,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 ====
Retrieved from "https://www.cumuluswiki.org/a/Special:MobileDiff/10078...11774"

Navigation menu