Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chuckhoupt/awstats-dh
An easy to setup packaging of AWStats and AWStats-Totals for use on DreamHost
https://github.com/chuckhoupt/awstats-dh
analytics awstats dreamhost web-analytics web-statistics
Last synced: about 1 month ago
JSON representation
An easy to setup packaging of AWStats and AWStats-Totals for use on DreamHost
- Host: GitHub
- URL: https://github.com/chuckhoupt/awstats-dh
- Owner: chuckhoupt
- License: gpl-2.0
- Created: 2018-09-15T19:24:05.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-13T14:58:00.000Z (3 months ago)
- Last Synced: 2024-08-13T18:01:49.247Z (3 months ago)
- Topics: analytics, awstats, dreamhost, web-analytics, web-statistics
- Language: PHP
- Homepage:
- Size: 46.9 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://panel.dreamhost.com/index.cgi?tree=advanced.webdav&).
- **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.