Networkmonitoring » Nagios

ID #1034

Nagios Manager README und INSTALL

****   Kurzbeschreibung des Nagios Managers

Der Nagios Manager wurde von mir Ende 2004 entwickelt, um die Konfiguration der weit verbreiteten und leistungsstarken
Systemmonitoring Software Nagios zu vereinfachen. Der Nagios Manager hilft ueber eine Weboberflaeche die wesentlichen
Konfigurationen durchzufuehren. In der vorliegenden Version 1.x koennen nicht alle Moeglichkeiten von Nagios konfiguriert
werden. Weitergehende Konfigurationen koennen (falls notwendig) nach wie vor direkt in den Nagios Konfigurationsfiles
vorgenommen werden. 
Der Nagios Manager liest und schreibt direkt die Nagios Konfigurationsfiles. Optionen, die zusaetzlich in der Konfiguration
stehen, werden vom Nagios Manager nicht veraendert. Somit ist es auch bei komplexen Nagios Konfigurationen moeglich, den
Nagios Manager fuer bestimmte Einstellungen (die eben derzeit implementiert sind) einzusetzen.



****   Fuer wen ist der Nagios Manager gedacht ?

Zunaechst habe ich den Nagios Manager fuer meine Kunden (die mein ITAS System einsetzen) programmiert. Durch den modularen
Softwareaufbau von ITAS ist es leicht moeglich gewesen, den Nagios Manager als eigenstaendige Software zur Verfuegung zu stellen.
Dadurch kann ich nun auch meinen Teil dazu beitragen, dass der OpenSource Gedanke weiter vorangetrieben wird.
Fuer alle Administratoren, die Nagios einsetzen oder wegen der vielleicht zu muehseligen Konfiguration bisher nicht einsetzen wollten,
ist der Nagios Manager das richtige Tool um endlich komfortabel und uebersichtlich Kontaktgruppen, Kontake, Hostgruppen, Hosts und 
Services ins Nagios aufzunehmen und zu administrieren.



****   Lizenz

Der Nagios Manager wird von mir frei verfuegbar unter www.nagiosmanager.de zum download angeboten.
Als Lizenz habe ich die General Public License (GPL) gewaehlt. Die Bestimmungen hierzu koennen unter
http://www.gnu.org/licenses/gpl.html  nachgelesen werden.



****   Gewaehrleistung, Garantie, Haftung

Ich uebernehme fuer die unter der GPL veroeffentlichte Version des Nagios Managers keinerlei Garantie fuer Funktion,
fehlerfreiem Arbeiten oder sonsitgen Beeintraechtigungen oder Schaeden irgendwelcher Art.
Es gilt ein absoluter Haftungsausschluss durch den Einsatz des Nagios Managers !



****   Vorraussetzungen und Einschraenkungen

Der Nagios Manager laueft auf allen Linux (und wahrscheinlich auf allen Unix) Systemen

Auf dem System muss der Webserver apache laufen und Nagios in der Version 2.x

Ab der Nagios Version 2.x kann man die komplette Nagioskonfiguration in einem Konfigfile ablegen.
Dies wird vom Nagios Manager nicht unterstuetzt !
Der Nagios Manager arbeitet ausschliesslich mit gesplitteten Konfigfiles (wie bei Nagios bisher ueblich und meiner Meinung nach
auch weiterhin sinnvoll)

Es ist daher die nagios.cfg folgendermassen anzupassen:

Sektion in der nagios.cfg:

	# You can split other types of object definitions across several
	# config files if you wish (as done here), or keep them all in a
	# single config file.

	#cfg_file=/usr/local/nagios/etc/minimal.cfg

	cfg_file=/usr/local/nagios/etc/contactgroups.cfg
	cfg_file=/usr/local/nagios/etc/contacts.cfg
	cfg_file=/usr/local/nagios/etc/dependencies.cfg
	cfg_file=/usr/local/nagios/etc/escalations.cfg
	cfg_file=/usr/local/nagios/etc/hostgroups.cfg
	cfg_file=/usr/local/nagios/etc/hosts.cfg
	cfg_file=/usr/local/nagios/etc/services.cfg
	cfg_file=/usr/local/nagios/etc/timeperiods.cfg


Hinweis: Bei der Installation wird die Existenz dieser Konfigfiles ueberprueft und ggf. angelegt !

Bei der Verwendung von vorhandenen Nagios Konfigurationsfiles, sind einige Regeln zu beachten:
Namen sollten immer "zusammenhaengend" sein. Das bedeutet Namen wie "Linux Server" sollten in "Linux_Server"
oder aehnlichem vor dem Einsatz des Nagios Manager geaendert werden. 
-> Der Nagios Manager checked bei der Eingabe die Namen und korrigiert ggf. Sonderzeichen oder nicht zusammenhaengende Namen,
aber nicht bei bereits in den Nagios Konfigurationsfiles vorhandenen Namen !

Bestimmte Zeichen gelten als Sonderzeichen fuer Nagios und/oder fuer den Nagios Manager.
Diese waeren z.B. : " \    (und einige mehr)
Es ist sicher immer ein guter Stil, wenn man Konfigfiles auf Linuxebene hat, sich (und der Software) das Leben nicht durch
das Probieren aller auf der Tastatur verfuegbaren Zeichen schwer zu machen. Verwendet einfach die alphanumerischen Zeichen.
Bei Eingaben ueber den Nagios Manager ueberprueft er, wie oben erwaehnt, die Eingabe und "korrigiert" Sonderzeichen in ein "_"



****   Nagios Upgrade von version 1.x nach 2.x

Fuer ein Upgrade von Nagios von Version 1.x nach 2.x sind einige Aenderungen vorzunehmen.
Die Nagios Konfigurationsdateien nagios.cfg und cgi.cfg sind wieder an die Umgebung anzupassen.
Die wichtigste Aenderung, und zwingend notwendig da sonst Nagios nicht startet ist, dass die Kontaktgruppen aus der 
Konfigdatei hostgroups.cfg in die Datei hosts.cfg kopiert werden muessen. Es ist somit nicht global jeder Hostgruppe, 
sondern genau jedem Host eine Kontaktgruppe zugewiesen.
Das ist eine Arbeit die jeder der auf Nagios Version 2.x upgraden will (und somit auch den Nagios Manager nutzen kann) machen muss ;-(

Hier der Auszug aus der Doku zur Version Nagios 2.x wo diese Aenderung beschrieben ist:

Contact group changes - The contact_groups directive has been moved from hostgroup definitions to host definitions.
This was done in order to maintain consistency with the way service contacts are specified. Make sure to update your config files!



****   Ueberpruefung der Webserver Konfiguration

In der Nagios Manager Konfigurationsdatei (NagiosManager.cfg) muss der CGIPFAD richtig eingetragen sein,
damit man mit einem Webbrowser zugreifen kann. (zur NagiosManager.cfg spaeter mehr)
In der Apache Konfigdatei httpd.conf (bei Debian unter /etc/apache)
ist der ScriptAlias fuer Nagios zu suchen. Dieser ScriptAlias (hier: /nagios/cgi-bin/)
ist in der Datei NagiosManager.cfg unter CGIPFAD anzugeben. Die beiden Eintraege in der /var/www/httpd.conf
sehen bei mir (Default Debian und Nagios Installation)folgendermassen aus.
Man beachte, dass der Eintrag fuer den ScriptAlias vor dem Alias Eintrag stehen muss !
 

Eintrag in der /etc/apache/httpd.conf

<IfModule mod_alias.c>
#
ScriptAlias /nagios/cgi-bin/ /usr/local/nagios/sbin/
<Directory /usr/local/nagios/sbin/>
    AllowOverride AuthConfig
    Options ExecCGI FollowSymLinks
    Order allow,deny
    Allow from all
</Directory>
#
Alias /nagios/ /usr/local/nagios/share/
<Directory /usr/local/nagios/share>
    Options FollowSymLinks
    allowOverride AuthConfig
    Order allow,deny
    Allow from all
</Directory>
#
</IfModule>



-> FollowSymLinks wird benoetigt, da bei der Installation ein Link vom Script "nagiosgroupmanager.cgi" auf index.html gemacht wird !
 
Der zugehoerige Eintrag in der NagiosManager.cfg wuerde fuer dieses Beispiel lauten:
 
CGIPFAD=/nagios/cgi-bin/nagiosmanager

Wichtig ist, dass die Gruppe des Webservers mit dem in der /etc/group  und dem der NM Installation uebereinstimmt, 
da man sonst keine Rechte beim Zugriff auf den NM hat und ein "404 forbidden" erhaelt.

Beispiel:

/etc/apache/httpd.conf:
Group www-data

Der Gruppe "nagios" habe ich den Webuser "www-data" zugewiesen

/etc/group:
		www-data:x:33:
		nagios:x:1000:www-data

und die Dateien des NagiosManagers auch der Gruppe: www-data   angehoeren


****   Vieleicht noch die sudoers anpassen ???

Der Nagios Manager bietet die Moeglichkeit Nagios nach der Konfiguration per Webbrowser neu zu starten.
Dazu wird das Startscript /etc/init.d/nagios verwendet.
Damit die Ausfuehrung als Webuser moeglich ist habe ich sudoer installiert
Man muss dann noch die /etc/sudoers (mittels visudo) editieren.

Diese koennte dann ungefaehr so aussehen:

/etc/sudoers:

# This file MUST be edited with the 'visudo' command as root.
#
# See the man page for details on how to write a sudoers file.
#
# User alias specification
User_Alias      NMUSER=www-data

Runas_Alias     OP = root

# Cmnd alias specification
Cmnd_Alias      NMS = /etc/init.d/nagios

Defaults:www-data       !authenticate

# User privilege specification
root            ALL=(ALL) ALL
NMUSER        ALL = (ALL) NOPASSWD: NMS




Wer ohne sudoers arbeiten moechte, muss dann Nagios doch noch per Commandline neu starten ;-(



****   Beschreibung der Nagios Manager Installation

als user root anmelden

Die Software vom Server www.nagiosmanager.de besorgen und das tgz-File am Besten in ein freies Verzeichnis legen

anschliessend das File entpacken:
# tar -xzf NM-Installscripte-1.1-0.tgz
und ins Verzeichnis INSTALL wechseln

das Nagios Manager Konfigurationsfile "NagiosManager.cfg" an seine Nagios Installation anpassen
-> das mitgelieferte Konfigfile wurde auf einem Debian Server mit Standard Nagios Installation angepasst
Die Kommentarzeilen im Konfigfile sollten verstaendlich sein; wennn nicht -> Newsgroup  
# vi NagiosManager.cfg       und Pfade anpassen

Nagios Manager Installation starten
# sh install_NM.sh

Es sollten nun alle Scripte und Konfigdateien an die richtige Stelle kopiert werden.
Bitte auf Meldungen achten ! und ggf. Fehler beseitigen.
Es ist ohne weiteres moeglich, das Installscript nach einer Aenderung mehrmals laufen zu lassen.




****   Zugriff auf den Nagios Manager mit einem Webbrowser
nun kann man mit einem Webbrowser auf den Nagios Manager zuzugreifen und mit der Konfiguration von Nagios zu beginnen 

http://<IP-Adresse-Server>/<CGIPFAD>/nagiosmanager/index.html

also z.B.: http://192.168.0.1/nagios/cgi-bin/nagiosmanager/index.html
oder, da ueber einen symbolischen Link verknuepft:
also z.B.: http://192.168.0.1/nagios/cgi-bin/nagiosmanager/nagiosgroupmanager.cgi

Viel Spass nun mit dem Nagios Manager und der Konfiguration von Nagios
wuenscht Euch Horst 

Ich wuerde mich freuen Euch mal in der Newsgroup unter www.nagiosmanager.de begruessen zu koennen !

Letzte Änderung des Artikels: 2007-03-04 15:40
Verfasser des Artikels: Alen
Revision: 1.0

Artikel ausdrucken Artikel ausdrucken

Bewertung der Nützlichkeit dieses Artikels:

Durchschnittliche Bewertung: 0 von 5 (0 Bewertungen)

vollkommen überflüssig 1 2 3 4 5 sehr wertvoll

Es ist möglich diesen Artikel kommentieren

Kommentar von Til (2008-04-23 10:00:37):
leider ist www.nagiosmanager.de down.

Kommentar von LJH (2009-07-09 11:04:07):
Include thereplica handbags five controlreplica watches elements whenDesigner clothing establishing and Designer replica handbagsimplementingWholesale jewelry effectiveReplica rolex watches internal replica handbagcontrol ? EstablishReplica Handbags and implement Replica Watchesinternal control replica designer handbagspolicies ? EstablishCoach Handbags a suitable Gucci Handbagsbusiness Rolex Watchesmanagementhair straighteners information technologyGHD system with embedded chi hair straightenerscontrols ? Set Ladies Shopclear policies Women Shopon the rewards replica handbagsandwholesale handbags disciplines related replica designer handbagsto the properGucci Handbags implementation replica prada handbagsof internal control.replica watch Effectiveness of swiss replica watchesinternal control replica rolex watchesimplementationwholesale omega watches shouldpuma shoes be treatednike shoes as a keywomens clothes element of performanceed hardy clothing appraisalsAdidas Shoes forlacoste Clothes department wholesale clothingand staff wholesale handbagslevels ? Perform ghd hair straightenersself-assessment ofghd straighteners the effectiveness of its internal control ghdon a periodic basis and issue control self-assessment reports

Kommentar von ljhha (2009-07-09 11:08:18):
Include thereplica handbags five controlreplica watches elements whenDesigner clothing establishing and Designer replica handbagsimplementingWholesale jewelry effectiveReplica rolex watches internal replica handbagcontrol ? EstablishReplica Handbags and implement Replica Watchesinternal control replica designer handbagspolicies ? EstablishCoach Handbags a suitable Gucci Handbagsbusiness Rolex Watchesmanagementhair straighteners information technologyGHD system with embedded chi hair straightenerscontrols ? Set Ladies Shopclear policies Women Shopon the rewards replica handbagsandwholesale handbags disciplines related replica designer handbagsto the properGucci Handbags implementation replica prada handbagsof internal control.replica watch Effectiveness of swiss replica watchesinternal control replica rolex watchesimplementationwholesale omega watches shouldpuma shoes be treatednike shoes as a keywomens clothes element of performanceed hardy clothing appraisalsAdidas Shoes forlacoste Clothes department wholesale clothingand staff wholesale handbagslevels ? Perform ghd hair straightenersself-assessment ofghd straighteners the effectiveness of its internal control ghdon a periodic basis and issue control self-assessment reports

Kommentar von SAS (2009-07-20 04:01:49):
MY wow power leveling BUY wow gold good wow power leveling buy wow gold my wow power leveling cheap wow gold cheap wow power leveling buy wow gold

Kommentar von asa (2010-01-30 12:22:01):
spiele online casino