Wusage 7.1 Manual: Command Line Options


You are looking at the manual for Wusage 7.1. This product is three years old! Check out Wusage 8.0 and its remarkable new features.

Wusage 7.1 Manual

Command Line Options

The wusage program supports the following command line options:
-c config_file_name
The -c option should be followed by the name of the configuration file (typically wusage.conf or wusage.con under Windows). If you prefer not to use the user interface, this option is required.
-n
The -n option prevents Wusage 6.0 and later from attempting to resume log file analysis where it "left off" on the previous run. Instead the program assumes it must begin at the beginning of the appropriate day, week, or month. This matches the behavior of Wusage 5.0 and earlier. The use of this feature is not recommended.
-ac
The -ac option is used to specify that wusage should analyze a stand-alone Apache cookie log. These logs are produced by the Apache web server, versions prior to 1.2, if and only if the server was compiled with the "mod_cookies" module. See also the CookieLog directive in the Apache server documentation. This option produces useful reports of user activity as determined by cookies. You should use a SEPARATE report directory to avoid conflict with your regular statistics! For better reports, use Apache 1.2 or better and the Server Configuration Tips section to log cookies as part of the regular access log. This is greatly superior because the users report is generated side by side with the regular reports.
-u (always used with -l)
The -u option is used to specify that Wusage should analyze a stand-alone user agent log. This option is always used in conjunction with the -l filename option, which indicates where the user agent log file is located. This option produces a report in a subdirectory called agents in the report directory. This special filename is used to avoid overwriting the normal output of wusage. It is better to configure your web server to log this information in the regular server log so it can be analyzed as part of your normal reports.
-r (always used with -l)
The -r option is used to specify that wusage should analyze a stand-alone referrer log. This option is always used in conjunction with the -l filename option, which indicates where the referrer log file is located. This option produces a report in a subdirectory called referrers (note the spelling) in the report directory. This special filename is used to avoid overwriting the normal output of wusage. It is better to configure your web server to log this information in the regular server log so it can be analyzed as part of your normal reports. See the Server Configuration Tips section for more information.
-b MM/DD or MM/DD/YY or MM/DD/YYYY
The -b option is used to specify the date from which Wusage should begin producing reports. If the -b option is not specified, Wusage picks up exactly where it left off the last time it was run without -b. If the -b option is specified, wusage will produce reports from that date forward to the present day, or another ending date specified by the -e option. In Wusage 7.0 and above, only those reporting time periods which are completely within the time range specified by -b and -e will be updated. The cumulative summary report cannot be updated in this manner. Three date formats are supported: MM/DD (example: 9/29), MM/DD/YY (example: 9/29/1980), and MM/DD/YYYY (example: 9/29/1980). This option is useful if you have accidentally run wusage on a partial log file and wish to run it again to re-generate the reports for the missing days using data in another log file.
-e MM/DD or MM/DD/YY or MM/DD/YYYY
The -e option is used to specify the date on which wusage should stop producing reports. If the -e option is specified, wusage will produce reports up to and including that date. Otherwise, wusage will produce reports through the most recent complete day or week. In Wusage 7.0 and above, only those reporting time periods which are completely within the time range specified by -b and -e will be updated. The cumulative summary report cannot be updated in this manner. Three date formats are supported: MM/DD (example: 9/29), MM/DD/YY (example: 9/29/1980), and MM/DD/YYYY (example: 9/29/1980). This option is useful if you wish to run wusage on only a certain time period found in a large log file, especially if you are generating a summary report.
-s
The -s option specifies that wusage should only update the cumulative summary report. The use of this option is not recommended in Wusage 7.0. This option overrides the Daily Reports (daily), Weekly Reports (weekly), Monthly Reports (monthly), Quarterly Reports (quarterly), Annual Reports (annual), Summary Reports (summary), and frequency (frequency) options.
-v
The -v option displays the version number of wusage. Please send the output of this option, along with a description of your operating system and web server software, when writing to
-p portnumber
The -p option causes the web interface of Wusage to listen on an alternate port instead of the standard Wusage port number, which is 2396.
-ps proxyserverhost
The -ps option is used to specify a proxy server host name to be used for HTTP and FTP log file fetches. See also -pp.
-pp proxyserverport
The -pp option is used to specify a proxy server port number to be used for HTTP and FTP log file fetches. See also -ps.
-l log_file_or_directory or -
The -l option is used to override the (logfiles) option, specifying a single log file to be analyzed. If the special log file name - (a single dash) is given, Wusage will expect to read its input from standard input. This is particularly useful when working with pipelines of several commands such as the Unix cat and zcat commands. See the Analyzing Many Log Files section for more information.
-t minutes
The -t option is used to specify an idle timeout for the Wusage web-based user interface. Under Unix, Wusage will "time out" and shut down after 20 minutes, if it has not been used during that time. However, the Macintosh and Windows 95/98/NT versions do not time out by default, unless the program is running in a CGI environment. This change was made to accommodate the built-in scheduling feature. See the Running Wusage Automatically section for more information.

-t should be followed by the number of idle minutes after which the web interface should automatically shut down. To shut off the idle timeout under Unix, use the value 0.

-remote
The -remote option is present for backwards compatibility only. Recent releases of Wusage for Windows 95/98/2000/NT provide two binaries: wusageg.exe and wusage.exe. wusageg.exe is the version with a built-in graphical user interface; wusage.exe behaves exactly like the Unix version. In earlier releases the -remote option was used to turn off the graphical interface, as in the Unix version. This is no longer necessary and wusage.exe should be used instead when such behavior is desired.
-update-all-accounts
The -update-all-accounts option causes a complete update of all Wusage accounts, including log rotation and archiving if they have been turned on, regardless of the schedule settings. This option is useful for testing purposes. See Configuring the Program in ISP Mode for more information.
-wusage-scheduled-update
The -wusage-scheduled-update option causes a complete update of all Wusage accounts, including log rotation and archiving if they have been turned on, if it is time to do so according to the current built-in scheduler settings. Beginning in Wusage 7.1, the Unix versions of Wusage automatically request that the Unix cron service run the program at the top of the hour with this option. An actual update takes place only at the top of the appropriate hour on appropriate days, as indicated through the Schedule Updates button on the Account Administration Page. See Configuring the Program in ISP Mode for more information.
-server
The -server option instructs Wusage to accept web browser connections on port 2396, if it is available, or another port if specified by the -p option. Each user who connects with a web browser is given the opportunity to log into a virtual domain account or the administrative account; many users can be logged in at once. This option ensures that the program is always available at a specific URL, which allows ISPs to share that single URL with their clients who have been given virtual domain accounts. Please note that virtual domain accounts and the Wusage administrative account are separate from Unix or NT accounts, with independent passwords for security reasons. For more information, see Configuring the Program in ISP Mode and Remote Access via the -server Option .
Note: because wusage has so many useful options, it is primarily controlled by configuration editor options rather than command line options.
Previous: Registering Your Copy Of Wusage
Next: Running Wusage Automatically
Table of Contents
Topical Configuration Editor Reference
Alphabetical Configuration Editor Reference
Alphabetical Configuration File Reference
Glossary of Frequently Used Terms

Contact Us