5,838
edits
Migrating from Cumulus 1 to MX: Difference between revisions
Migrating from Cumulus 1 to MX (view source)
Revision as of 08:44, 28 September 2020
, 08:44, 28 September 2020→Editing files
m (→Changing from Cumulus 1 to MX: adding some separate device text) |
m (→Editing files) |
||
| Line 384: | Line 384: | ||
== Editing files== | == 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=== | ===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. | 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=== | ===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" | 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 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. | ||
| Line 397: | Line 399: | ||
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. | 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 | There are a few exceptions to the above paragraph, if you look at [[Cumulus.ini#Parameters_changed]] you will see the list of a few parameters that '''may need 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. | |||
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 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 | 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 1 versions, and for these you will need to look up the link earlier in this sub-section. | ||
For the read-only settings in Cumulus.ini, | For the read-only settings in Cumulus.ini, you may need to read the documentation in the forum. The Cumulus.ini article in this wiki has had read-only parameters added to it now, but it is impossible to know if all have been covered there. | ||
== Station connections== | == Station connections== | ||