Migrating from Cumulus 1 to MX: Difference between revisions

m
Line 86: Line 86:
*'''Please note, the information for MX is taken from notes by Steve Loft, and applies to MX 3.0.0. Although, some updates have been made in line with release announcements by Mark, it is likely Mark has made other changes that affect the various log files that are not detailed in the release announcements, possibly making some content obsolete.'''   
*'''Please note, the information for MX is taken from notes by Steve Loft, and applies to MX 3.0.0. Although, some updates have been made in line with release announcements by Mark, it is likely Mark has made other changes that affect the various log files that are not detailed in the release announcements, possibly making some content obsolete.'''   


In particular '''internal''' changes mentioned in release announcements for versions 3.6.x, and 3.7.0, have made MX work significantly differently.
In particular '''internal''' changes mentioned in release announcements for various 3.6.x versions, and for release 3.7.0, have made MX work significantly differently and it is now more fussy about content of log files.
* If you move from Cumulus 1 to a version of MX  up to 3.5.y, the transfer is likely to be significantly easier. This is because Steve Loft was keen to keep forward compatibility.
* If you move from Cumulus 1 to a version of MX  up to 3.5.y, the transfer is likely to be significantly easier. This is because Steve Loft was keen to keep forward compatibility in his beta MX, and it took a while for Mark Crossley to revise the part of the MX code that reads log files.
** Cumulus 1 is tolerant of various separators for dates and times. Cumulus MX 3.0.0 insists all times use a colon separator (says Steve Loft), and all dates are in ISO format.  
** Cumulus 1 is tolerant of various separators for dates and times.  
**However, MX 3.0.0 will read the date/time entries in the Cumulus 1 format, and it will only change them to the new format when it needs to update a particular entry (e.g. an extreme) in that particular file.  Consequently some files will have a different formats for the extremes that have existed for a while and for any new ones, meaning both formats will co-exist in those files.
**Cumulus MX 3.0.0 insists all times use a colon separator (says Steve Loft), and all dates are in ISO format.  
* If you move from Cumulus 1 to a version of MX that is 3.6.z or higher, you may find that log files can no longer be read.  
*However, '''MX releases from version 3.0.0 to 3.5.4''' will read the date/time entries in the Cumulus 1 format, and it will only change them to the new format when it needs to update a particular entry (e.g. an extreme) in that particular file.  Consequently some files will have a different formats for the extremes that have existed for a while and for any new ones, meaning both formats will co-exist in those files.
**In particular 3.7.0 onwards releases are very fussy about symbols used to separate parts of dates, within times, and all must match the latest locale settings.
** It is difficult to move from Cumulus 1 to a release of MX that is 3.6.z or higher, mainly because you may find that log files can no longer be read.  
**In particular releases 3.7.0 onwards are less tolerant of log files created by the original Cumulus software; each log file in modern MX releases must have lines that match what is in the local settings absolutely perfectly; this means MX is now very fussy about the symbol that separates the 3 parts of a date, very fussy about decimal symbol, and number of fields in files.
   
   
General points:
===General points===
 
* Note that if you run MX on a UNIX based operating system (e.g. Linux or Raspberry Pi OS) all file names are case-sensitive, please read documentation to see where capital letters are required in those file names. Be aware that wiki pages change first letter to a capital even when a file that must be all lower-case is being described.
* Note that if you run MX on a UNIX based operating system (e.g. Linux or Raspberry Pi OS) all file names are case-sensitive, please read documentation to see where capital letters are required in those file names. Be aware that wiki pages change first letter to a capital even when a file that must be all lower-case is being described.
* Cumulus 1 is reasonably tolerant of numbers using a comma to separate the integer and decimal part of real number.  
* Cumulus 1 is reasonably tolerant of numbers using a comma to separate the integer and decimal part of real number.  
5,838

edits