1,154
edits
m (→Running manually: typo!) |
(Added information about Cumulus 'Daily' external program option.) |
||
Cumulus has the ability to upload files to your webserver at regular intervals, however this is an 'all or nothing' feature -- If Cumulus is set to upload to your website every 10 minutes then every file will be uploaded every 10 minutes.
As your website becomes more advanced you may wish additional data available on the site, and the most common need is the [[
The dayfile.txt file only changes once per day therefore it is extremely inefficient to upload this every 10 minutes, far better to do a once per day upload.
Starting with version 1.9.2, Cumulus now has the ability to invoke a command or external program once a day. This is configured via the ''Configuration | Internet Options | External Programs ''dialog box. Whatever is entered in the "Daily" section will be invoked once a day, just after the daily rollover processing is completed.
This option in Cumulus can be used instead of the Windows Task Scheduler (which is detailed below) to invoke a script or program, and may be perferable in many circumstances.
Below are details on how to automate the upload of the dayfile.txt once per day, just after midnight. If your roll over is set to 9/10am you would adjust this to upload just after the roll over. Leave a few minutes at roll over time for Cumulus to complete its work before you upload.▼
<br>
= Automation =▼
▲Below are details on how to automate the upload of the dayfile.txt once per day, just after midnight.
In order to achieve this, we rely on a few components:▼
▲= Automation =
* A script for uploading (ftp'ing) the file▼
* A batch file to run the command to upload▼
* The Windows Scheduler (AT)▼
▲In order to achieve this, we rely on a few components:
== The script ==▼
Using a good text editor, such as [http://notepad-plus-plus.org/ Notepad++] or Notepad (if you must!), copy and paste the following into a blank file:▼
▲== The script ==
<pre><user>▼
<password>▼
▲Using a good text editor, such as [http://notepad-plus-plus.org/ Notepad++] or Notepad (if you must!), copy and paste the following into a blank file:
cd <folder>▼
put c:\cumulus\data\dayfile.txt
quit
</pre>
Replace: ▼
*<user> with your ftp login username. This will be the same as the one in Internet Settings in Cumulus Configuration
▲Replace:
*
*<folder>
The 'put' entry should be followed by the full path to dayfile.txt on your Cumulus PC
Save this file as <tt>dayfile.ftp</tt> in the Cumulus folder of your PC (example, in c:\Cumulus)
== The Batch file ==
Now create a batch file to use this script.
Replace ▼
▲<pre>ftp -s:c:\cumulus\dayfile.ftp <hostname></pre>
*
Save this file as <tt>upload-dayfile.bat</tt> in c:\cumulus (or your Cumulus folder if different) ▼
▲Replace
▲* <hostname> with the same setting in your Cumulus Internet Settings
▲* <tt>c:\cumulus\dayfile.ftp</tt> with the full path and filename used when saving the Script file above
<br>
▲Save this file as <tt>upload-dayfile.bat</tt> in c:\cumulus (or your Cumulus folder if different)
== The Windows Task Scheduler ==
*Click Start, Run and type <tt>cmd</tt> press Return
:If you are using Windows 7 you need Admin privileges to set the scheduler. Click Start, All Programs, Accessories. Right Click on 'Command Prompt' and select 'Run as Administrator' You may be asked to confirm this elevation of security privileges (temporarily) ▼
*A black box (command console) will appear▼
*Type, or copy:▼
<pre>at 00:10 /every:M,T,W,Th,F,S,Su "c:\cumulus\upload-dayfile.bat"</pre>▼
: Change the end of the command to the location of the Batch file you created above▼
: If your roll-over is 9/10am change 00:10 to 10:10 to run the script every dat at 10:10am rather than 10 minutes pas midnight▼
*Press return▼
*Type AT and return and you should now see your job listed in the scheduler. Your Job will run every day at the specified time.▼
*Close the command window by typing <tt>exit</tt> or closing the window▼
▲:If you are using Windows 7 you need Admin privileges to set the scheduler.
▲*A black box (command console) will appear
There is no notification if the task runs or fails. You need to check the System Event Viewer in the Admin section of the Control Panel for errors.▼
▲*Type, or copy:
▲<pre>at 00:10 /every:M,T,W,Th,F,S,Su "c:\cumulus\upload-dayfile.bat"</pre>
▲:
▲*Press return
▲*Type AT and return and you should now see your job listed in the scheduler. Your Job will run every day at the specified time.
▲*Close the command window by typing <tt>exit</tt> or closing the window
▲<br> There is no notification if the task runs or fails.
<br>
== Running manually ==▼
▲== Running manually ==
If you wish to run a manual upload, perhaps to test the command is successful, simply run the batch file:▼
▲If you wish to run a manual upload, perhaps to test the command is successful, simply run the batch file:
and type <tt>c:\cumulus\upload-dayfile.bat</tt>▼
▲Start, Run, cmd and type <tt>c:\cumulus\upload-dayfile.bat</tt>
Check your webserver for dayfile.txt using your normal ftp tool▼
▲Check your webserver for dayfile.txt using your normal ftp tool
== Advanced ==▼
▲== Advanced ==
For more advanced control over the your uploads consider using the features in Cumulus [[Toolbox]]▼
▲For more advanced control over the your uploads consider using the features in Cumulus [[Toolbox]]
<br>
== Possible Issues ==▼
▲== Possible Issues ==
The FTP tool being used here is the one which ships with Windows; it is a relatively simply implementation and may not support the requirements of your webserver. There is some useful reading in [http://sandaysoft.com/forum/viewtopic.php?f=18&t=4821 this] forum topic which may help if you have issues.▼
▲The FTP tool being used here is the one which ships with Windows; it is a relatively simply implementation and may not support the requirements of your webserver.
[[Category:WebTools]]
|