H-Sphere Admin Guide

AWStats Support
(version 2.4 and higher)

 

Starting with version 2.4, H-Sphere supports AWStats, a free tool that generates advanced graphical web server statistics reports. AWStats is set up on each Unix/Linux and Windows web server with H-Sphere installation or upgrade.

 

Setup

To enable AWStats in a plan:

  1. Launch Plan Editor
  2. Check Include to make AWStats available to users
  3. Check Activated to have new accounts created with AWStats enabled.

 

Configuration On Unix/Linux

Statistics reports are static html pages generated with the following cron job:
0 5 * * * nice -15 /hsphere/shared/scripts/cron/awstats_cron.pl

User config file is [DOMAIN_DIRECTORY]/awstats/awstats.[DOMAIN_NAME].conf
There are also symlinks each domain's config file in /hsphere/shared/awstats/wwwroot/.

 

Configuration On Windows

AWStats collects specifically web statistics with reports generated every 24 hours.

When a user (for example, usertest) turns on AWStats for a domain (e.g., mydomain.com), H-Sphere creates:

  1. the AWStats virtual directory in the domain root folder pointing to \HSphere\skeleton\AWStats.
  2. the AWStats\awstats.log file in the user's log directory (\hshome\usertest\logs\mydomain.com\AWStats\awstats.log) where domain logs for AWStats are collected.
  3. the AWStats configuration file for a domain (awstats.mydomain.com.conf) in the \HSphere\skeleton\AWStats directory.

The awstats.log file is automatically rotated by AWStats (AWStats removes processed rows from this file). The \HSphere\bin\stats.exe utility updates AWStats statistics daily at 00:01 AM.

The AWStats domain page is password-protected and can be viewed only by the domain owner (password protection is off if Serv-U is used).

 

 



© Copyright 1998-2004. Positive Software Corporation.
All rights reserved.