HowtoForge Forums | HowtoForge - Linux Howtos and Tutorials

HowtoForge Forums | HowtoForge - Linux Howtos and Tutorials (
-   Tips/Tricks/Mods (
-   -   HOWTO: Run AWStats from the Command Line (

linus3x 22nd October 2010 22:54

HOWTO: Run AWStats from the Command Line
We recently needed to run a midday report of AWStats and I wanted to share what we learned. Because ISPConfig 3 runs one report at 12:30 AM, I decided to kick off a midday run of AWStats from the command line.

These instructions are for Debian Lenny.

Note: If you ever want to run ISPConfig's entire nightly cron job from the command line (which includes the AWStats reports), you can use:


The instructions that follow assume that you only want to update AWStats for a single website.

First of all, I’m assuming you’ve got ISPConfig 3 installed correctly and that all of the AWStats paths are set to the defaults on the System > Server Config > Web tab. In addition, I’ll assume that when you set up your Website > Web Domain > Statistics tab, you entered in a password and you selected AWStats as your Webstatistics program.

If so, then you can imitate what ISPConfig 3 does when it does its run. First go to this directory:


cd /etc/awstats/
Run ls and look for a file with your domain name in it. It’ll be something like:

That’s your site’s config file. You’ll need to know whatever is between awstats and conf when you do the update. Here’s it just but if the file were named something like:

You’d need:

Make sense?

Ok, next you’re going to need to know where to place the output files. If you’ve gone with the defaults, this is probably going to be something like this:


Where client1 and web1 are whatever is displayed on the Website > Web Domain > Options tab. (If you’ve made any adjustments to the System > Server Config > Web tab > Website path you’ll need to adjust your output path accordingly.)

You’re ready to run the command, substituting in your information:


/usr/share/awstats/tools/ -update -awstatsprog=/usr/lib/cgi-bin/ -dir=/var/www/clients/client1/web1/web/stats
So breaking it down:


-config=whatever was the “xxx” in your file name
-update run an update to pick up the latest stats
-awstatsprog=path to on your system
-dir=your output file directory

Once you’re done, you can access your stats using something similar to the following:

You’ll be asked for your name and password – this is admin plus whatever you set up on the Website > Web Domain > Statistics tab.

linus3x 22nd October 2010 23:54

One More Thing...
By the way, I should add to this that the nightly cron job takes the added step of renaming the file to index.html so that you can access the stats using:

So if wanted to completely mimic the nightly cron job, you'd run something like:


mv /var/www/clients/client1/web1/web/stats/ /var/www/clients/client1/web1/web/stats/index.html

All times are GMT +2. The time now is 03:41.

Powered by vBulletin® Version 3.8.7
Copyright ©2000 - 2014, vBulletin Solutions, Inc.