Skip to content

An easy to setup packaging of AWStats and AWStats-Totals for use on DreamHost

License

Notifications You must be signed in to change notification settings

chuckhoupt/awstats-dh

Repository files navigation

AWStats for DreamHost

An easy to setup packaging of AWStats and AWStats-Totals for use on DreamHost web-hosting services (shared or managed VPS).

Installation

AWStats-DH can be installed anywhere on a web site, and it will generate stats for all sites hosted under the same shell user. To install AWStats-DH on the site example.com, SSH login to the shell user (ssh [email protected]), and then perform the following setup.

  • Download

    Clone AWStats-DH into example.com's web directory:

    git clone --recurse-submodules https://github.com/chuckhoupt/awstats-dh.git example.com/awstats-dh
    
  • Build Initial Statistics

    Run the update script to generate the initial reports:

    ~/example.com/awstats-dh/update-awstats
    

Now visit example.com/awstats-dh/ to see the stats for all sites hosted under that shell user.

Further Configuration

  • Install Cron Job

    To update the reports daily, install a cron job:

    @daily example.com/awstats-dh/cronic example.com/awstats-dh/update-awstats day
    
  • Secure Reports

    Setup password protection for the awstats-dh directory via DH's Htaccess Panel.

  • Upgrade AWStats-DH

    To upgrade to the latest version of AWStats-DH, pull from repository:

    git pull --recurse-submodules
    

Troubleshooting

  • update-awstats fails or only partially updates stats

    By default, the update-awstats script process all available active logs (typically 3-30 days per site). If your shell user has a large number of sites, or very large logs, the script may be killed for excessive resource usage (on shared hosting). To avoid this problem, run the script with the day argument:

    ~/example.com/awstats-dh/update-awstats day
    

    In this mode, the script only looks at uncompressed log files for the last 24-48 hours (access.log and access.log.0), so it is faster and users fewer resources.

About

An easy to setup packaging of AWStats and AWStats-Totals for use on DreamHost

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published