FAQ: Difference between revisions

= Installing and Running Cumulus  =

Cumulus 2 explored an improved data approach using UTC and having better handling of rainfall. Although it was hoped it would make enhancement easier, and allow use of alternative languages possible, it proved too complicated. and has been abandoned and is no longer available, so if you don't already have it hard luck.  Subsequently, some of the developments in Cumulus 2 were ported into new version 1.9.0, and remain in final Cumulus 1.9.4 from where they were in turn ported to Cumulus MX. So whichever of the two versions still available you choose, you are benefiting from work done for Cumulus 2.

== I use Cumulus 1 and want to move to Cumulus MX ==

* While Cumulus 1 has a tool to generate graphs itself and then uploads them to your website, the graphs used in Cumulus MX are drawn when the end-user loads the web page, they use Highcharts routines that are free for non-commercial use only, i.e. you may not use MX with these graphs on a company web site.

* While Cumulus 1 runs as an application that includes a main screen, and other screens, that appear when you start it, Cumulus MX is two separate applications, there is the "engine" that connects to your weather station and processes that data, but there is also a separate user interface that can be viewed on a browser on any device connected to the same local network as the device that runs the engine (for key security reasons this user interface should not be exposed over the wider internet).

* The '.txt' files in the data folder will work with both Cumulus 1 and MX - assuming you are using the same decimal and list separators in MX as you used in Cumulus 1 (i.e. the same locale).

* Your "Cumulus.ini" file must start with a capital letter for MX, and all the characters used within the configuration file must be within ASCII range, Cumulus 1 on Windows is not fussy about case in the file name. Cumulus MX adds further items to this file, but you do not need to change the contents of it for moving in either direction except in regards to the NOAA reports. Those from Cumulus 1 and MX are set up differently because of different codes to output a month format parameter as the change to date/time formats in webtags also applies to NOAA report file format lines in Cumulus.ini.  Also the [FTP site] section in Cumulus.ini will only work in MX with 'site' entirely in lower case, so if it is different in your copy, edit that.

*(Other file names within MX will be as supplied in the file that you download, or as Cumulus MX decides when it creates the file).  

Finally if you are moving from Windows to Linux, remember you need to learn a host of new commands!

== What weather stations does Cumulus work with?  ==

*Davis Vantage Pro (VP), Vantage Pro2 (VP2), and Vue (the Envoy8X is '''not''' supported).  

*Oregon Scientific WM918, WMR918, WMR928, WMR968, WMR88 (see [[FAQ#How do I set up recording wind speeds in Cumulus, with Oregon Scientific and La Crosse stations | this FAQ]]), WMR100, WMR180, WMR200.  

== How do I upgrade to a new release?  ==

You can install the new version where you like, but the Cumulus 1 installer will offer the same place as the previous version as the default.

''Occasionally, there may be actions you need to perform before or after the upgrade.''  Required actions usually appear in the announcement of the build you are installing, and for Cumulus 1 may be documented in the readme.txt file that will appear as you run the installer. Read such announcements for every release since your existing build in case any of the in-between changes affect you.

# "cumulus.exe"; - the latest build

# "unins000.exe";

*So tick this option, if you have a standard Cumulus implementation and then you can be sure to upgrade the standard templates.

*Untick this option if you have  [[Customised_templates#Creating_Your_Own_Templates|customised the existing pages]],  so that if your customised versions  are in "web\*.*" they don't get overwritten. It is recommended that you store any customised pages in a directory outside the Cumulus folder, as you can specify up to 10 such files on the local side of the files tab in the Configuration menu Internet settings screen and (if you are not using standard files) untick ''Include Standard Files'' on the same screen. (100 such files can be specified in [[Cumulus.ini]]).

== Changing to different weather station ==

== Moving Cumulus software to a new PC (or updating Windows Operating System) ==

Cumulus will continue to work with your existing weather station and existing log files, providing

#Your Windows regional settings are the same (i.e. date format unchanged, same time zone, decimal point symbol unchanged, list separator character unchanged) - if there is a difference, the new installation cannot understand the old lines in the log files and will give an error when Cumulus is restarted.

== Moving Cumulus software to a different location on your PC? ==

== What are the formats of the Cumulus data files?  ==

== I was away on the last day of last month/year - How do I see the final lowest and highest figures for last month/year? ==

'''View''' menu, ''This month'' or ''This year'' screens show some figures for any month or year selected by you, but do not show all the figures shown on a standard web page or as shown on the ''Highs and Lows'' screen for the current month/year.

== Why does Cumulus do some things the way it does, when there are better ways? ==

The fact that it works with several different types of weather station means that much of it is a compromise; it doesn't use certain features of the weather station which it could use if it were dedicated to that type of weather station. For example, it typically does not use any high/low data that the station might store internally. Instead, it maintains its own high/low data from individual readings. There are a number of reasons for this; the fact that Cumulus supports an 0900-0900 day, and the weather station does not, and the fact that typically Cumulus maintains far more high/low values than the station does, and these need to be self-consistent.  

= Troubleshooting  =

== My 'Error' light is flashing  ==

== My ‘new record’ light has stopped flashing  ==

== I installed a new version and my web page templates got over-written  ==

== I can’t find my data files!  ==

== I can't save my NOAA reports! ==

== I get an error when I close Cumulus  ==

Cumulus does sometimes report an error when you close it. This does not appear to cause any problems, you can just close the error message. I don't seem to be able to do anything about this, as the 'crash' is not in code that I have control over. You may be able to avoid this error by avoiding closing Cumulus while it is uploading to the internet. Please don't bother sending me a bug report about this.  

== My computer hibernated/suspended, and I lost data/my graphs 'flat-lined'  ==

Cumulus can't cope with being suspended, it just carries on as normal after being woken. There is an option in the station settings to 'close on suspend', so Cumulus will close itself as a safety measure, if you forget to do it manually. Don't use the 'close on suspend' option and the 'confirm shutdown' option at the same time; this will cause problems.  

== When I start Cumulus, the graphs restart again each time and don't show the earlier data  ==

This problem can also occur if you change your system format settings (date format, decimal and list separators etc). Again, check the diags file for a message about a number not being a valid floating point value.

== The peak values on my graphs are not the same as my extreme values  ==

This is most noticeable with wind gusts, the value of which can change rapidly, even over a period of a minute. The 'Plot latest gust' setting causes the 'Latest' figure (as shown on the main screen) to be plotted. What this figure represents exactly depends on your weather station type. This figure may vary rapidly, e.g. on Davis stations, it changes every 3 seconds or so. The graphs are plotted once a minute, and hence, with Davis stations, for example, there is approximately a one in 20 chance of any given 'latest' figure actually being plotted.

Cumulus will always show zero average bearing when the average wind speed is zero (it can't be otherwise because it's calculated using the wind speed). In addition, it will show zero current bearing when the current wind speed is zero if you have ''use bearing zero when calm'' selected in the [[Cumulus_Screenshots#Station|station]] settings (accessible from '''Configuration''' menu).

== My graphs appear to be plotted less frequently just after Cumulus starts up  ==

== My temperature Min/Max/Avg graph is empty ==

The most likely explanation is that you have only recently started running Cumulus (in the last day or two). It adds new values to this graph at the end of each day; it wouldn't make sense to add a value part of the way through the day, and you need a few points to be plotted before the graph starts to take shape. You need to wait until you have been running Cumulus for a few days.

== I've changed my Twitter password, and now Cumulus won't update Twitter ==

You need to force Cumulus to re-authenticate with Twitter. Stop Cumulus and edit cumulus.ini. Find the [Twitter] section, and '''delete''' the lines which start

== Cumulus stops at the "Downloading data" screen ==

If you have a Fine Offset station, this is probably caused by the station's USB interface locking up - a known problem with some Fine Offset stations. You should be able to get it going again by doing a reset - remove batteries and the USB cable. Recent Fine Offset models have a problem where they can lock up frequently, requiring a reset. From version 1.9.3 of Cumulus onwards, there is an option to synchronise the reading of data with the console writing the data, to avoid doing both at the same time, and this seems to avoid most lockups. The setting is "Synchronise Fine Offset reads" on the station settings screen.

== Cumulus locks up when it starts and I have to use the task manager to kill it ==

If you have a ''Fine Offset station'', this is most likely caused by the station's interface locking up, i.e the station has stopped communicating with the PC.

== Cumulus gives an error and won't run on my HP computer ==

It's a known problem with HP computers; they have missing fonts. One solution is to install [http://www.microsoft.com/en-us/download/details.aspx?DisplayLang=en&id=16083 this font update] from Microsoft. It appears that computers other than HP can have the same font issue, so it is worth installing the font update anyway, if you get a problem where Cumulus won't start.

== I have problems after upgrading to Windows 10 ==

= Website =

== My web pages are empty ==

One common cause of web pages appearing to be of size zero, or not uploading with new contents when Cumulus attempts to use FTP, is that your firewall (or your FTP server) has limited the allowed operations (e.g. can't delete, can't insert, can't rename ...). Try changing from passive mode to active mode transfers (or vice versa). Try using a manual FTP operation (with your own FTP client) and see if that works.

If empty web pages are being successfully uploaded to your web site (i.e. they report size of 0 kB, but do not produce 'error 404 - page not found' message), and your browser shows that their modification date is recent (see next FAQ), then another likely cause is that the [[Customised_templates#What_is_meant_by_.27Cumulus_processes_templates.27| Cumulus processing]] of templates is failing:

*Either (since build 1093, as made clear in the release notes)[[File:Web settings.JPG]] the character encoding (for standard named templates that are [[Customised_templates#What_is_meant_by_.27Cumulus_processes_templates.27| processed by Cumulus]]) is specified incorrectly on the '''Configuration'''  menu, ''Internet'' dialog, '''Sites/Options''' tab, ''Web Settings'' frame as shown about half way down on this screen extract: