puppet-monit's Introduction

Monit Puppet Module

Very simple module for installing and configuring monit.

Quick Start

Download the module and put it in your "modules" folder:

$ git clone tom@[email protected]:tompurl/puppet-monit.git

Add this to your manifest:

class { 'monit': 
  alert_address  => "[email protected]",
  smtp_host      => "smtp.mandrillapp.com",
  smtp_port      => 587,
  smtp_user_name => "[email protected]",
  smtp_password  => "thisIsReallyClever",
}

Visit the page with a console-based web browser (like elinks) from the local server console:

$ elinks http://localhost:2812
# username => admin, pass => monit

You can change the username and password by setting the following parameters:

web_username
web_password

Overview

This is a very simple module that simply installs monit with a lightweight config file. Any additional configuration information should be placed in files that are stored in one of the following directories:

/etc/monit/conf.d
/etc/monit/monitrc.d #Seems to be preferred on Debian

Why Do I Need An Email Address?

The main way that monit communicates with you is by email. I recommend mandrill as a good, simple SMTP service.

Tested Platforms

Debian 7 on x64 and Raspbian. No effort has yet been made to make it work with anything else.

monit class parameters

Parameter	Type	Default	Description
alert_address	string	none	The address to which monit will send notifications
smtp_host	string	none	The host names for your SMTP server
smtp_port	int	none	Duh :)
smtp_user_name	string	none	The username for your SMTP account
smtp_password	string	none	The password associated with the $smtp_user_name value
web_username	string	admin	The username that you want to use to log into monitweb
web_password	string	monit	The password that you want to use with monitweb

Recommend Projects