Home > AXS Visitor Tracking > Help > 1015

Running AXS from the command line

The "ax-admin.pl" script can be run from the command line in addition to running it from the web. This is useful mainly for creating static HTML views of your traffic at fixed times, with the help of scheduling software such as cron or at on Unix, or the Task Scheduler on Windows.

The syntax is to type "ax-admin.pl" followed by name=value pairs that are normally passed over the web. On the command line, separate the pairs with a space rather than an "&" character. For example, the following will create a graph of operating system usage:

ax-admin.pl MakeGraphs=true s03=on

The following will make a graph of operating system usage and hourly usage, and will save the HTML graphs to a file named "usage.html":

ax-admin.pl MakeGraphs=true s03=on s15=on > usage.html

These commands work equally well on Unix and Windows.

The typical strategy is to wrap up your AXS commands into a single batch file or Perl script, and then schedule this single command to run at a given time every day or week. For example, a sample Perl script that automates graph creation and log maintenance is cmd_demo.pl.

For your reference, here is a guide to the sXX names that correspond to particular AXS graphs:

	's01' ,	'Web Browser (Netscape 3.01 Gold)',
	's02' ,	'Abbreviated Browser (Netscape 3.X)',
	's03' ,	'Operating System (Windows 98)',
	's04' ,	'Visitors Top Level Domains (.com)',
	's05' ,	'First Level Domains (xav.com)',
	's06' ,	'Full Server Address (noc.xav.com)',
	's07' ,	'Visitor IP Address (',
	's08' ,	'Hits from Other Sites (Full URL)',
	's09' ,	'Hits from Other Sites (Domain Only)',
	's10' ,	'Hyperlinks Followed From This Site',
	's11' ,	'Hits to Local Documents',
	's12' ,	'Average Number of Hits Per Visitor',
	's13' ,	'Hits By Day of Year',
	's14' ,	'Hits By Day of the Week',
	's15' ,	'Hits By Hour of the Day',

    "Running AXS from the command line"