Updating MX to new version: Difference between revisions

Updating MX to new version (view source)

Revision as of 08:11, 24 July 2020

1,280 bytes added , 08:11, 24 July 2020

m

→‎What to read (and when) before updating

Sfws

5,838

edits

@@ Line 52: / Line 52: @@
 When the '''Status''' option of this script is used, whenever a new release of MX is available, it will output a message.
-== What to read (and when) before updating ==
+= What to read (and when) before updating =
-=== Updating from immediately preceding build ===
+== Updating from immediately preceding build ==
-==== The release announcement ====
+=== The release announcement ===
 The release announcement is found in [https://cumulus.hosiene.co.uk/viewtopic.php?f=40&t=17887 Cumulus MX Announcements and Download - PLEASE READ FIRST] topic of the support forum.
@@ Line 76: / Line 76: @@
 ***Finally you might be given advice to avoid using certain parts of the functionality or take some other action until the next release is available.
-====Other places where you can find information about release content ====
+===Other places where you can find information about release content ===
 Although it is not always kept in step, a concise summary of all formal MX releases is available at [[Cumulus_MX_formal_release_versions]].
@@ Line 82: / Line 82: @@
 You can also view the latest [https://github.com/cumulusmx/CumulusMX/blob/master/Updates.txt Updates.txt].
+===Deciding whether to update to new release ===
+*Any new development or change in a new version of MX might cause problems for some users. You might want to stick with the version you are already using unless you really need any new functionality or the fixes gained by upgrading.
+*Also remember that there are bugs in all versions of MX, this is a large and complicated package, and the current developer has not been able to test all the code with all possible settings and all possible weather stations.
+==Updating to a new minor build, skipping in-between minor builds==
+For a minor version build either the associated version number does not change or only the final section changes (3.x.y to 3.x.z).
+===Reading multiple release announcements===
+If you are skipping some intermediate builds, then you will need to read each of the formal release announcements for builds after the build you currently use. You need to apply the cumulative actions recommended. Otherwise, most of the advice above for updating from immediately preceding build still applies.  The other sources of release information mentioned above may be consulted as an alternative.
+==Updating to a new major version==
+Generally, if the developer decides a new build warrants classification as a major version (i.e. 3.w.0) then the change being implemented is significant enough that updating might be more complex.
+=== Examples of what might be classified as a major change===
+*Additions to fields in log files
+*Additions or removals in configuration file
+*New pages in Administrative Interface
+*Catering for new weather station sensors, or new ways of communicating
+*Any interface functionality changes
+*Additions to files being generated for web server
+*Schema changes for database tables
-**Any new development or change in a new version of MX might cause problems for some users. You might want to stick with the version you are already using unless you really need any new functionality or the fixes gained by upgrading.
-*Also remember that there are bugs in all versions of MX, this is a large and complicated package, and the current developer has not been able to test all the code with all possible settings and all possible weather stations.
 '''Updating from an older version'''
-*If your update is skipping some intermediate versions, then check the corresponding release announcements or Wiki entries for every version since the one you have been using before planning your upgrade.
+*If your update is skipping  then check the corresponding release announcements or Wiki entries for every version since the one you have been using before planning your upgrade.
 **Again there may be one-off actions required at particular in-between versions and these will not be described in the Wiki whether on the [[Software]] page or the [[Cumulus_MX_formal_release_versions]] page.