Puppet module: webmin

# Written by Lab42 #
# http://www.Example42.com

Licence: Apache2

DESCRIPTION:
This module installs and manages webmin.
It's based on Example42's module structure and features standard and
extended classes for automatic monitoring, backup and firewalling.

All the variables used in this module are defined in the webmin::params class
(File: $MODULEPATH/webmin/manifests/params.pp). Here you can:
- Set default settings and filtering module's specific Users variables
- Add selectors for internal variables to adapt the module to different OSes
- Review and eventually change default settings for variables that affect the
  Example42 extended classes.

Customizations for different projects and logic on how to populate configuration
files should be placed in the $my_project classes.


MODULE'S SPECIFIC USER VARIABLES:


USAGE:
# Standard Classes 
include webmin              # Install and run webmin 

include webmin::disable     # Disable webmin service.
include webmin::disableboot # Disable webmin service at boot time, but don't stop if is running.
include webmin::absent      # Remove webmin package.
include webmin::debug       # Used for debugging purposes (not resource hungry)
                         # Automatically included if $debug=yes
                         # Requires Example42's puppet::params and puppet::debug

# Extended Classes
include webmin::puppi       # Puppi extensions for the webmin module
                         # Requires Example42's puppi module
include webmin::monitor     # Monitor webmin
                         # Automatically included if $monitor=yes
                         # Requires Example42's monitor module
include webmin::backup      # Backup webmin data
                         # Automatically included if $backup=yes
                         # Requires Example42's backup module
include webmin::firewall    # Manages firewall rules for webmin service
                         # Automatically included if $firewall=yes
                         # Requires Example42's firewall module

# Generic define to set parameters in the main configuration file. EXPERIMENTAL.
webmin::conf { "ParameterName": value="YourValue"} # Generic 

# Module specific classes

# Module specific defines


EXAMPLE42 GENERAL VARIABLES:
Example42 modules collection uses some general variables that can influence the
behaviour of this module. You can happily live without considering or setting them,
but they can be useful to get many useful features out of the box.
$my_project - If set, permits you to alter and customize the module behaviour
  and files's deploy logic in custom project classes
  The custom class webmin::$my_module autoloads from MODULEPATH/webmin/manifests/$my_project.pp
  but you can place it in a separated module by explicitely importing it:
  "import $my_project" to have something like MODULEPATH/$my_project/manifests/webmin.pp
$base_source - Lets you define an alternative source for static files:
  - $base_source not set -> Files are looked in puppet://$servername/ (the PuppetMaster)
  - $base_source set -> Files are in $base_source ( Ex: puppet://$servername/$my_module ) 
  Note that the module automatically manages the different paths for Puppet pre 0.25
$debug - If set to yes writes in /var/lib/puppet/debug/ useful debugging info

VARIABLES FOR EXTENDED MODULES:
$puppi - Set to "yes" to enable webmin plugins for puppi
Check webmin/manifests/puppi.pp for more info.

$monitor - Set to "yes" to enable auto monitoring classes 
$monitor_tool - Defines the monitor tools to activate (At leat one, can be an array)
Check webmin/manifests/monitor.pp for more info on webmin monitoring related variables.

$backup - Set to "yes" to enable auto backuping classes 
$backup_tool - Defines the backup tools to activate (At leat one, can be an array)
Check webmin/manifests/backup.pp for more info on webmin backuping related variables.

$firewall - Set to "yes" to enable auto firewalling classes
$firewall_tool - Defines the firewall tools to activate
Check webmin/manifests/firewall.pp for more info on webmin firewalling related variables.


DEPENDENCIES:
Standard classes generally don't need external modules.
Extended classes need the relevant external modules.
webmin::conf generic infile configuration define needs the Example42 "common" module


OPERATING SYSTEMS SUPPORT (Planned, Development, Testing, Production):
RedHat/Centos 5 : Testing
RedHat/Centos 6 : Testing
Debian 5        : Testing
Debian 6        : Planned
Ubuntu 8.04     : Testing
Ubuntu 10.04    : Testing
SLES 10         : Planned
SLES 11         : Testing