Migrating from Cumulus 1 to MX: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m
m (→‎Changing from Cumulus 1 to MX: adding some separate device text)
 
== Editing files==
 
Do remember that with Cumulus 1 on Windows, each line in every file ends with both carriage return and line feed. If you are moving to MX on a Mac, each line should end with just a Carriage Return. For all Unix-based operating systems (Linux, Raspberry Pi OS, and other variants), each line should end with just a Line Feed. There are various editing tools that can do the necessary modification of all lines for you in just a couple of clicks; one such tool is Notepad++ (which although mostly used on PCs, can be used in other operating systems).
 
===Log files===
 
See individual log file pages already referenced (alternatively access from Log Files index page) where there is more information for how to edit your .ini files to work with MX, they may work without change as MX is generally designed to accept Cumulus 1 files, but it does depend on how you have set up the device on which you are running MX (and may depend on version of Mono or .NET you are using). You '''may''' need to alter format for various date fields, and if you use decimal comma, you '''may''' need to change some figures to use decimal full stops. You may need to experiment, try first without editing, if that fails then edit dates and real numbers.
 
===Cumulus.ini===
 
If you are running MX on Windows, filenames are not case sensitive, so MX will recognise "Cumulus.ini" or "cumulus.ini". But although Cumulus 1 might recognise "Cumulus1.ini" or anything else other than "Cumulus.ini"., MX only recognises "Cumulus.ini".
 
If you are planning on running MX on another device, filenames are case sensitive, and your Cumulus 1 configuration file must be called "Cumulus.ini" with an initial capital followed by lower case, so it might need to be renamed.
If you read the [[Cumulus.ini]] article, you will see that some parameters in the configuration file are only used by Cumulus 1, some only by MX, and some apply to both. MX will ignore any Cumulus 1 parameters it does not recognise, so you don't need to edit out lines. MX will also add any parameters it needs as read/write parameters for its settings, so in general you do not need to add them manually, you can simply set them using the relevant page in the settings part of the admin interface. There are of course a number of read-only parameters (these are ones that are entered directly into the configuration file and cannot be edited using settings), and there are some of these that are Cumulus 1 only and some that need to be added manually if you want to change the default.
 
There are 2a few exceptions to the above paragraph, if you look at [[Cumulus.ini#Parameters_changed]] you will see the list of 2a few parameters that must'''may alwaysneed to be changed''' in this configuration file (it depends on what type of weather station you use). But you don't need to look them up as they are also mentioned in next 2 sections (station settings and web pages) below.
 
There are also some differences in how some parameters in this file are used in the 2 flavours.
 
There are also some differences in how some parameters in this file are used in the 2 flavours, oneOne to remember now is to check the "StartDate=" line in the '[Station]' section is correct for your earliest data before you let MX read this configuration file for first time, as '''CumulusMX.exe''' uses that to find the first log file to start reading from, it will ignore any log files for earlier dates; whilst Cumulus 1 and '''ExportMySQL.exe''' can process all log files in the data folder as they look for file name pattern and do not check dates.
 
It is advised that you work through all the MX settings screens once you have the [[MX Administrative Interface|Admin interface]] working, ensuring they do represent how you want MX to work. Some of the settings are for functionality you did not have in Cumulus one1 versions, and for these you wilwill need to look up the link earlier in this paragraphsub-section.
 
For the read-only settings in Cumulus.ini, someyou ofmay theneed documentationto isread onlythe documentation in the forum. ToThe improveCumulus.ini thatarticle aspectin of thethis wiki articlehas ishad onread-only myparameters added to doit now, but it is impossible to know if all listhave forbeen anothercovered daythere.
 
== Station connections==
5,838

edits

Navigation menu