OpenNMS installeerimine Debianile
Sissejuhatus
Klaid Mägi AK21 10.11.2011
Antud juhend on abiks OpenNMS installerimisel kui teil on elementaarsed algteadmised Linux/Unix operatsioonisüsteemide administreerimisest. Samuti on eelduseks toimiva Debiani või Ubuntu operatsioonisüsteemiga server.
Ülevaade
Antud juhend on õpetus vabavaralise OpneNMS-i (NMS - network monitoring system ehk võrgu jälgimise süsteem) installeermiseks Debianile ja Debiani kasutatavatele süsteemidele nagu näiteks Ubuntu.
Kindlasti on võimalik paigaldada OpenNMS ka ilma alloleva juhiseta kuid kindlasti leiab siit lihtsustavaid näiteid.
APT baasil installeerimine
Debiani põhised distributsioonid kasutavad Advanced Package Manager ehk APT, et hallata, konfigureerida ja installeerida tarkvara pakke.Kuigi on võimalik ka lihtsalt paigaldada .deb pakette ning süsteem võib isegi normaalselt töötada, on soovitatav siiski lisada OpenNMS permanentselt oma süsteemi kas või selleks et hilisemalt viia läbi kergemalt tarkvara uuendusi.
Valides APT allikat
Debiani süsteemi kasutaja saab valida kas installeerida stabiilne või ebastabiilne versioon OpenNMSi.
Kui sa kasutad OpenNMSi igapäevaselt on soovitatav kasutada stabiilset versiooni.
Ebastabiilset versioon võib anda sulle küll palju lisa featuure võrreldes stabiilsega kuid see võib ka sisaldada vigu mis pole veel avastatud ja parandatud.
Installeerides stabiilset versiooni
Otsustades kasutada stabiilset versiooni pead sa looma kataloogi /etc/apt/sources.list.d faili nimega opennms.list järgmise sisuga:
deb http://debian.opennms.org stable main deb-src http://debian.opennms.org stable main
Installeerides ebastabiilset versiooni
Installeerides ebastabiilset versiooni peate looma sama faili samasse kohta järgmise sisuga:
deb http://debian.opennms.org unstable main deb-src http://debian.opennms.org unstable main
Lisame OpenNMS PGP võtme APT-le
Paketid APT süsteemis on krüptograafiliselt signeeritud, et tagada nende terviklikust. See tagab terviklikuse failile mille oled alla laadinud ja samuti tõestab, et see fail on ikka toodetud õigel eesmärgil. See iseärasus on kasulik nii installeerimise ajal kui ka tulevkus kui on vaja tarkavara uuendada
Installeerides OpenNMS PGP võtit oma süsteemi kirjutage käsureale järgmine käsk:
wget -O - http://debian.opennms.org/OPENNMS-GPG-KEY | sudo apt-key add -
The OpenNMS Signing Key
Deb paketid ja RPM/YUM pakateid on sigenritud sama GPG võtmega. Selle võtme näpujälg on 22EE DDA6 8698 B02F B2EC 50B7 062B 8A68 4C4C BBD9, ja seda võib lisada tuntud avalikest võtme serveritest.
Nüüd kui võti on lisatud võid sa värskendada oma süsteemi paketti:
sudo apt-get update
Installeerime OpenNMS paketid
Debian 4.0 (Etch) ja Ubuntu 7.10 (Gutsy) või uuematele süsteemidele
OpenNMS ja selle komponendid saame installeerida Etch ja Gutsy'le järgmise käsuga:
apt-get install opennms
Ubuntu 10.04 süsteemis võib olla vajalik eelnevalt konfigureerida Postfix MTA ning mõned muud eeldused. OpenNMS on võimeline saatma e-kirju kui aplikatsioon on konfigureeritud nii tegema ning loomulikult kui on häälestatud mingi meili server.
Installatsiooni käigus võib olla vajadust aksepterida Sun Java litsentsi tingimused (DLJ). Mitte neid tingimusi aksepteerides võib installeerimine ebaõnnestuda kuna OpenNMS vajab töötamiseks Javat.
Kui PostgreSQL ei ole eelnevalt installeeritud apt-get install käsuga millest OpenNMS sõltub võid sa näha hoiatust, et IPLIKE installeerimine ebaõnnestus. Kuidas IPLIKE ilusti käima saada vaatame hiljem.
Süsteemidele mis on vanemad kui Debian 4.0 ja Ubuntu 7.10
Installeerides OpenNMSi süsteemidele mis on vanemad kui Etch ja Gutsy läheb vaja mõningaid lisa samme installeerimisks töötav JDK. Kui sa oled võimeline seda tegema siis ei tohiks olla enam ühtegi põhjust miks sul peaks ebaõnnestuma OpenNMS installeerimine. Kuid võimalik et teil oleks mugavam ja lihtsam kasutatada süsteeme kus on juba töötav JDK.
Seadistame PostgreSQL OpenNMS jaoks
Süsteemi ja deemoni seadistamine
Vaikimisi on OpenNMS vaja ühenduda PostgreSQL serveriga. Lihtsam on kindlasti kasutada süsteemi kus postgres kasutaja ei pea kasutama parooli kui see ei ole soovitatav ning eriti ei ole see sovtatav süsteemis kus on mitmeid meili kasutajaid.
Lubades postgres kasutajal audentida ilma paroolita sa pead esmalt seadeid pg_hba.conf failis. Paljudes süstemides asub see fail /etc/postgresql/VERSIONNUMBER/main Kus "VERSIONNUMBER" on sinu PostgreSQL andmebaasi versiooni number.
Vaikimis on pg_hba.conf failis seadistamise väljad nagu alltoodud täites:
# TYPE DATABASE USER CIDR-ADDRESS METHOD # "local" is for Unix domain socket connections only local all all ident # IPv4 local connections: host all all 127.0.0.1/32 md5 # IPv6 local connections: host all all ::1/128 md5
Et aktiveerida parooli küsimine sa pead muutma järgmiseid ridu
# TYPE DATABASE USER CIDR-ADDRESS METHOD # "local" is for Unix domain socket connections only local all all trust # IPv4 local connections: host all all 127.0.0.1/32 trust # IPv6 local connections: host all all ::1/128 trust
pg_hba.conf fail ainult kontrollib audentimis meetodit ühendumise hetkel. PostgreSQL kuulajad asuvad postgresql.conf failis. Kui sa saad veateateid , et sa ei saa oma PostgreSQL andmebaasi, pead sa muutma listen_addresses direktiive selles failis postgresql.conf fail peaks asuma selles samas kataloogis kus pg_hba.conf.
Julgeoleku mõju
Eelpool kirjeldatud muudatused vaikeväärtuses PostgreSQL seadistamiseks annab lihtsa eelduse OpenNMS installimise sinu serverile kuid see annab ka kõigile lokaalsetele kasutajatele täis ligipääs andmebaasile. Kuna see on kiir juhend siis eeldatakse limiteeritud kasutajate hulka serveris. Kui see nii ei ole siis peaksite vaatama eraldi juhendit mis moodi PostgreSQL's luua rangemaid ligipääsusid.
Lisaks soovite olla kindel maksimaalsete üheaegsete kasutajate arvus. c3p0.maxPoolSize in $OPENNMS_HOME/etc/c3p0.properties (50 by default) +10.
max_connections = 60
PostgreSQL vaikeväärtuse seadistamine
PostgreSQL'l on palju väärtusi juba paigas kuid nii mõnedki tuleb käsitsi paika panna parema jõudluse nimel. Muutes mõningaid parameetreid võite te avastada, et PostgreSQL ei käivitu kuna soovitud PostgreSQL paramteetrid vajavad ka süsteemse kerneli parameetrite muutmist. PostgreSQL Performance Tuning juhend wikis aitab teil neid teha.
Kui olete veendunud, et kõik teie PostgreSQL seadistused on tehtud on vaja taaskäivitada deemon, et muudatused rakenduskid.
Esiteks leidke PostgreSQL teenuse nimi:
service --status-all | grep postgres
Ubuntu 10.04 server peaks näitama tulemuseks postgresql-8.4.
Seejärel taaskäivitage PostgreSQL listener kasutades teenuse nime:
sudo service postgresql-8.4 restart
OpenNMS andmebaasi ettevalmistus
Järgmine samm on luua OpenNMS-i andmebaas
user@ubuntu-server:~$ sudo -u postgres createdb -U postgres -E UNICODE opennms
Siinkohal saate te kontrollida võrgu kuulajat audentimise muudatusi samuti seda kas teie andmebaas loomine õnnestus või ei.
psql -U postgres --host=localhost opennms
Kui teile tuleb ette promt kujul opennms=# siis võite te kirjutada sinna \q, et väljuda psql shellist mis oli edukas. Kui seda promti ei ilmunud peate te üle vaatama oma PostgreSQL seadistused.
IPLIKE Installeerimine
IPLIKE on PostgreSQLi salvestatud moodul kiireks protsesside tööteliseks mis kirjeldab IP aadresse või aadressi ruume.
IPLIKE installeerimiseks käivitage:
sudo -u postgres install_iplike.sh
OpenNMS Installeerimine
Java keskonna seadistamie
OpenNMS'l on vaja teada millist JDK kasutada. Et kasutada parimat JRE käivitage:
sudo /usr/share/opennms/bin/runjava -s
Et täpsustada JRE võite käivitada:
sudo /usr/share/opennms/bin/runjava -S /usr/java/jdk1.5.0_12/bin/java
Käivitades OpenNMS installikaid
Järgmiseks peate käivitama OpenNMS installeri, mis initsialiseerib OpenNMS andmebaasi ja teeb mõned muud vajalikud seadistused. Juhul kui tahate tarkvara uuendust teha siis peaksite selle sama käsu uuesti käivitama et veenduda et andmebaasi skeem ja teised asjad mida startimisel vajatakse oleksid piisavalt uued.
Käivitamaks installerit:
sudo /usr/share/opennms/bin/install -dis
See võtab mõniga aja olenevalt sinu serveri konfiguratsioonist.
Java Network unreachable
Kui te proovite installeerida OpenNMS'i Debian 6.0-e saate te PostgreSQL veateate: Network unreachable. Debian 6.0 Java aplikatsioon ei lubatud ühenduma 127.0.0.1. See on ainult lubatud ühenduma ::1. Selle vea kirjeldus on saadaval: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=560044
Starting OpenNMS
Nüüd kui OpenNMS on installeeeritud ja seadistatud saate te käivitada deemoni ja ligipääsu oma aplikatsioonile. Teenuse käivitamiseks:
sudo service opennms start
Et pöörduda oma OpenNMSi poole avage veebilehitseja ning pöörduge aadressile http://sinuhost:8980/opennms/, kus sinuhost asemele kirjutage nimi või ip aadress oma just installeeritud OpenNMS serverilt. Vaikeväärtusena on kasutajanimi ja parool üks ja see sama, seega kui teile tuleb ette audentimise aken, kirjutage admin kasutajanime kasti ja admin paroolin kasti ning vajutage Login nuppu.
Jälgi oma võrku
Kõigepealt OpenNMS tahab teada milliseid seadmeid te soovite jälgida. Rohkem informatsiooni selle kohta kuidas seadmeid jägimise alla panna kaasa arvatud kuidas IP aadresse süsteemi manuaalselt sisestada leiate te siit: http://www.opennms.org/wiki/Docu-overview#Discovery_.2F_Adding_Nodes
Seadmete jälgimiseks OpenNMS pingib läbi kogu ette antud IP aadressi vahemiku. Kui IP aadress mis pole eelnevalt OpenNMS-i sisestatud vastab siis OpenNMS skanneerib selle IP porte leidmaks avatud teenuseid, loob kirje andmebaasi ning hakkab monitoorima selle seadme liideseid ja teenuseid. Puhtalt installeeritud OpenNMS ei hakka võrgust enne midagi otsima kui ei ole ette antud võrke mida läbi skanneerida. Võrke saab ette anda logides OpenNMS-i veebiliidese kaudu administratori õigustes. Menüüs valida Admin menu ning Operation sektsioonis klikata 'Configure Discovery'.
Include Ranges alasse Home / Admin / Discovery / Modify Configuration lehel , vajutage 'Add New' nuppu. Avanevas aknas sisestage soovitava IP välja alguse ja lõpu aadress. Vajutage 'Add' nuppu ning hüpikaaken sulgub ja uus aadressi vahemik on nähtav Include Ranges sektsioonis. Vajutage 'Save and Restart Discovery' nuppu et salvestada oma muudatused. Uue välja skanneerimine algab mõne sekundi jooksul; hostide pingimine ja teenuste skanneerimine toimub erinevatel aegadel et mitte üle ujutada sinu võrku liigse liiklusega, seega see võib võtta aega, et läbi skanneerida kõik aadresid.
Alarmid kui probleem tekib
Alustamiseks on meil vaja seadistada admin kasutajale toimib emaili aadress:
Logi adminnina veebiliidese kaudu OpenNMS-i Vali menüü realt Admin Operation sektsioonis muuda Notification Status väli ON asendisse ja vajuta Update nuppu. OpenNMS System sektsioonis mine Configure Users, Groups and Roles ja siis Configure Users Vajuta "Modify" ikooni admin kasutaja ees sisesta emaili aadress ning vajuta Finish nuppu.
See peaks tagama, et OpenNMS saadab teavitusi adminni emaili aadressile.
Teavitsute osa on väga paindlik ja võimaldab seadistada paljusi erinevaid parameetreid nagu ajalised teavitused grupi teavitused jne jne. Detailsed juhised leiad http://www.opennms.org/wiki/Configuring_notifications
