Wusage 7.0 Manual
Running Wusage Automatically
Updating Statistics Through the Built-In SchedulerMacintosh users and many Windows 95/98/NT users will prefer to use the built-in scheduling facility. This facility provides a simple, user-friendly way to produce updates on a regular basis.
To take advantage of the built-in scheduler, you must leave Wusage running at all times. You should NOT use the -t command line option to set an idle timeout, as this would cause the program to exit. If the program is not running, it can't run scheduled tasks at the appropriate times! For this reason, Unix and some NT customers will probably want to use the standard scheduling facilities of their operating systems instead.
Note to Unix users: you should probably use
cron instead of the built-in scheduling facilities.
However, if you choose to use the built-in scheduler, you will need
to specify the command line option
-t 0 to
prevent Wusage from automatically shutting down if it is
not accessed via a web browser after 20 minutes. You will
probably also want to start the program in the background.
How to Schedule a Configuration FileTo schedule a configuration file for automatic updates, first start the Wusage program if it is not already running. Second, through the web interface, open the configuration file you are interested in. You should now see a web page with the heading "Control Page."
Scroll down until you see a button on the right labeled "Schedule Updates." To the left of this button, you will see a description of the current schedule settings for this configuration file, if any.
Click on the "Schedule Updates" button. The scheduling wizard will then prompt you for the necessary information.
Note: even though you may have set your configuration file for monthly reporting, you can still choose daily updates if you wish.
VERY IMPORTANT: Wusage will automatically analyze your logs at the scheduled time, if you have left the program running. If you have not left the program running, causing Wusage to "miss" a scheduled update, the program will begin analyzing your logs the next time you start the program.
If you attempt to use the program while a scheduled task is in progress, Wusage will tell you so and display the number of log lines analyzed so far. Old log data that has been analyzed before does not count toward the number of log lines analyzed, so do not be alarmed if the count is zero.
Under Unix, this is commonly accomplished
using the standard Unix program
Cron can be used to schedule "jobs" to be run at
particular times without human intervention.
New cron jobs are installed using the
command. To edit your crontab file, enter the
This command typically launches the
You can, alternatively, create a text file using the
editor of your choice and submit it to cron with
the following command:
A typical crontab entry (line of the crontab file) to run wusage resembles the following entry:
0 1 * * 0 /full/path/to/wusage -c /full/path/to/configuration/fileThe five digits (or asterisks) correspond to minutes, hours, days of the month, months, and weekdays, respectively. If a particular digit is not important to schedule the job, an asterisk is given. For instance, we want the job to run every month, not just in specific months, so an asterisk is specified for the fourth digit. Sunday is day zero (or seven). For more information, use the Unix commands
man 5 crontab.
"What about non-Unix platforms?"
Windows NT supports the
AT command, which
can also be used to schedule programs to run at particular
times. Scheduling of this sort is not a standard feature
of older client operating systems such as MSDOS and
Windows 95. However, Windows 98 does
offer a simple scheduler as a standard feature; an icon
for that scheduler is typically displayed in the
system tray, and it is not difficult to configure it
to run Wusage at the command line. See the
command line options section
of the manual for more information.
Note: Boutell.Com does not provide basic assistance
with your operating system's commands. Please consult
the online help of your operating system if you have questions
about the basic operation of
or the scheduling service of your particular operating system.
This document is intended to provide an overview of the
services that may be available to you as part of your
operating system. If you find your operating system's
scheduling facilities to be too compliated, we recommend
that you use the built-in scheduling capabilities of
Next: Wusage and Local Internets (Intranets)
Table of Contents
Topical Configuration Editor Reference
Alphabetical Configuration Editor Reference
Alphabetical Configuration File Reference
Glossary of Frequently Used Terms
Boutell.Com, Inc - PO Box 63767, Seattle WA, 98102, USA
Phone/Fax +1 206.325.3009