Migrating from Cumulus 1 to MX: Difference between revisions

m
Line 370: Line 370:
===Cumulus.ini===
===Cumulus.ini===


If your "Cumulus.ini" was actually called "cumulus.ini" you should rename it to start with a capital letter.
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".


Please see [[Cumulus.ini#Parameters_changed]] to see the list of 2 parameters that must always be changed in this configuration file. They are also mentioned in next 2 sections (station settings and web pages) below.
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.


There are some differences in how the contents of this file are used in the 2 flavours, one 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 MX uses that to find the first log file to start reading from, it will ignore any log files for earlier dates; whilst Cumulus 1 always looks at all log files it finds in the data folder.
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 several other differences in settings stored in "Cumulus.ini", but you can address those later through the MX settings screens.
There are 2 exceptions to the above paragraph, if you look at [[Cumulus.ini#Parameters_changed]] you will see the list of 2 parameters that must always be changed in this configuration file. 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, one 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.
 
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 one, and for these you wil need to look up the link earlier in this paragraph.
 
For the read-only settings in Cumulus.ini, some of the documentation is only in the forum.  To improve that aspect of the wiki article is on my to do list for another day.


== Station connections==
== Station connections==
5,838

edits