From 9b0b698523987b7631478bcf7dc84acf5e0e719c Mon Sep 17 00:00:00 2001 From: Marcel Haerry Date: Thu, 4 Aug 2011 10:48:57 +0200 Subject: move from concatenated_file to concat --- README | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'README') diff --git a/README b/README index 5964b21..7ea6e44 100644 --- a/README +++ b/README @@ -5,8 +5,9 @@ a very easy plugin interface. The munin homepage is http://munin.projects.linpro To use this module, follow these directions: -1. Install the "common" module -- the munin module depends on functions that are - defined and installed via the common module, see README.common for how to do this +1. Install the "common" and "concat" module -- the munin module depends on functions + that are defined and installed via these modulesh, see README.common for how to do + this 2. You will need storedconfigs enabled in your puppet setup, to do that you need to add a line to your puppet.conf in your [puppetmasterd] section which says: -- cgit v1.2.3 From 568fa47b11489b7ec7cac556e6927017f6cc8cc7 Mon Sep 17 00:00:00 2001 From: Marcel Haerry Date: Thu, 4 Aug 2011 12:58:36 +0200 Subject: Update README - this is not anymore necessary --- README | 21 +++++++-------------- 1 file changed, 7 insertions(+), 14 deletions(-) (limited to 'README') diff --git a/README b/README index 7ea6e44..b00e646 100644 --- a/README +++ b/README @@ -36,14 +36,7 @@ To use this module, follow these directions: "modules.pp" in your site.pp, if you do not have that, then you will need to add the import line to your site.pp) - c. you will also need to create the following empty directories: - - mkdir /etc/puppet/modules/munin/files/empty - mkdir /etc/puppet/modules/munin/files/modules_dir - mkdir -p /etc/puppet/modules/munin/files/nodes/modules_dir - mkdir -p /etc/puppet/modules/munin/files/plugins/modules_dir - - d. Add to the top of your site.pp a variable which indicates what IP should be allowed to + c. Add to the top of your site.pp a variable which indicates what IP should be allowed to connect to your individual munin-nodes (this is typically your main munin host's IP): $munin_allow = '192.168.0.1' @@ -52,16 +45,16 @@ To use this module, follow these directions: $munin_allow = '127.0.0.1:192.168.0.1' - e. In the node definition in your site.pp for your main munin host, add the following: + d. In the node definition in your site.pp for your main munin host, add the following: include munin::host - f. On each node that will gather munin statistics, add this line to that node's entry + e. On each node that will gather munin statistics, add this line to that node's entry in site.pp (you may want to also add this to your main munin host): include munin::client - g. If there are particular munin plugins you want to enable or configure, you define them + f. If there are particular munin plugins you want to enable or configure, you define them in the node definition, like follows: # Enable monitoring of disk stats in bytes @@ -81,13 +74,13 @@ To use this module, follow these directions: } - h. If you have Linux-Vservers configured, you will likely have multiple munin-node processes + g. If you have Linux-Vservers configured, you will likely have multiple munin-node processes competing for the default port 4949, for those nodes, set an alternate port for munin-node to run on by putting something similar to the following in the node definition: $munin_port = 4948 - i. If you'd like to do cgi graphing, please note the following page: http://munin.projects.linpro.no/wiki/CgiHowto + h. If you'd like to do cgi graphing, please note the following page: http://munin.projects.linpro.no/wiki/CgiHowto For CentOS this is enabled in the default header config - j. Per default (on CentOS) munin will send warnings and critical messages to root + i. Per default (on CentOS) munin will send warnings and critical messages to root -- cgit v1.2.3 From 9b161f0c61bbd30960e663eceef8f1b35f633507 Mon Sep 17 00:00:00 2001 From: mh Date: Sat, 5 Nov 2011 14:14:32 +0100 Subject: use hiera to configure munin node specific things --- README | 32 ++++++++++++-------------------- 1 file changed, 12 insertions(+), 20 deletions(-) (limited to 'README') diff --git a/README b/README index b00e646..22bb19f 100644 --- a/README +++ b/README @@ -28,33 +28,25 @@ To use this module, follow these directions: a. Your modules directory will need all the files included in this repository placed under a directory called "munin" - b. add the following line to your modules.pp: - - import "munin" - - (NOTE: if you have followed the directions in README.common then you will have import - "modules.pp" in your site.pp, if you do not have that, then you will need to add the - import line to your site.pp) - - c. Add to the top of your site.pp a variable which indicates what IP should be allowed to + b. Add your hiera storage value for munin_allow which indicates what IP should be allowed to connect to your individual munin-nodes (this is typically your main munin host's IP): - $munin_allow = '192.168.0.1' + munin_allow: '192.168.0.1' - If you want to define more than one host, you can seperate them by colon: + If you want to define more than one host, you can define them as an array: - $munin_allow = '127.0.0.1:192.168.0.1' + munin_allow: ['127.0.0.1','192.168.0.1'] - d. In the node definition in your site.pp for your main munin host, add the following: + c. In the node definition in your site.pp for your main munin host, add the following: include munin::host - e. On each node that will gather munin statistics, add this line to that node's entry + d. On each node that will gather munin statistics, add this line to that node's entry in site.pp (you may want to also add this to your main munin host): include munin::client - f. If there are particular munin plugins you want to enable or configure, you define them + e. If there are particular munin plugins you want to enable or configure, you define them in the node definition, like follows: # Enable monitoring of disk stats in bytes @@ -74,13 +66,13 @@ To use this module, follow these directions: } - g. If you have Linux-Vservers configured, you will likely have multiple munin-node processes + f. If you have Linux-Vservers configured, you will likely have multiple munin-node processes competing for the default port 4949, for those nodes, set an alternate port for munin-node - to run on by putting something similar to the following in the node definition: + to run on by putting something similar to the following in hiera's node scope: - $munin_port = 4948 + munin_port: 4948 - h. If you'd like to do cgi graphing, please note the following page: http://munin.projects.linpro.no/wiki/CgiHowto + g. If you'd like to do cgi graphing, please note the following page: http://munin.projects.linpro.no/wiki/CgiHowto For CentOS this is enabled in the default header config - i. Per default (on CentOS) munin will send warnings and critical messages to root + h. Per default (on CentOS) munin will send warnings and critical messages to root -- cgit v1.2.3 From c95f0b2fcf4f35b1a7ae3ad9c04600a32ab2bb43 Mon Sep 17 00:00:00 2001 From: mh Date: Wed, 13 Jun 2012 20:40:57 -0300 Subject: migrate away from hiera stuff --- README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'README') diff --git a/README b/README index 22bb19f..1e47d27 100644 --- a/README +++ b/README @@ -28,7 +28,7 @@ To use this module, follow these directions: a. Your modules directory will need all the files included in this repository placed under a directory called "munin" - b. Add your hiera storage value for munin_allow which indicates what IP should be allowed to + b. Add your class parameter for munin::client::allow which indicates what IP should be allowed to connect to your individual munin-nodes (this is typically your main munin host's IP): munin_allow: '192.168.0.1' @@ -68,9 +68,9 @@ To use this module, follow these directions: f. If you have Linux-Vservers configured, you will likely have multiple munin-node processes competing for the default port 4949, for those nodes, set an alternate port for munin-node - to run on by putting something similar to the following in hiera's node scope: + to run on by putting something similar to the following class parameter: - munin_port: 4948 + port => 4948 g. If you'd like to do cgi graphing, please note the following page: http://munin.projects.linpro.no/wiki/CgiHowto For CentOS this is enabled in the default header config -- cgit v1.2.3 From 9dbd0cabcae7a23079253af384bb7104166b935c Mon Sep 17 00:00:00 2001 From: micah Date: Wed, 20 Mar 2013 16:44:17 -0400 Subject: README update: clarify the language so it doesn't specifically talk only about the common module, when concat is also a requirement --- README | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) (limited to 'README') diff --git a/README b/README index 1e47d27..3923d46 100644 --- a/README +++ b/README @@ -5,9 +5,8 @@ a very easy plugin interface. The munin homepage is http://munin.projects.linpro To use this module, follow these directions: -1. Install the "common" and "concat" module -- the munin module depends on functions - that are defined and installed via these modulesh, see README.common for how to do - this +1. Install the "common" and "concat" module -- the munin module depends on + functions that are defined and installed via these modules. 2. You will need storedconfigs enabled in your puppet setup, to do that you need to add a line to your puppet.conf in your [puppetmasterd] section which says: -- cgit v1.2.3 From 4f8c8302b09c302e71cf3ba73022e73673276a9d Mon Sep 17 00:00:00 2001 From: micah Date: Wed, 20 Mar 2013 17:18:22 -0400 Subject: README: update README to reflect a real setup, clarifying exactly how you go about getting things setup --- README | 56 ++++++++++++++++++++++++++++++-------------------------- 1 file changed, 30 insertions(+), 26 deletions(-) (limited to 'README') diff --git a/README b/README index 3923d46..83a4ad7 100644 --- a/README +++ b/README @@ -27,51 +27,55 @@ To use this module, follow these directions: a. Your modules directory will need all the files included in this repository placed under a directory called "munin" - b. Add your class parameter for munin::client::allow which indicates what IP should be allowed to - connect to your individual munin-nodes (this is typically your main munin host's IP): + b. For every host you wish to gather munin statistics, add the class munin::client to that + node. You will want to set the class parameter 'allow' to be the IP(s) of the munin + collector, this defines what IP is permitted to connect to the node, for example: - munin_allow: '192.168.0.1' - - If you want to define more than one host, you can define them as an array: + node foo { + class { 'munin::client': allow => '192.168.0.1'} + } - munin_allow: ['127.0.0.1','192.168.0.1'] + for multiple munin nodes, you can pass an array: + class { 'munin::client': allow => [ '192.168.0.1', '10.0.0.1' ] } + c. In the node definition in your site.pp for your main munin host, add the following: - include munin::host - - d. On each node that will gather munin statistics, add this line to that node's entry - in site.pp (you may want to also add this to your main munin host): - - include munin::client + class { 'munin::host': } - e. If there are particular munin plugins you want to enable or configure, you define them + If you want cgi graphing you can pass cgi_graphing => true. + (For CentOS this is enabled in the default header config) + for more information, see: http://munin.projects.linpro.no/wiki/CgiHowto + + d. If there are particular munin plugins you want to enable or configure, you define them in the node definition, like follows: # Enable monitoring of disk stats in bytes - munin::plugin { df_abs: } + munin::plugin { 'df_abs': } # Use a non-standard plugin path to use custom plugins - munin::plugin { "spamassassin": - ensure => "spamassassin", - script_path => "/usr/local/share/munin-plugins", + munin::plugin { 'spamassassin': + ensure => present, + script_path => '/usr/local/share/munin-plugins', + } + + # For wildcard plugins (eg. ip_, snmp_, etc.), use the name variable to + # configure the plugin name, and the ensure parameter to indicate the base + # plugin name to which you want a symlink, for example: + munin::plugin { [ 'ip_192.168.0.1', 'ip_10.0.0.1' ]: + ensure => 'ip_' } # Use a special config to pass parameters to the plugin munin::plugin { - [ "apache_accesses", "apache_processes", "apache_volume" ]: + [ 'apache_accesses', 'apache_processes', 'apache_volume' ]: ensure => present, - config => "env.url http://127.0.0.1:80/server-status?auto" + config => 'env.url http://127.0.0.1:80/server-status?auto' } - - f. If you have Linux-Vservers configured, you will likely have multiple munin-node processes + e. If you have Linux-Vservers configured, you will likely have multiple munin-node processes competing for the default port 4949, for those nodes, set an alternate port for munin-node to run on by putting something similar to the following class parameter: - port => 4948 - - g. If you'd like to do cgi graphing, please note the following page: http://munin.projects.linpro.no/wiki/CgiHowto - For CentOS this is enabled in the default header config + class { 'munin::client': allow => '192.168.0.1', port => '4948' } - h. Per default (on CentOS) munin will send warnings and critical messages to root -- cgit v1.2.3 From f79f662bedbbd75c7e2022da282ba48c1b323e90 Mon Sep 17 00:00:00 2001 From: micah Date: Wed, 20 Mar 2013 18:15:20 -0400 Subject: README: stdlib is a required module due to the reject() --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'README') diff --git a/README b/README index 83a4ad7..ab962a0 100644 --- a/README +++ b/README @@ -5,8 +5,8 @@ a very easy plugin interface. The munin homepage is http://munin.projects.linpro To use this module, follow these directions: -1. Install the "common" and "concat" module -- the munin module depends on - functions that are defined and installed via these modules. +1. Install the "common", "concat" and "stdlib" modules -- the munin module + depends on functions that are defined and installed via these modules. 2. You will need storedconfigs enabled in your puppet setup, to do that you need to add a line to your puppet.conf in your [puppetmasterd] section which says: -- cgit v1.2.3 From d7b7240acbd4bfd89beae245cc8da6d667c6dfff Mon Sep 17 00:00:00 2001 From: micah Date: Wed, 20 Mar 2013 18:31:12 -0400 Subject: README: note that puppet 2.7 is required --- README | 2 ++ 1 file changed, 2 insertions(+) (limited to 'README') diff --git a/README b/README index ab962a0..ef3c2fd 100644 --- a/README +++ b/README @@ -5,6 +5,8 @@ a very easy plugin interface. The munin homepage is http://munin.projects.linpro To use this module, follow these directions: +0. This module requires puppet 2.7 or newer. + 1. Install the "common", "concat" and "stdlib" modules -- the munin module depends on functions that are defined and installed via these modules. -- cgit v1.2.3