5,838
edits
m (→Possible problems: Updated grammer and style) |
mNo edit summary |
||
(51 intermediate revisions by 2 users not shown) | |||
The 'Simple Website' setup is by far the easiest and quickest way to get your Cumulus 1.9.4 data online. It uses the standard Cumulus 1.9.4 web templates and the process is well documented in the Help files for Cumulus 1 under 'Setting Up your Website'.
However this article (which is {{Version badge 1}} only for the legacy software) may help further.
{{TOCright}}
=If you run your own web server=
The assumption in this article is that FTP is used to get files onto your web server.
<big>At present this article does not cover alternative of running your own web server and using copy to get files onto that web server.</big>
=Checklist if you are using FTP=
Below is your check list before you start:
#You have File Transfer Process (FTP) webspace (i.e. your provider allows you to use FTP to place files in your webspace)
#and an [[FTP tools|FTP tool]] (use this cross-reference to get more information)
From your webspace provider you will be given:
*FTP server '''Host name''' (this is the name that is equivalent to the w.x.y.z format Internet Protocol version 4 (=IP) address in the screen-shot below - see the notes below it) (N.B. Some servers might have several names at a single IP location). In establishing a connection to a host name, Cumulus will contact the domain name server (=DNS) your system uses to convert the name you specify to the IPv4 address that enables the connection to be made; that step not needed if IPv4 used directly.
*'''FTP Port''' (in most cases port 21 is reserved for file transfer clients)
*'''username''' (controls access to the directories you can update)
Do check with any provider that they let you FTP files with at least all the following extensions:
* .txt (critical for real time processing, steel series guages and similar) and .css (defines look for web pages)
* .htm and .html (
* optionally .php if you might use that
* .json (essential for Cumulus MX)
* .js (script files)
* .bmp, .png, .gif, .jpg (and any other graphic formats you might use)
* audio and video mime types (
= Folders and Files to Transfer just Once =
==
Firstly, we need to get several files and folders onto your web space. The files and folders vary depending on flavour of Cumulus, and will be described in next 2 sections, but this section gives a steer on how you might get the folders and files onto the web server.
#This is a one time only exercise but is essential to the operation of your Cumulus website.
#Configure your [[FTP tools|FTP tool]] to connect to your web server.
#Once done, make your connection and change to the correct directory/folder on your site, as advised by your provider.
#You may wish to create a sub-folder to store your weather site, but for this purpose we will assume not.
The first task is to copy everything (see next section for details of exactly what) in the ''cumulus\webfiles'' folder into where you want to store your web site pages, preserving the sub-folder structure.
The folders to be uploaded are:
The (obsolete) Microsoft Silverlight software is used for the full standard gauges.htm page (runs the real time graphics).
===
If you're using a graphical ftp client like Filezilla (recommended), in the left hand pane just navigate to the ''webfiles'' folder in Cumulus, open it, and you should see the five (Cumulus 1) items listed in previous section.
[[File:SiteBefore.png | Left]][[File:SiteAfter.png | Right]]
Select them all as in left image, and drag them to your web site in the right hand pane. That's the setup done as in right image.
= Settings required for automatic regular uploads to web server by Cumulus =
== Internet Settings ==
===Configuration menu; Internet Settings screen; for Cumulus 1===
[[File:SimpleInternet-options.png | Left]]
#Within the '''Sites/Options''' tab you should see (Picture is Cumulus 1.x.y interface) a frame called 'web site' in the top left corner.
#The actual settings will not be as illustrated, but should be as described in section after next.
# Click "OK" when you have entered all the values.
=== Information requested on Internet Settings ===
#''Host name''
#*Here enter your FTP server name.
#*An example could be ''myserver.org''. Just enter a HOST NAME or IP ADDRESS.
#*Do not enter a URL - do not include "ftp://" or "http://" or anything similar.
#*If you have managed to transfer files using a FTP tool, its log should show the host name or the (numbers separated by dots) Internet Protocol address. The illustration shows an IP (version 4) address typical of a local server. (Note that with a new web site, or following a change of host, it might take a couple of days for the numerical IP address to be associated with the host name on all Domain Name Servers. If that makes no sense to you, basically it means be patient if you don't get access on first day!)
#''FTP port''
#*This is normally ''21'' unless your provider has told you otherwise
#For Cumulus MX only, ''Select the FTP protocol to use''. Hopefully, you know which to choose, or can ask your web space provider.
#''Directory'' on Cumulus 1, ''Remote FTP directory'' for Cumulus MX
#*It may be blank, or may be a folder structure.
#*Generally your provider will have given you instructions what to enter here if you need to specify a FTP root relative to some overall root, obviously you might then want to make a sub-folder for the weather pages uploaded by Cumulus and if so then follow the blank or whatever for root with '/' and then your sub-folder name.
#*It is almost always case sensitive so type it exactly as advised. There will be NO spaces at the start, end, or anywhere within, the name. It is a '''relative''' path from the overall '''root'''. If you have successfully used a FTP tool to transfer files, then (as in ''before image'' above) there should be a reference to the directory in the log dialogue of establishing connection to your website.
#''Username'' and ''Password''
#*In all cases your provider will tell you these two values.(If you set up your own web-server, then you determine these two values in the set up).
#*It maybe, or may not be, the same username and password used for your email,
#*Cumulus sends these (using standard commands) to the server to initiate a session of contact, and waits for the server to confirm the session has started.
#''Forum URL''
#*This can be left blank, if so then the standard web pages will not include a navigation link with the label '''Forum'''. However, if you type ''
#''Webcam URL''
#*This is discussed in the Cumulus 1 help,
#*It can safely be left blank if you are only going to use the standard web pages.
#*Other people use it as an easy way for every standard web page to include a link to somewhere else on their web server, a home page, a information about locality page, or a [[:Category:User Contributions|third party]] web page they have added to their web site.
== Selecting what Cumulus is to upload ==
=== Cumulus 1 FTP settings ===
Now we need to select the FTP settings which are still on the Internet Settings screen in the Configuration menu:
#In this 'frame' first click on ''Auto Update''; this tells Cumulus you want it to automatically process the web tags in the templates, and generate web pages.
#The illustration (in Cumulus 1 interface on left below) shows ''Use active FTP mode'' un-selected as Cumulus '''Help''' suggests. In active mode, Cumulus is listening for an incoming data connection from the server; in passive mode, Cumulus asks the server if it can establish a connection.
#Now look at ''Interval'', this is how often Cumulus will update your website.
#*It has been set in both illustrated examples below to '''5''' minutes as that is quite good when you first start so you can see all your pages being updated frequently. Typically people set this to 10 or 15 minutes on established sites. It is tempting to change this to 1 minute, but little is gained from this as on most web pages very few figures change that frequently.
[[File:Web_settings.JPG | Left]](Left hand picture is Cumulus 1.x.y interface
The real time settings illustrated here will be explained later, they are optional for now.
=== Cumulus 1 selecting files to include===
{{Version badge 1}}Next, click on the '''Files''' tab if you are using Cumulus 1:
[[File:SimpleInternet-StandardTicks.png]]
Make sure both “Include Standard” Files and “Include Standard Images” are ticked in Cumulus 1.
You have now told Cumulus how to update your web space with the [[Customised_templates#The_Standard_Templates |Standard Cumulus Template]] files and images for the web.
== Optional Pseudo Real-Time Data ==
##*In this example, '''90''' seconds. Consider Real-time carefully -- firstly this impacts on your internet connection as Cumulus will update a very small file on your website every XX seconds. Also, some weather stations only update Cumulus less often (e.g. The Fine OffSet stations are updating every 48 or 60 seconds) so a 15 second real-time update is wasteful and unnecessary.
== Testing ==
# You can force an immediate web update to test your settings by clicking '''FTP now''' in MX found at the bottom of the settings menu,, it simply returns a message there when it has run.
#* The equivalent is in File menu within Cumulus 1, clicking '''Web Update''' there.
#*# In Cumulus 1 this will display a window of progress as it uploads the necessary files to your web space (or show a failure message). (Within the Configuration menu, you can turn on 'FTP logging' for full diagnostics).
#*# Once completed the Cumulus 1 progress display will end with “Logging Out” and you can close the window.
Cumulus 1.x.y while running should create the 9 standard web pages in the local 'web' sub-directory, and upload these to the web space by FTP.
*Cumulus 1.x.y should upload by FTP:
** a moon image (moon.bmp),
**the 3 images wind images (compass.png, windgauge.png, windrose.png) as seen on Cumulus main screen,
**and graphs for 'trends.htm' page (hum.png, humsm.png, intemp.png, intempsm.png, press.png, presssm.png, rain.png, rainsm.png, raind.png, raindsm.png, raint.png, raintsm.png, temp.png tempsm.png, tempm.png, and tempmsm.png;
**optionally depending on settings it also uploads solar.png, solarsm.png, sunshine.png, sunshinesm.png, uv.png, and uvsm.png) from the 'web\images' sub-directory to the 'images' folder on your web space.
All these can be tested in the same way.
* Open a web browser
*# Type in 'your web site' Universal Resource Locator (URL) name, if you were hosting yourself then ''localhost'' is usually recognised. It could be the same as you typed for ''Host Name'', anyway, your provider has probably told you what your web site name is.
|
edits