readme, license and authors file. also tpl and tpl-howto

diff --git a/AUTHORS b/AUTHORS
new file mode 100644 (file)
index 0000000..8b2b2f7
--- /dev/null
+++ b/AUTHORS
@@ -0,0 +1 @@
+Christian Weiske <cweiske@cweiske.de>

diff --git a/LICENSE b/LICENSE
new file mode 100644 (file)
index 0000000..33a0665
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1 @@
+This files are licensed under the GPLv3 or later.

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..d2ed489
--- /dev/null
+++ b/README
@@ -0,0 +1,32 @@
+AWStats helper scripts
+======================
+
+We use AWStats [1] to get statistics about the web sites hosted
+on our server. Setting up AWStats for a single site is easy,
+but for multiple domains it is really tedious work.
+Further, the tools provided with AWStats that support multiple
+configuration files do not support historic data.
+There is i.e. no way to look at the detailled statistics of last month
+or the stats for a site of two years ago.
+
+These scripts provide the following functionality:
+- Rendering of historical data
+- Updating the current month's data and regenerating report files
+- Regenerating last month's report files
+- Index page generation linking to all this data
+
+The scripts utilize awstats.pl and awstats_buildstaticpages.pl
+from the AWStats distribution.
+
+[1] http://awstats.sourceforge.net/
+
+
+
+Installation
+------------
+1. copy config.php.dist to config.php
+2. Adjust config.php to your needs
+3. Run create-historic.php to create all historic files
+4. Add update-sites.php to your crontab, let it run every hour
+5. Add update-lastmonth.php to your crontab and let it run
+   on the first day every month

diff --git a/tpl b/tpl
new file mode 100644 (file)
index 0000000..3b2f123
--- /dev/null
+++ b/tpl
@@ -0,0 +1,5 @@
+Include "/etc/awstats/awstats.conf"
+
+LogFile="/var/log/apache2/pear/DOMAIN-access.log"
+SiteDomain="DOMAIN"
+DefaultFile=""

diff --git a/tpl-use-howto b/tpl-use-howto
new file mode 100644 (file)
index 0000000..e3fa76c
--- /dev/null
+++ b/tpl-use-howto
@@ -0,0 +1,2 @@
+cd /var/www/benutzer/
+for i in `ls .`; do cat /etc/awstats/tpl | sed "s/DOMAIN/$i/" > /etc/awstats/awstats.$i.conf; done
\ No newline at end of file