5,838
edits
m (→Cumulus 1: typo) |
|||
(48 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
= Cumulus MX = | |||
: a cross platform version of Cumulus which runs on Windows, Linux (including the Raspberry Pi) and Mac OS X. (M Crossley update) | |||
Note: '''Cumulus MX is strictly for non-commercial, non-government use only.''' | |||
Both the mandatory [[MX Administrative Interface|Admin Interface]], and the optional [[New Default Web Site Information|default web site]], contains products produced by [https://www.highcharts.com Highsoft] which are not free for commercial and governmental use. | |||
:'''NOTE: On Linux/RPi/macOS, Mono version 5, or 6, is needed for MX Release v3.9.1 or later, (and other packages). | |||
: Mono v4 is subject to random crashes.'''<br /><br /> | |||
*There is also a pre-built disk image file for your first installation onto a Raspberry Pi. | |||
**This contains all you need; the latest lite version of the Raspberry Pi operating system, latest mono-complete ('''built on a model 3''), a MX installation (in "/opt/CumulusMX"), plus links to a temporary RAM drive for temporary files (reducing wear on micro-SD card). | |||
***The instructions for using this image can be found here: [[Raspberry_Pi_Image|Raspberry Pi Image]] | |||
*** Please note, this image may not always contain latest MX release, but once you have installed a release of MX on your Raspberry Pi, [[Updating MX to new version|upgrading]] is done using main software download link, as none of the other components in the image need to be upgraded. | |||
==Upgrading== | |||
We strongly advise updating to the latest version, if only for the fact that later versions offer more functionality, and may fix any bugs in an earlier | We strongly advise updating to the latest version, if only for the fact that later versions offer more functionality, and may fix any bugs in an earlier | ||
release. | release. | ||
You can install a new release of MX directly over your existing installation. | |||
threads) for the builds since the version you are upgrading from. | *Important, please read all of the release notes (in the appropriate forum announcement threads) for the builds since the version you are upgrading from. | ||
*If you are currently running an old release of MX, you might want to check [[Updating MX to new version]] page, as that has some advice about whether it is best to upgrade in multiple steps. | |||
*If you are upgrading from a previous version of the legacy Cumulus 1, then you might want to read [[Migrating from Cumulus 1 to MX]] page; and if you need more justification read [[Compare_C1_and_MX|Compare legacy Cumulus and MX]] page | |||
Note you may find that anti-virus software flag a new release of Cumulus as a ‘threat’, for a few days or weeks after a new version has been released, | Note by Steve Loft: you may find that anti-virus software flag a new release of Cumulus as a ‘threat’, for a few days or weeks after a new version has been released, even though it does not actually contain a virus of any kind. This is due to a system they call ‘reputation’ where they automatically block any versions of software which have recently been released. You may want to consider complaining to the provider of your anti-virus software about this ridiculous system, or better still, use some better anti-virus software. | ||
even though it does not actually contain a virus of any kind. This is due to a system they call ‘reputation’ where they automatically block any versions | |||
of software which have recently been released. You may want to consider complaining to the provider of your anti-virus software about this | |||
ridiculous system, or better still, use some better anti-virus software. | |||
==Source download== | |||
*[https://github.com/cumulusmx/CumulusMX Cumulus MX Current Source Code] This code base is updated for all releases resulting from development by M Crossley. | |||
== Help with ‘Stable’ MX releases == | |||
Please read the announcement for the latest MX release in [https://cumulus.hosiene.co.uk/viewtopic.php?f=40&t=17887 the forum] before installing it. | |||
If you need any help with Cumulus MX, please first consult, in this Wiki, the [[:Category:Cumulus MX]] page for pointers to articles that may help. If you cannot answer your questions from those links, then use the [https://cumulus.hosiene.co.uk/viewforum.php?f=40 correct MX support forum] to see if others have answers. | If you need any help with Cumulus MX, please first consult, in this Wiki, the [[:Category:Cumulus MX]] page for pointers to articles that may help. If you cannot answer your questions from those links, then use the [https://cumulus.hosiene.co.uk/viewforum.php?f=40 correct MX support forum] to see if others have answers. | ||
== Current Release == | == Current Release == | ||
===Latest build distribution download=== | |||
: Download [https://github.com/cumulusmx/CumulusMX/releases/download/b3133/CumulusMXDist3133.zip Cumulus MX v3.11.4 build 3133, 25-May-2021] | |||
===Raspberry Pi Image=== | |||
: Download [//{{SERVERNAME}}/Downloads/rpi-CMX-3.11.3.zip Raspberry Pi Image for Cumulus MX 3.11.3] | |||
==Older releases== | |||
It is always possible that a new release introduces a bug, and you decide to regress to an earlier release. | |||
Find link to earlier MX release distributions on [[Main Page]]. | |||
For earlier Raspberry Pi images, simply change the file name above, to represent earlier release (an image has not been created for every release, but past contents of this page can be found by searching on the history tab): | |||
* e.g. [https://cumuluswiki.org/Downloads/rpi-CMX-3.10.4.zip rpi-CMX-3.10.4.zip] | |||
* or [https://cumuluswiki.org/Downloads/rpi-CMX-3.10.2.zip rpi-CMX-3.10.2.zip] | |||
= Other utilities = | = Other utilities = | ||
Line 52: | Line 70: | ||
== Utility for Fine Offset Stations == | == Utility for Fine Offset Stations == | ||
*[//{{SERVERNAME}}/Downloads/SetLogger.zip Set Logger Interval] A utility to | *[//{{SERVERNAME}}/Downloads/SetLogger.zip Set Logger Interval] A utility by Steve Loft to adjust the internal logging interval on Fine Offset stations | ||
== Weather Display Converter == | == Weather Display Converter == | ||
This utility was provided by Steve to convert Weather Display log files to Cumulus format. | This utility was provided by Steve to convert Weather Display log files to Cumulus format. | ||
At time of writing this here, the functionality in MX was limited. You may need to manually recreate records, etc. using Cumulus 1. | |||
Please read the readme file in the zip. | |||
There is a [https://cumulus.hosiene.co.uk/viewtopic.php?f=4&t=10118 forum thread about this converter here]. | There is a [https://cumulus.hosiene.co.uk/viewtopic.php?f=4&t=10118 forum thread about this converter here]. | ||
Line 63: | Line 85: | ||
[https://cumuluswiki.org/a/File:WDconverter.zip WDConverter.zip] | [https://cumuluswiki.org/a/File:WDconverter.zip WDConverter.zip] | ||
== WeatherLink Converter == | |||
This utility was provided by Steve to convert WeatherLink log files to Cumulus format. | |||
Please read the readme file in the zip. | |||
There is a [https://cumulus.hosiene.co.uk/viewtopic.php?t=11349 forum thread about this converter here]. | There is a [https://cumulus.hosiene.co.uk/viewtopic.php?t=11349 forum thread about this converter here]. | ||
Line 72: | Line 95: | ||
[https://cumuluswiki.org/a/File:WLconverter.zip WLconverter.zip] | [https://cumuluswiki.org/a/File:WLconverter.zip WLconverter.zip] | ||
== Create Missing == | |||
The v1.0.2 download (dated 11 Mar 2021) [https://github.com/cumulusmx/CreateMissing/releases/download/v1.0.2/CreateMissing-v1.0.2.zip is here]. | |||
This is a MX utility, by Mark Crossley, to populate any missing [[Calculate_Missing_Values#Derived_value|derived fields]] from the [[Calculate_Missing_Values#Source_value|source values]] in your [[Standard log files]], and to insert missing lines in [[dayfile.txt]]. | |||
*Learn when this utility might be useful, and when not, by reading the [[Calculate Missing Values]] page. | |||
*For full information about solving problems with your '''dayfile.txt''' file read the [[Amending dayfile|amending daily summary file]] page. | |||
More information can be [https://github.com/cumulusmx/CreateMissing/blob/master/README.md found here.] | More information can be [https://github.com/cumulusmx/CreateMissing/blob/master/README.md found here.] | ||
== ExportToMySQL == | == ExportToMySQL == | ||
A utility to export Cumulus MX monthly and dayfile logs to a MySQL database. | A utility, by Mark Crossley, to export Cumulus MX monthly and dayfile logs to a MySQL database. | ||
The v1. | The v1.3.0 download dated 27 Apr 2021 (for 7 May release of MX 3.11.0) [https://github.com/cumulusmx/ExportToMySQL/releases/download/v1.3.0/ExportToMySQL-v1.3.0.zip is here.] | ||
More information can be [https://github.com/cumulusmx/ExportToMySQL/blob/main/README.md found here.] | More information can be [https://github.com/cumulusmx/ExportToMySQL/blob/main/README.md found here.] | ||
''This replaces the "ExportMySQL.exe" utility included by Steve Loft in his MX beta distributions.'' | |||
== Third Party Contributions by Cumulus Users == | |||
For files, and add-on's, contributed by Cumulus users, see these Categories: | |||
# [[:Category:3rd Party Apps]] - contributions for various devices, | |||
# [[:Category:AddOns]] - adding extra functionality, | |||
# [[:Category:WebTools]] - for your web server, and | |||
# [[:Category:User_Contributions]] - key contributions from the user community | |||
=Current MX Developed from = | |||
* | Cumulus 3 (MX) software was developed as a beta with limited functionality by Steve Loft. | ||
*Steve Loft previously developed Cumulus 2 (where he tested using the C# language, now used for MX) | |||
* Steve Loft created the original Cumulus software (now known as legacy cumulus 1) just for his use, before making it generally available, he then developed it over the next decade to include requirements suggested by thousands of users. | |||
*Steve Loft, the author of Cumulus/Cumulus MX has since fully retired, and stopped providing support, or updates, to Cumulus 1 or Cumulus MX software. | |||
==Steve's final beta MX== | |||
== Special Variants == | You can download below the final beta release as made available by Steve Loft, and also his subsequent final source code. | ||
If you are able to understand his source code (linked below), and compare it to the latest source code (linked above), you can appreciate the transformation that has taken place in recent years. | |||
*[//{{SERVERNAME}}/Downloads/CumulusMXDist3043.zip Cumulus MX v3.0.0 beta build 3043, 20-Jan-2017] Cumulus MX, a cross platform version of Cumulus which runs on Windows, Linux (including the Raspberry Pi) and Mac OS X (Steve Loft - final release). | |||
*[//{{SERVERNAME}}/Downloads/CumulusMXSource.zip subsequent updated Cumulus MX Source Code] from Steve Loft. He made the following comments, as he handed the project over to "the community": | |||
**This version of the code is post b3043 as it includes some changes that Steve had made, but not yet released. | |||
**Offered completely '''without support''' in the hope that it might be useful. | |||
**The code is very badly structured due to the 'Frankenstein' way it was cobbled together from various places. Some of it is a machine translation of parts of Cumulus 1. | |||
== Legacy releases == | |||
See [[Downloads| downloads page]] for full details. | |||
=== Cumulus 1 === | |||
The installer for Cumulus 1 is available here: | |||
*[//{{SERVERNAME}}/Downloads/CumulusSetup.exe Cumulus 1099 installer]. | |||
*[//{{SERVERNAME}}/Downloads/cumulus.1099.2.zip Cumulus 1.9.4 build 1099.2 patch] Patched version of one file (Cumulus.exe), | |||
**modifies the drop-down year selectors, (on "this period" screens, for NOAA reports, and for Snow Index). | |||
*The new year drop-down selectors will make it easier to choose date entries up to the year 2030 (updated 28 Jan 2020). | |||
*Note this is not the full installation package, just one file to replace the suite of files created by the installer, a patched .exe. | |||
**Without the patch, you can still enter any year,but you have to over-type with the full year yourself. | |||
==== Special Variants ==== | |||
*[//{{SERVERNAME}}/Downloads/CumulusSetup1100.zip Cumulus 1.9.4 build 1100 setup] '''Use ONLY if you are an Instromet user''', and your logger operates at 115200 baud, you should use build 1100 | *[//{{SERVERNAME}}/Downloads/CumulusSetup1100.zip Cumulus 1.9.4 build 1100 setup] '''Use ONLY if you are an Instromet user''', and your logger operates at 115200 baud, you should use build 1100 | ||
*[//{{SERVERNAME}}/Downloads/CumulusSetup1101.zip Cumulus 1.9.4 build 1101 setup] '''Use ONLY if you are an Instromet user''', and your logger operates at 19200 baud, you should use build 1101 | *[//{{SERVERNAME}}/Downloads/CumulusSetup1101.zip Cumulus 1.9.4 build 1101 setup] '''Use ONLY if you are an Instromet user''', and your logger operates at 19200 baud, you should use build 1101 | ||
*'''NOTE:''' '''These Cumulus 1.9.4 variants will not have any updates in the future.''' In 2020, some of the menu items with year | *'''NOTE:''' '''These Cumulus 1.9.4 variants will not have any updates in the future.''' | ||
*In 2020, some of the menu items with year drop-down selectors will not display years beyond 2020. | |||
**You can manually over-type any selection boxes with any year you like,you are not limited to those in drop-down | |||
**For example, this will happen on manual generation of NOAA-style reports. | |||
**This does not affect any automatic generation of NOAA reports. | |||
It is '''STRONGLY RECOMMENDED''' that users of Cumulus '''1.9.4 variants''' migrate to Cumulus MX, which has ongoing support by mcrossley. The baud rate can be selected within MX as a configuration setting. | |||
=== Legacy Resources === | |||
*[//{{SERVERNAME}}/Downloads/Cumulus%20basic%20installation%20guide.pdf Cumulus installation guide] Instructions for installing Cumulus 1 | *[//{{SERVERNAME}}/Downloads/Cumulus%20basic%20installation%20guide.pdf Cumulus installation guide] Instructions for installing Cumulus 1 | ||
*[//{{SERVERNAME}}/Downloads/readme.txt Cumulus readme.txt] Please read this before installing or updating Cumulus | *[//{{SERVERNAME}}/Downloads/readme.txt Cumulus readme.txt] Please read this before installing or updating Cumulus | ||
*[//{{SERVERNAME}}/Downloads/Cumulus.chm Cumulus help file] The Cumulus 1 help file (this also gets installed when Cumulus is installed) | *[//{{SERVERNAME}}/Downloads/Cumulus.chm Cumulus help file] The Cumulus 1 help file (this also gets installed when Cumulus is installed) | ||
*[//{{SERVERNAME}}/Downloads/CumulusRealtime.zip Cumulus Realtime] An obsolete Silverlight application for displaying real time | *[//{{SERVERNAME}}/Downloads/CumulusRealtime.zip Cumulus Realtime] An obsolete Silverlight application for displaying 2 extra dials showing real time wind data on the standard Cumulus (with temperature and rainfall in histogram style) gauges page for a web site (no longer developed or supported) | ||
*[//{{SERVERNAME}}/Downloads/CumulusFR.chm Cumulus help file in French] The Cumulus 1 help file translated into French | *[//{{SERVERNAME}}/Downloads/CumulusFR.chm Cumulus help file in French] The Cumulus 1 help file translated into French | ||
== Cumulus 2 == | == Cumulus 2 == | ||
The software for Cumulus 2 is no longer available. | The software for Cumulus 2 is no longer available. | ||
edits