- Overview
- Module Description - What the module does and why it is useful
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- License
- Support
This module allows puppet to manage/configure a webalizer set-up, providing support for multiple virtual hosts.
It is a fork of CERNOps/webalizer by CERN-Ops.
It is also my first attempt to publish a puppet module, so please be patient :)
- Installs the webalizer package.
- Creates webalizer's config file(s).
- Overwrites the cron job file provided by the package (non-debian only).
- Optionally creates apache configuration to serve webalizer's output.
NOTE: See Limitations: Apache config.
This module has been tested on Debian "wheezy" and "jessie".
There are two "main modes" of usage, depending if you want to create just one or more than one webalizer configuration files (i.e. to produce stats for multiple virtual hosts).
On top of that, both the webalizer
class and the webalizer::config
defined type basically accept as many params as the webalizer program makes available.
For default values see webalizer::params
and either webalizer
or webalizer::config
respectively.
If you just need to produce output stats for a single web site, you need to declare webalizer
as a parametrized class and let it produce a single webalizer.conf
file.
The following is an example for setting up webalizer to process an alternate log file, and then grant access from all to the publication tree (but see Limitations: Apache config for details about the *'allow' parameter):
class { 'webalizer':
singleconfig => true,
logfile => "/var/log/httpd/my_access.log",
puppet_apache => true,
allow => 'from all',
}
If you want to produce stats for different web sites, you should use the webalizer::config
defined type to produce multiple webalizer config files. In that case, you can not call the webalizer
class with the singleconfig parameter set to true.
An example follows:
class { 'webalizer':
puppet_apache => true,
allow => 'from localhost 127.0.0.0/8 ::1 192.168.1.0/24',
}
webalizer::config { ['site1', 'site2']:
htmlhead => ['<meta http-equiv="content-type" content="text/html; charset=UTF-8">',
'<META NAME="author" CONTENT="The Webalizer">'],
htmltail => '';
}
First we declare the webalizer
class and tell it to create an apache snippet. Note that, since this invocation won't create a webalizer.conf
file and, in fact, it will delete the webalizer.conf
file at its default location, webalizer-related params will be ignored.
An alternate invocation if default params are OK, would be just include webalizer
.
Then we declare the webalizer::config
defined type, which tries to set sensible defaults out of the defined type instance's $title:
- On Debian (and derivatives):
- Output config file:
/etc/webalizer/${title}.conf
- Log file to process:
/var/log/apache2/${title}.access.log
- Hostname:
$title
- Output directory:
/var/www/webalizer/${title}
- Output config file:
- On other systems:
- Output config file:
/etc/${title}.conf
- Log file to process:
/var/log/httpd/${title}.access.log
- Output directory:
/var/www/usage/${title}
- Output config file:
Of course, you still can overwrite all the avaliable params for a finer tuned result.
Up to version 0.2.3, this module has been tested on rhel/fedora and debian systems.
Version 1.0.0 underwent significant changes in order to allow virtual hosts support by means of multiple configuration files. Therefore, since I only use Debian systems nowadays, version 1.0.0 and upwards are tagged to only be Debian compatible.
This doesn't necessarily mean it won't work on redhat derivatives, it's only it hasn't been tested.
In case of problems on other distributions, patches are welcome.
You probably want webalizer's stats to be published by your local web server but current support for this is very basic:
- You can set webalizer's
$puppet_apache
boolean class variable to true. This will create an apache config snippet either at/etc/webalizer/apache.config
(on debian) or/etc/httpd/conf.d/webalizer.conf
(on other systems).
It is up to you what to do with it in order for Apache to read it and publish webalizer's contents.- There was a auth-related change in apache's syntax on version 2.4 upwards. While in 2.4 you'd use something like the following snippet to control access to a virtual dir...
apache
Order allow,deny Allow from 127.0.0.1
I added logic and a new template to cope with the differences. For more details see the relevant Apache docs....You will use something like the following with apache 2.4: ```apache``` Require local
- There was a auth-related change in apache's syntax on version 2.4 upwards. While in 2.4 you'd use something like the following snippet to control access to a virtual dir...
- The
webalizer::config
defined type, offers no support for the$puppet_apache
boolean, so it's up to you how to publish webalizer's stats when more than one site is process.
Apache 2.0
Please log tickets and issues at https://github.com/jmnavarrol/puppet-webalizer/issues.