Software: Difference between revisions
m (→Cumulus 1) |
|||
(41 intermediate revisions by 4 users not shown) | |||
Line 2: | Line 2: | ||
= Cumulus MX = |
= Cumulus MX = |
||
⚫ | |||
⚫ | |||
Note: '''Cumulus MX is strictly for non-commercial, non-government use only.''' |
Note: '''Cumulus MX is strictly for non-commercial, non-government use only.''' |
||
⚫ | |||
⚫ | |||
Latest build is... |
|||
:'''NOTE: On Linux/RPi/macOS, Mono version 5, or 6, is needed for MX Release v3.9.1 or later, (and other packages). |
|||
⚫ | |||
:'''NOTE: On Linux/RPi/macOS, Release v3.9.1 or later requires Mono version 5 or 6. Mono v4 is subject to random crashes.'''<br /><br /> |
|||
: 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 |
*There is also a pre-built disk image file for your first installation onto a Raspberry Pi. |
||
**This contains the lite version of the Raspberry |
**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]] |
***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. |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
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 |
You can install a new release of MX directly over your existing installation. |
||
*Important, please read all of the release notes (in the appropriate forum announcement 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 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. |
||
Line 36: | Line 29: | ||
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. |
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. |
||
==Source download== |
|||
⚫ | |||
⚫ | |||
⚫ | |||
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. |
||
⚫ | |||
===Latest build distribution download=== |
|||
: Download [https://github.com/cumulusmx/CumulusMX/releases/download/b3149/CumulusMXDist3149.zip Cumulus MX v3.13.4 build 3149, 03-October-2021] |
|||
⚫ | |||
⚫ | |||
==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 71: | Line 94: | ||
== Create Missing == |
== Create Missing == |
||
⚫ | |||
A utility, by Mark Crossley, to create missing entries in your '''dayfile.txt'''. |
|||
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]]. |
|||
You may use this: |
|||
# to add additional new fields for derivatives that are missing from existing extreme records (in [[:Category:Log Files|'''.ini''']] files) created with old versions of Cumulus, |
|||
#or to create a whole new [[dayfile.txt| daily summary file]] if you are starting afresh with monthly based data imported into [[Standard log files]] from another program. |
|||
*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.] |
||
Line 85: | Line 107: | ||
A utility, by Mark Crossley, 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.1 download dated 20 October 2021 (for 7 May release of MX 3.11.0 onwards) [https://github.com/cumulusmx/ExportToMySQL/releases/download/v1.3.1/ExportToMySQL-v1.3.1.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 == |
== Third Party Contributions by Cumulus Users == |
||
Line 119: | Line 141: | ||
= Legacy releases = |
== Legacy releases == |
||
See [[Downloads| downloads page]] for full details. |
See [[Downloads| downloads page]] for full details. |
||
== Cumulus 1 == |
=== Cumulus 1 === |
||
⚫ | |||
The installer for Cumulus 1 is available here: |
|||
⚫ | |||
*[//{{SERVERNAME}}/Downloads/cumulus.1099.2.zip Cumulus 1.9.4 build 1099.2 patch] Patched version of one file (Cumulus.exe), |
*[//{{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). |
**modifies the drop-down year selectors, (on "this period" screens, for NOAA reports, and for Snow Index). |
||
Line 133: | Line 155: | ||
**Without the patch, you can still enter any year,but you have to over-type with the full year yourself. |
**Without the patch, you can still enter any year,but you have to over-type with the full year yourself. |
||
== Special Variants == |
==== 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.''' |
|||
*'''NOTE:''' '''These Cumulus 1.9.4 variants will not have any updates in the future.''' In 2020, some of the menu items with year choices will not display years beyond 2020. This will happen on manual generation of NOAA-style reports. The NOAA reports should continue to be automatically generated, but the capability to create them on-demand will only work through 2020. It is '''STRONGLY RECOMMENDED''' that users of Cumulus 1.9.4 and 1.9.4 variants migrate to Cumulus MX, which has ongoing support by mcrossley. |
|||
*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. |
|||
⚫ | |||
⚫ | |||
*[//{{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 == |
Revision as of 12:42, 20 October 2021
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 Admin Interface, and the optional default web site, contains products produced by 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.
- 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
- Please note, this image may not always contain latest MX release, but once you have installed a release of MX on your Raspberry Pi, upgrading is done using main software download link, as none of the other components in the image need to be upgraded.
- 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).
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 release.
You can install a new release of MX directly over your existing installation.
- 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 legacy Cumulus and MX page
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.
Source download
- 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 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 correct MX support forum to see if others have answers.
Current Release
Latest build distribution download
Raspberry Pi Image
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. rpi-CMX-3.10.4.zip
- or rpi-CMX-3.10.2.zip
Other utilities
Utility for Fine Offset Stations
- Set Logger Interval A utility by Steve Loft to adjust the internal logging interval on Fine Offset stations
Weather Display Converter
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 forum thread about this converter here.
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 forum thread about this converter here.
Create Missing
The v1.1.0 download (dated 29 July 2021) is here.
This is a MX utility, by Mark Crossley, to populate any missing derived fields from the 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 daily summary file page.
More information can be found here.
ExportToMySQL
A utility, by Mark Crossley, to export Cumulus MX monthly and dayfile logs to a MySQL database.
The v1.3.1 download dated 20 October 2021 (for 7 May release of MX 3.11.0 onwards) is here.
More information can be 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
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.
- 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).
- 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 page for full details.
Cumulus 1
The installer for Cumulus 1 is available here:
- Cumulus 1099 installer.
- 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
- 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
- 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 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
- Cumulus installation guide Instructions for installing Cumulus 1
- Cumulus readme.txt Please read this before installing or updating Cumulus
- Cumulus help file The Cumulus 1 help file (this also gets installed when Cumulus is installed)
- 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)
- Cumulus help file in French The Cumulus 1 help file translated into French
Cumulus 2
The software for Cumulus 2 is no longer available.