Skip to content

Latest commit

 

History

History
67 lines (43 loc) · 2.03 KB

README.md

File metadata and controls

67 lines (43 loc) · 2.03 KB
Raw

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.