aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorPetter Reinholdtsen <pere@hungry.com>2011-12-17 11:23:59 +0000
committerPetter Reinholdtsen <pere@hungry.com>2011-12-17 11:23:59 +0000
commit8428e441a113fa1366c7336d2cca8d05b35c4a87 (patch)
tree1db199ded3a344241544e3315b3d237a3b37f2b9 /README
parent0e39b5ea1a0f351c3d1e657095296ba28e6da5eb (diff)
downloadsitesummary-8428e441a113fa1366c7336d2cca8d05b35c4a87.tar.gz
sitesummary-8428e441a113fa1366c7336d2cca8d05b35c4a87.tar.bz2
sitesummary-8428e441a113fa1366c7336d2cca8d05b35c4a87.tar.xz
Add support for remapping hostnames for individual client entries,
to make it possible to gather Munin and Nagios status for hosts behind VPN connections and with non-unique host names.
Diffstat (limited to 'README')
-rw-r--r--README30
1 files changed, 24 insertions, 6 deletions
diff --git a/README b/README
index dfafdb4..e0be004 100644
--- a/README
+++ b/README
@@ -28,12 +28,12 @@ to enable Munin autoconfig on the sitesummary collector
Sitesummary generated Nagios configuration
------------------------------------------
-Since version 0.0.51, there is experimental code in sitesummary to
-generate Nagios configuration based on the collected information. To
-enable this, install nagios3 and nagios-plugins-standard, edit
-/etc/default/nagios3 to include
-'NAGIOSCFG=/etc/nagios3/sitesummary.cfg' and run the sitesummary cron
-job. Running these commands as root normally does the trick.
+Since version 0.0.51, there is code in sitesummary to generate Nagios
+configuration based on the collected information. To enable this,
+install nagios3 and nagios-plugins-standard, edit /etc/default/nagios3
+to include 'NAGIOSCFG=/etc/nagios3/sitesummary.cfg' and run the
+sitesummary cron job. Running these commands as root normally does
+the trick.
aptitude install nagios3 nagios-plugins-standard
echo 'NAGIOSCFG="/etc/nagios3/sitesummary.cfg"' >> /etc/default/nagios3
@@ -70,6 +70,24 @@ to query Nagios NRPE on the clients.
sitesummary-client sitesummary-client/nagios-server string sitesummary
sitesummary-client sitesummary-client/enable-nagios-nrpe-config boolean true
+Handling hosts behind VPN connections
+-------------------------------------
+
+To handle hosts with hostnames missing in DNS or IP adresses not
+available directly from the Nagios and Munin server, a mechanism to
+map entries to new hostnames is provided.
+
+To enable it, create a file /etc/sitesummary/hostmap with content like this
+
+ ether-AA:BB:CC:DD:EE:FF new-name
+
+The ether-* name is the host entry name from
+/var/lib/sitesummary/entries/, and the new-name entry is the hostname
+to use instead of the value in system/hostname.
+
+For this to work, the new-name entry must map to a IP address, either
+in DNS via an entry in /etc/hosts.
+
Design draft
------------
system to collect key info about all the machines on a site, to help