hindab Risto Bristol

2011-12-12T18:51:30Z

Rbristol:

vana artikkel on teise nime all [[Nagios 3.2]]
Risto Bristol AK31

See artikkel on pooleli

=Nagios Core ja NRPE=
viimati muudetud 12.12.2011

==Autor==
Risto Bristol

==Varem samal teemal==
Kaks aastat tagasi kirjutas samal teemal referaadi Martin Kiigemaa. Tema töö asub siin [[Nagios 3.2]]. Soovitan sellega vähemalt põgusalt tutvuda, enne kui minu tööga edasi lähete.

==Sissejuhatus==
Nagios on serverite ja teiste võrguseadmete jälgimise tarkvara, mis saadab administraatoritele tõrgetest automaatteateid. Nagiosega saab jälgida teenuste olekut ja koormust (näiteks SSH, HTTP, sisselogitud kasutajate arv, ketta kasutus, CPU koormus, andmebaaside seisukord jne). Nagios kasutab pluginate ja lisade süsteemi, mis võimaldab vajadusel funktsioone juurde programmeerida. Vabalt saadavate lisade hulk on märkimisväärne. Kui mõnest võimalusest puudust tunnete, siis tasub sellekohast pluginat kõigepealt internetist otsida.

==Nagiose ajalugu==
1996 loob Ethan Galstad MS-DOS programmi Novell Netware serverite jälgimiseks. 
1998 alustab Galstad uue süsteemi loomist, mis töötab Linuxi peal. 
1999 avaldab ta Open Source projekti "NetSaint". 
2002 annab Galstad projektile uue nime "Nagios", et vältida võimalikke vaidlusi seoses kaubamärgiga. 
2007 loob Galstad ettevõtte Nagios Enterprises LLC, et pakkuda Nagiosega seotud konsultatsiooni ja spetsiaalseid arendusi. Vahepealsetel aastatel saadakse ka mitmeid auhindu ja järjepidevat tunnustust. 
2009 Nagios Enterprises annab välja esimese Nagiosel baseeruva tasulise toote. Hiljem samal aastal nimetatakse Nagios ümber Nagios Core-ks. 

Täpsem ajalugu http://www.nagios.org/about/history

==Versioonid==
Juhendi kirjutamisel on kasutatud versioone: 
Nagios Core 3.3.1 
Nagios Plugins 1.4.15 
NRPE 2.13 
Ubuntu Server 11.10 64bit 
Nagios Core muudatused http://www.nagios.org/projects/nagioscore/history/core-3x

==Ülesande püstitus==
Paigaldada Ubuntu serverisse Nagios Core monitooringu server ja jälgida teist Ubuntu serverit kasutades NRPE-d.

==Ülesande täitmise eeldused==
*Linux või Unix OS, millel on C kompilaatori tugi
*Juurkasutaja õigused serverites
*TCP/IP protokollide tugi – enamiku rakenduste kontroll käib läbi TCP/IP
*Veebiserver (soovituslik Apache)
*Thomas Boutell’s gd library versioon 1.6.3 või uuem, mis on vajalik „statusmap” ja „trends CGI” liideste tööks
*Algteadmised Linux-ist
*Oskus töötada käsurealt
*Installitud postfix

==Nagiose paigaldamine==
Paigaldamiseks proovisin kahte erinevat viisi:
*Apt-get
*Ise kompileeritud

Minu arvamuse kohaselt on "production" versiooniks mõistlik Nagios Core ise kokku kompileerida. Apt-iga paigaldatakse täna versioon 3.2.3-3. Lisaks installeerub Nagiose Core pakk soovituslikest erinevate seadistustega (näiteks installatsiooni kaustad, command grupp, kaustaõigused, teenuse nimi). Selleks, et uuendada tarkvara versioonile 3.3.1 tuleb muuta ./configure skripti parameetreid nii, et need vastaksid meie seadistustele. See osutub aga küllalt keeruliseks ja aeganõudvaks. Samuti tuleb ebastandardseid seadistusi arvestada pluginate ja lisade paigaldamisel. Nagios Core põhifunktsioonidega tutvumiseks sobib Apt-get paigaldus paremini, sest seda on mõnevõrra lihtsam ellu viia.

Hetkel jätkame ise kompileeritud versiooni paigaldamisega ja hiljem jõuame ka apt-get paigaldusjuhendini.

===Paigaldame Monitooringu serverisse Nagios Core ja Nagiose pluginad===
*Eeldused: töötav e-posti server, mis suudab kirju saata.
1. Siseneme monitooringu serverisse root kasutaja õigustega.
2. Paigaldame paketid apache2, build-essential, libapache2-mod-php5, libgd2-xpm-dev
<pre>
apt-get -y install apache2
apt-get -y install build-essential
apt-get -y install libapache2-mod-php5
apt-get -y install libgd2-xpm-dev
</pre>
3. Loome nagiose teenuse jaoks kasutaja ja määrame talle parooli.
<pre>
useradd -m -s /bin/bash nagios
passwd nagios
</pre>
4. Loome uue grupi, et veebiliidese kaudu saaks ka käsklusi saata.
<pre>
groupadd nagcmd
usermod -a -G nagcmd nagios
usermod -a -G nagcmd www-data
</pre>
5. Laeme alla Nagios Core 3.3.1 ja pakime lahti.
<pre>
wget http://prdownloads.sourceforge.net/sourceforge/nagios/nagios-3.3.1.tar.gz
tar xzf nagios-3.3.1.tar.gz
</pre>
6. Käivitame paigaldusskripti, nii et command group oleks varem loodud nagcmd.
<pre>
cd nagios
./configure --with-command-group=nagcmd
make all
make install
</pre>
*Võimalik, et make install lõppeb järgmiste vigadega (hetkel ignoreerime neid): make[1]: *** [install] Error 1
make: *** [install] Error 2 ...ja jätkame
<pre>
make install-init
make install-config
make install-commandmode
</pre>
7. Muudame konfiguratsiooni selliselt, et teated hakkaksid tulema soovitud aadressile.
<pre>
nano /usr/local/nagios/etc/objects/contacts.cfg
</pre>
*sisestame nagiosadmin kontakt-aadressiks oma e-posti aadressi, näiteks: username@localhost

8. Seadistame veebiserveri nii, et saaksime Nagiose veebiliidesele ligi. Teeme veebiliidese admin-kasutaja ja määrame talle parooli. Loeme veebiserveri konfiguratsioonifaili uuesti sisse.
<pre>
make install-webconf
htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
service apache2 reload
</pre>
9. Tõmbame ja paigaldame pluginad. Kõigepealt väljume kaustast "nagios"
<pre>
cd ..
wget http://prdownloads.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.15.tar.gz
tar xzf nagios-plugins-1.4.15.tar.gz
cd nagios-plugins-1.4.15/
./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
make install
</pre>
10. Testime konfiguratsioonifaili.
<pre>
/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
</pre>
*Võimalik, et saame sellise vea: Error in configuration file '/usr/local/nagios/etc/nagios.cfg' - Line 465 (Check result path is not a valid directory) Error processing main config file!
*Siit selgub, et millegipärast puuduvad kataloogis /usr/local/nagios/var/ kataloogid spool/checkresults
*Loome puuduvad kataloogid ja määrame omaniku ja grupi
<pre>
cd /usr/local/nagios/var/
mkdir -p spool/checkresults
chown -R nagiso:nagcmd spool
</pre>
11. Käivitame Nagiose ja muudame ta automaatselt käivitatavaks serveri startimisel.
<pre>
service nagios start
</pre>
* Võimalik, et saame järgmise vea: Starting nagios:touch: cannot touch `/usr/local/nagios/var/nagios.log': Permission denied touch: cannot touch `/usr/local/nagios/var/retention.dat': Permission denied done.
* Seega paneme õigused paika.
<pre>
cd /usr/local/
chown -R nagios:nagcmd nagios
</pre>
* ja jätkame sealt kus pooleli jäime.
<pre>
service nagios start
ln -s /etc/init.d/nagios /etc/rcS.d/S99nagios
</pre>
12. Avame veebiliidese http://localhost/nagios või http://"ip-aadress"/nagios ja sisestame kasutaja nagiosadmin ning vastava parooli. Proovime veebiliidese kaudu saata Nagiose poole mõne käsu.
*Kui me me saame järgmise veateate: Error: Could not stat() command file '/usr/local/nagios/var/rw/nagios.cmd'!
*Siis selle parandamiseks proovime järgmist:
<pre>
cd /usr/local/
chgrp -R nagcmd nagios
dpkg-statoverride --update --add nagios www-data 2710 /usr/local/nagios/var/rw
dpkg-statoverride --update --add nagios nagios 751 /usr/local/nagios
service nagios restart
</pre>

===Paigaldame jälgitavasse serverisse Nagiose pluginad ja NRPE===
Paigaldame jälgitavasse serverisse Nagiose pluginad ja NRPE teenuse.

1. Siseneme juurkasutaja õigustes. Loome nagiose jaoks kasutaja.
<pre>
useradd nagios
passwd nagios
</pre>
2. Kui kompileerimiseks vajalikud vidinad puuduvad, siis paigaldame need.
<pre>
apt-get -y install build-essential
apt-get -y install libapache2-mod-php5
apt-get -y install libgd2-xpm-dev
apt-get -y install libssl-dev
</pre>
3. Paigaldame Nagiose pluginad.
<pre>
cd
wget http://prdownloads.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.15.tar.gz
tar xzf nagios-plugins-1.4.15.tar.gz
cd nagios-plugins-1.4.15/
./configure
make
make install
</pre>
4. Paneme paika õigused.
<pre>
chown nagios:nagios /usr/local/nagios
chown -R nagios:nagios /usr/local/nagios/libexec
</pre>
5. Paigaldame xinetd (kui seda pole).
<pre>
apt-get install xinetd
</pre>
6. Paigaldame NRPE, ilma ssl toeta.
<pre>
cd
wget http://prdownloads.sourceforge.net/sourceforge/nagios/nrpe-2.13.tar.gz
tar xzf nrpe-2.13.tar.gz
cd nrpe-2.13/
./configure -disable-ssl
make
</pre>
7. Paigaldame NRPE plugina (testimiseks), daemoni ja konfiguratsioonifailide näidised ja muudame ta xinetd teenuseks.
<pre>
make install-plugin
make install-daemon
make install-daemon-config
make install-xinetd
</pre>
8. Lisame monitooringuserveri ip aadressi lubatud ip-de nimekirja.
<pre>
nano /etc/xinetd.d/nrpe
</pre>
*lisame reale:
<pre>
only_from = 127.0.0.1 <minu_monitooringuserveri_ip_address>
</pre>
9. Lisame NRPE teenuse services faili:
<pre>
nano /etc/services
</pre>
*Sisestame rea:
</pre>
nrpe 5666/tcp # NRPE
</pre>
10. Restardime xinetd teenuse.
<pre>
service xinetd stop
service xinetd start xinetd
</pre>
11. Kontrollime, kas daemon töötab xinetd all.
<pre>
netstat -at | grep nrpe
</pre>
*väljund peaks välja nägema umbes selline:
tcp 0 0 *:nrpe *:* LISTEN

12. Kontrollime, kas NRPE daemon töötab
<pre>
/usr/local/nagios/libexec/check_nrpe -H localhost
</pre>
*Kui töötab, siis peaks vastus olema selline:
NRPE v2.13

14. Lisame iptables-isse vastava rea, et NRPE daemon pääseks masinale ligi ja salvestame selle faili.
<pre>
iptables -A INPUT -p tcp -d 0/0 -s 0/0 --dport 5666 -j ACCEPT
iptables-save
</pre>

===Paigaldame monitooringu serverisse NRPE===
1. Sikutame NRPE alla ja paigaldame.
<pre>
cd
wget http://prdownloads.sourceforge.net/sourceforge/nagios/nrpe-2.13.tar.gz
tar xzf nrpe-2.13.tar.gz
cd nrpe-2.13/
./configure -disable-ssl
make all
make install-plugin
</pre>
2. Testime, kas saame monitooritava serveriga ühendust.
*aadress 192.168.0.1 asenda oma ip-ga.
<pre>
/usr/local/nagios/libexec/check_nrpe -H 192.168.0.1
</pre>
*Kui vastus on "NRPE v2.13", siis ühendus toimib.

3. NRPE plugina aktiveerimiseks muudame commands.cfg faili.
<pre>
nano /usr/local/nagios/etc/objects/commands.cfg
</pre>
*Lisame read:
<pre>
define command{
command_name check_nrpe
command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c $ARG1$
}
</pre>
4. Defineerime hosti ja teenused, mida jälgima hakkame.
*Selleks oleks mõistlik luua eraldi *.cfg fail
<pre>
touch /usr/local/nagios/etc/objects/meie_host.cfg
chown nagios:nagcmd /usr/local/nagios/etc/objects/meie_host.cfg
nano /usr/local/nagios/etc/objects/meie_host.cfg
</pre>
5. Lisame hosti defineerivad read:
<pre>
define host{
use linux-servers ; Kasutame vaikimisi paigaldatud template-i
host_name remotehost ; The name we're giving to this server
alias Fedora Core 6 ; A longer name for the server
address 192.168.0.1 ; IP address of the server
}
</pre>
6. Lisame uue hostgrupi:
<pre>
define hostgroup{
hostgroup_name linux-nrpe ; The name of the hostgroup
alias Linux Servers NRPE ; Long name of the group
members nagclient ; Comma separated list of hosts that belo$
}
</pre>
*NB! Kui me tahame lisada hosti juba olemasolevasse gruppi, näiteks linux-servers, siis me peame avama konf faili, kus antud grupp defineeritud on (linux-servers on meil localhost.cfg failis) ja lisame members reale oma hosti.
<pre>
members localhost, nagclient
</pre>
6. Lisame teenuseid defineerivad read:
*Tegemist on nö hard-coded näidetega, reaalses monitooringu masinas tahame me tõenäoliselt kasutada täiendavaid ja spetsiaalselt meie nõuetele vastavaid teenuseid.
<pre>
define service{
use generic-service
host_name remotehost
service_description CPU Load
check_command check_nrpe!check_load
}

define service{
use generic-service
host_name remotehost
service_description Current Users
check_command check_nrpe!check_users
}

define service{
use generic-service
host_name remotehost
service_description Total Processes
check_command check_nrpe!check_total_procs
}

define service{
use generic-service
host_name remotehost
service_description Zombie Processes
check_command check_nrpe!check_zombie_procs
}
</pre>
*salvestame ja väljume failist

7. Kontrollime, kas konfiguratsioonifail sisaldab vigu. Kui vigu ei ilmnenud, siis loeme konfifailid uuesti sisse.
<pre>
/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
service nagios reload
</pre>

===NRPE pluginate häälestamine===
Tõenäoliselt soovime jälgida veel muidki teenuseid. Käesolev lõik annab põgusa ülevaate sellest, kuidas meile meelepäraseid pluginaid seadistada.

Uue teenuse jälgimiseks tuleb NRPE abil tuleb teha kahte asja:
*Lisa jälgitava masina nrpe.cfg faili uus command definition
*Lisa monitooringu serveri Nagiose konfiguratsioonifaili uus service definition

Näiteks swapi kasutuse jälgimiseks tuleb teha järgmised sammud.

====Jälgitava masina seadistus====
Seadista check_swap plugin
1. Logi masinasse kasutajaga "nagios"
2. Koosta proovipäring näiteks nii:
<pre>
/usr/local/nagios/libexec/check_swap -w 20% -c 10%
</pre>
*Selle näite järgi lülitab plugin sisse hoiatuse kui swap-is on vaba ruumi vähem kui 20% ja annab kriitilise hoiatuse kui ruumi on vähem kui 10%.
3. Lisame command-i nrpe.cfg faili

2011-11-05T11:05:30Z

Rbristol: moved Nagios to Nagios 3.2

=Nagios=

==Versioonide ajalugu (viimase muutmise aeg)==
Versioon 1.0 (Valmis) 15.12.2009 
Versioon 0.9 (Poolik) 14.12.2009 
Versioon 0.8 (Poolik) 08.12.2009 
Versioon 0.7 (Poolik) 07.12.2009 

==Autor==
Martin Kiigemaa

==Sissejuhatus==
Mis on Nagios? Nagios on vabavara, mis võimaldab jälgida teenuste ning serverite kättesaadavust. Toetab mitmesuguseid levinud teenuseid (SMTP, IMAP, HTTP, FTP, DNS) ning võimaldab seirata ka serveri "sisemist" infot, nagu koormus, kettamaht, protsesside arv jms) ja saata välja teavitusi süsteemide probleemide korral. Nagios kasutab plug-ine, see tähendab, et kui mõnel teenusel ei ole veel niinimetatud Nagios'e tuge, siis võib vastava plug-ini ise kirjutada.

==Legend==
Installeerida monitoorimistarkvara Nagios ja panna ta ühte hosti jälgima (vabalt valitud teenustega). Kui teenus peaks mingil põhjusel maha kukkuma, siis saadab Nagios lokaalse masina kasutajale e-maili.

==Nõuded==
*Õigus olemas olevasse Linux masinasse uut tarkvara installeerida
*Linux või Unix OS, millel on C kompilaatori tugi.
*TCP/IP protokollide tugi – enamiku rakenduste kontroll käib läbi TCP/IP
*Veebiserver (soovituslik Apache)
*Thomas Boutell’s gd library versioon 1.6.3 või uuem, mis on vajalik „statusmap” ja „trends CGI” liideste tööks.
*Oskus töötada käsurealt
*Teadmisi Linux operatsiooni süsteemist
*Installitud postfix
==Installeerimine==
1. Logige serverisse oma kasutaja nime ja parooliga 
2. Installeerige paketid apache2, build-essential, libapache2-mod-php5, libgd2-xpm-dev
<pre>
sudo apt-get -y install apache2
sudo apt-get -y install build-essential
sudo apt-get -y install libapache2-mod-php5
sudo apt-get -y install libgd2-xpm-dev
</pre>
3. Minge oma kasutajaga root õigustesse
<pre>
sudo -i
</pre>
4. Loo uus nagios kasutaja ja ka nagios grupp (Ubuntu serveri kasutamisel)
<pre>
/usr/sbin/useradd -m -s /bin/bash nagios
passwd nagios
/usr/sbin/groupadd nagios
/usr/sbin/usermod -G nagios nagios
</pre>
5. Loo uus grupp nimega nagcmd, tänu millele saadetakse serverile käsklusi läbi veebiliidese. Lisa gruppi nagios kasutaja ja apache kasutaja
<pre>
/usr/sbin/groupadd nagcmd
/usr/sbin/usermod -a -G nagcmd nagios
/usr/sbin/usermod -a -G nagcmd www-data
</pre>
6. Loo kataloog nagiose installeri ja nagios-plugin-ide hoidmiseks
<pre>
mkdir ~/downloads
cd ~/downloads
</pre>
7. Tõmba alla nagios ja tema plugin-id (Kirjutamise hetkel uusim versioon: Nagios 3.2.0 ja pluginnid: Nagios plugins 1.4.14)
<pre>
wget http://prdownloads.sourceforge.net/sourceforge/nagios/nagios-3.2.0.tar.gz
wget http://prdownloads.sourceforge.net/sourceforge/nagiosplug/nagios-plugins-1.4.14.tar.gz
</pre>
8. Paki nagiose installer lahti ja mine lahti pakitud kataloogi
<pre>
tar xzf nagios-3.2.0.tar.gz
cd nagios-3.2.0
</pre>
9. Pane käima Nagiose konfigureerimise script, andes talle ette grupi nime, mille varem lõid
<pre>
./configure --with-command-group=nagcmd
</pre>
10. Kompileeri Nagiose lähtekood ja installeeri käima mineku failid
<pre>
make all
make install
make install-init
make install-config
make install-commandmode
</pre>
11. Muuda konfiguratsiooni selliselt, et emailid hakkasid tulema Sinu aadressile
Selleks ava kontaktide konfiguratsiooni fail
<pre>nano /usr/local/nagios/etc/objects/contacts.cfg</pre>
ja muuda nagiosadmin kontakti e-mail aadress ära. Näiteks: '''username@localhost'''

12. Loodetavasti oled ikka veel nagios-3.2.0 kataloogis. Sisesta käsk, et siduda nagios apachega.
<pre>
make install-webconf
</pre>
13. Loo nagiosadmin kasutaja, et saaksid sisse logida veebiliiidesesse
<pre>
htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin
</pre>
14. Restardi apache
<pre>
/etc/init.d/apache2 restart
</pre>
15. Liigu tagasi downloads kataloogi
<pre>cd ~/downloads</pre>
16. Paki lahti Nagiose plugin-id ja liigu loodud kataloogi
<pre>
tar xzf nagios-plugins-1.4.14.tar.gz
cd nagios-plugins-1.4.14
</pre>
17. Sisesta kataloogis kompileerimise ja installmise käsk
<pre>
./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
make install
</pre>
18. Konfigureeri Nagios koos süsteemiga automaatselt käivituma
<pre>
ln -s /etc/init.d/nagios /etc/rcS.d/S99nagios
</pre>
19. Kontrolli oma algne Nagiose konfiguratsiooni faili, et seal ei sisalduks erroreid
<pre>
/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
</pre>
20. Kui errorid puudusid, siis käivita Nagios
<pre>
/etc/init.d/nagios start
</pre>
21. Logi sisse Nagiose veebiliidesesse, kasutades kasutajat kelle varem lõid (nagiosadmin)
<pre>
links http://localhost/nagios
</pre>

==Seadistamine vastavalt ülesande püstitusele==
'''Esmalt vaatame üle Nagiose põhikonfiguratsiooni faili.''' 
Jälgi, et seal olev kood oleks selline ja need read ei oleks välja kommenteeritud. '''Märkus:''' Antud näites olev viimane rida tuleb ise faili lisada, et Nagios monitooriks ka meie poolt kirjeldatud hosti.
<pre>
/usr/local/nagios/etc/nagios.cfg

# You can specify individual object config files as shown below:
cfg_file=/usr/local/nagios/etc/objects/commands.cfg
cfg_file=/usr/local/nagios/etc/objects/contacts.cfg
cfg_file=/usr/local/nagios/etc/objects/timeperiods.cfg
cfg_file=/usr/local/nagios/etc/objects/templates.cfg

# Definitions for monitoring the local (Linux) host
cfg_file=/usr/local/nagios/etc/objects/localhost.cfg

# Meie enda kirjutatud fail, mille tahame lisada Nagiose monitooringusse
cfg_file=/usr/local/nagios/etc/objects/meie_host.cfg
</pre>
Seda faili kasutab Nagios, et käima minemisel kontrollida, millised teised konfi failid endaga koos üles laadida.
Kui defineerid uue hosti, siis tuleks selle uue hosti konfiguratsiooni fail lisada samuti nagu viimasel real on näha. Nagu konfiguratsiooni failist näha on Nagiosel juba defaultis defineeritud üks host, milleks on '''localhost'''. 
'''Üle tuleks kontrollida kontakti failide andmed'''
<pre>
/usr/local/nagios/etc/objects/contacts.cfg

define contact{
contact_name root ; Short name of user
use generic-contact ; Inherit default values from generic-contact template (defined above)
alias root ; Full name of user
email --username--@localhost ; <<***** CHANGE THIS TO YOUR EMAIL ADDRESS ******
}
define contactgroup{
contactgroup_name admins
alias Nagios Administrators
members root
}
</pre>
Sellistele kontaktidele üritab Nagios e-maili saata, kui mõni tema kontrollitav teenus maha kukub. 
Nagu näha, siis asub kontakt nimega ''root'' grupis ''generic-contact''. Kõik sellised grupid on defineeritud failis '''''/usr/local/nagios/etc/objects/templates.cfg''''', kus kirjeldatakse Nagiosele, millisel kella ajal millise grupiga ühendust võtta ja millistel tingimustel. Näiteks kas võtta ühendust vaid siis kui terve '''''host''''' on maas või ainult siis kui kindel '''''service''''' on maas. 
'''Viimaseks peab looma meie defineeritud hosti konfiguratsiooni faili ''' 
Selles failis kirjeldame
*masina nime
*millisesse gruppi ta kuulub
*mis teenuseid peaks Nagios selle masina peal jälgima 
'''Loo uus fail nimega meie_host.cfg'''
<pre>
touch /usr/local/nagios/etc/objects/meie_host.cfg
</pre>
Järgnevad read tuleb kirjutada just loodud konfi faili sisse. 
Defineerime ühe uue linuxi hosti.
<pre>
define host{
use linux-server ; Name of host template to use
host_name Meie_host
alias Meie host
address IP-AADRESS
}
</pre>
Samasse faili defineerime talle service'd mida Nagios kontrollib
<pre>
define service{
use local-service ; Name of service template to use
host_name Meie_host
service_description PING
check_command check_ping!100.0,20%!500.0,60%
}
define service{
use local-service ; Name of service template to use
host_name Meie_host
service_description SSH
check_command check_ssh
notifications_enabled 1
}
define service{
use local-service ; Name of service template to use
host_name Meie_host
service_description HTTP
check_command check_http
notifications_enabled 1
}
</pre>
Fail tuleks nüüd salvestada. 
Lisame uue masina ka linux-servers hostgruppi, mida saab teha localhost.cfg failis define hostgroup sektsioonis, mis peale muutmist peab välja nägema selline
<pre>
/usr/local/nagios/etc/objects/localhost.cfg

define hostgroup{
hostgroup_name linux-servers ; The name of the hostgroup
alias Linux Servers ; Long name of the group
members localhost, Meie_host ; Comma separated list of hosts that belong to this group
}
</pre>
Kui tahaksime lisada ta mõnda uue hostgruppi, siis peaksime selle grupi defineerima samamoodi selle masina enda konfiguratsiooni failis. 
Kontrollime, kas nagiose konfiguratsiooni fail vastab nõuetele
<pre>
/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
</pre>
Kui errorid puudusid, siis nüüd oleme valmis Nagiosele restart tegema
<pre>
/etc/init.d/nagios restart
</pre>
Peale restarti ava veebilehitseja aadressiga [http://localhost/nagios[http://localhost/nagios]] ja logi sisse varem loodud kasutajaga '''nagiosadmin'''

==Testimine==
Peale teenuse käima panemist on viisakas tava seda testida. 
Selleks peatame näiteks SSH teenuse
<pre>
/etc/init.d/ssh stop
</pre>
Ja jääme ootama vastava sisulist e-maili, et teenus on maas. 
Vastavalt ''templates.cfg'' failis defineeritud väärtustele käib kindla intervalli tagant Nagios hosti kontrollimas, seega emaili tulekuni võib alg seadetega aega minna. Mõistlik on jälgida, mis toimub logifailis hetkel kui Nagios avastab, et mingi service on maha käinud. Et logi faili reaalajas jälgida sisesta käsk
<pre>
tail -f /usr/local/nagios/var/nagios.log
</pre>
==Probleemid==
E-mail ei saabu, kui teenus maha kukub:
*Kontrolli, kas contacts.cfg faili sai õige e-maili aadress
*Kontrolli, kas host on seadistatud saatma e-maile selle teenuse maha kukkumisel
*Kontrolli, mis toimub nagios.log logi failis (Kas seal on kirjeldatud teenuse maha kukkumine ja NOTIFICATION-i saatmine kasutajale)
*Vaata templates.cfg faili, et veenduda e-maili saatmise aegasi ja intervalle.
*Kontrolli, et oleks installitud postfix ja see ka töötaks
*Kontrolli, et /usr/local/nagios/etc/objects/commands.cfg failis oleks määratud õige käsk maili saatmiseks (Ubuntu puhul peaks seal olema /usr/bin/mailx)

==Teenuse varundamine==
Kogu Nagiose konfiguratsioon defineeritakse kataloogis <pre>/usr/local/nagios/etc</pre>

'''Konfiguratsiooni failide ülevaade:''' 
Põhi konfiguratsiooni fail: <pre>/usr/local/nagios/etc/nagios.cfg</pre>
Süsteemsete seadete konfiguratsiooni fail: <pre>/usr/local/nagios/etc/cgi.cfg</pre>

Teenuste ja hostide konfiguratsiooni failid asuvad kataloogis: <pre>/usr/local/nagios/etc/objects/</pre>

Defineeritud käskude konfiguratsiooni failid: <pre>/usr/local/nagios/etc/objects/commands.cfg</pre>

Defineeritud kontaktid, kellega ühendust võetakse: <pre>/usr/local/nagios/etc/objects/contacts.cfg</pre>

Vaikimisi installimisel defineeritud host: <pre>/usr/local/nagios/etc/objects/localhost.cfg</pre>

Erinevate host-ide ja service-ite mallid asuvad: <pre>/usr/local/nagios/etc/objects/templates.cfg</pre>
Defineeritud ajaperioodid: <pre>/usr/local/nagios/etc/objects/timeperiods.cfg</pre>

Ning veel failid: printer.cfg, switch.cfg, windows.cfg - mis on algselt põhi konfiguratsiooni failist välja kommenteeritud. 

Seega teenuse varundamiseks oleks vajalik sisestada käsud:
<pre>cp -R /usr/local/nagios/etc /backup_meedia/nagios</pre>

Sellega kindlustad, et kopeeritakse /etc kataloogis asuvad konfiguratsiooni failid ja seal asuv /objects kataloog

Igal ööl võiks käia backup ka Nagiose logi failist, mis asub: <pre>/usr/local/nagios/var/nagios.log</pre>

==Teenuse taastamine==
Kui mingil põhjusel on teenus katki läinud ja konfiguratsiooni failid viga saanud, siis tuleb varem taastatud backup meedialt konfiguratsiooni failid taastada /usr/local/nagios/etc kataloogi.
Kui varundasid oma faile täpselt nii nagu eelmises punktis kirjas, siis taastamiseks sisesta käsk:
<pre>
cp -R /backup_meedia/nagios /usr/local/nagios/etc
</pre>
Peale konfiguratsiooni failide taastamist tuleks teha teenusele reload.
<pre>
/etc/init.d/nagios reload
</pre>
[[Category:IT infrastruktuuri teenused]]