Ero sivun ”Observium” versioiden välillä
(46 välissä olevaa versiota samalta käyttäjältä ei näytetä) | |||
Rivi 1: | Rivi 1: | ||
+ | <languages/> | ||
+ | <translate> | ||
+ | |||
+ | <!--T:1--> | ||
Observium on ilmainen valvontaohjelma. Ohjelmalla voi valvoa palvelimia ja verkkolaitteita. Palvelimen tai verkkolaitteen vikaantuessa observium lähettää käyttäjälle sähköpostiviestin. | Observium on ilmainen valvontaohjelma. Ohjelmalla voi valvoa palvelimia ja verkkolaitteita. Palvelimen tai verkkolaitteen vikaantuessa observium lähettää käyttäjälle sähköpostiviestin. | ||
− | == Asentaminen == | + | == Asentaminen ja konfigurointi == <!--T:2--> |
+ | <!--T:3--> | ||
Asenna seuraavat paketit pakettihallinnasta | Asenna seuraavat paketit pakettihallinnasta | ||
− | apt-get install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-mcrypt php5-json php-pear snmp fping mysql-server mysql-client python-mysqldb rrdtool subversion whois mtr-tiny ipmitool graphviz imagemagick | + | <!--T:4--> |
+ | apt-get install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-mcrypt php5-json php-pear snmp fping mysql-server mysql-client python-mysqldb rrdtool subversion whois mtr-tiny ipmitool graphviz imagemagick | ||
+ | |||
+ | Ubuntu 16.04 | ||
+ | |||
+ | <pre> | ||
+ | apt-get install libapache2-mod-php7.0 php7.0-cli php7.0-mysql php7.0-mysqli php7.0-gd php7.0-mcrypt php7.0-json \ | ||
+ | php-pear snmp fping mysql-server mysql-client python-mysqldb rrdtool subversion whois mtr-tiny ipmitool \ | ||
+ | graphviz imagemagick apache2 | ||
+ | </pre> | ||
+ | <!--T:5--> | ||
Luo hakemisto Observium:ille ja siirrytään siihen | Luo hakemisto Observium:ille ja siirrytään siihen | ||
− | mkdir -p /opt/observium && cd /opt | + | <!--T:6--> |
+ | mkdir -p /opt/observium && cd /opt | ||
+ | <!--T:7--> | ||
Ladataan Observium free editon | Ladataan Observium free editon | ||
− | wget http://www.observium.org/observium-community-latest.tar.gz | + | <!--T:8--> |
+ | wget http://www.observium.org/observium-community-latest.tar.gz | ||
+ | <!--T:9--> | ||
Puretaan tar paketti | Puretaan tar paketti | ||
− | tar zxvf observium-community-latest.tar.gz | + | <!--T:10--> |
+ | tar zxvf observium-community-latest.tar.gz | ||
+ | <!--T:11--> | ||
Siirrytään observium hakemistoon | Siirrytään observium hakemistoon | ||
− | cd observium | + | <!--T:12--> |
+ | cd observium | ||
+ | <!--T:13--> | ||
Kopioidaan default konfiguraatio tiedosto | Kopioidaan default konfiguraatio tiedosto | ||
− | cp config.php.default config.php | + | <!--T:14--> |
+ | cp config.php.default config.php | ||
+ | <!--T:15--> | ||
Kirjautu tietokantaan ja luo uusi tietokanta Observiumille | Kirjautu tietokantaan ja luo uusi tietokanta Observiumille | ||
− | mysql -u root -p | + | <!--T:16--> |
+ | mysql -u root -p | ||
<mysql root password> | <mysql root password> | ||
mysql> CREATE DATABASE observium DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; | mysql> CREATE DATABASE observium DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; | ||
Rivi 35: | Rivi 61: | ||
-> IDENTIFIED BY '<observium db password>'; | -> IDENTIFIED BY '<observium db password>'; | ||
+ | <!--T:17--> | ||
Avaa config.php tiedosto ja päivitä siihen tietokantasi tiedot. | Avaa config.php tiedosto ja päivitä siihen tietokantasi tiedot. | ||
− | // Database config | + | <!--T:18--> |
+ | // Database config | ||
$config['db_host'] = 'localhost'; | $config['db_host'] = 'localhost'; | ||
$config['db_user'] = 'observium'; | $config['db_user'] = 'observium'; | ||
Rivi 43: | Rivi 71: | ||
$config['db_name'] = 'observium'; | $config['db_name'] = 'observium'; | ||
+ | <!--T:19--> | ||
Aja seuraava komento. Tämä määrittää automaattisesti tietokantaasi taulut. | Aja seuraava komento. Tämä määrittää automaattisesti tietokantaasi taulut. | ||
− | php includes/update/update.php | + | <!--T:20--> |
+ | php includes/update/update.php | ||
+ | <!--T:21--> | ||
Luo hakemisto Observiumin lokille | Luo hakemisto Observiumin lokille | ||
− | mkdir logs | + | <!--T:22--> |
+ | mkdir logs | ||
+ | <!--T:23--> | ||
Avaa Apachen konfigurointi tiedosto | Avaa Apachen konfigurointi tiedosto | ||
− | nano /etc/apache2/sites-available/default | + | <!--T:24--> |
+ | nano /etc/apache2/sites-available/default | ||
+ | <!--T:25--> | ||
ja muuta se seuraavanlaiseksi | ja muuta se seuraavanlaiseksi | ||
− | <VirtualHost *:80> | + | <!--T:26--> |
+ | <VirtualHost *:80> | ||
ServerAdmin webmaster@localhost | ServerAdmin webmaster@localhost | ||
DocumentRoot /opt/observium/html | DocumentRoot /opt/observium/html | ||
Rivi 76: | Rivi 112: | ||
</VirtualHost> | </VirtualHost> | ||
+ | <!--T:27--> | ||
Ota käyttöön php mcrypt moduuli | Ota käyttöön php mcrypt moduuli | ||
− | php5enmod mcrypt | + | <!--T:28--> |
+ | php5enmod mcrypt | ||
+ | <!--T:29--> | ||
Ota käyttään Apachen moduuli mod_rewrite | Ota käyttään Apachen moduuli mod_rewrite | ||
− | a2enmod rewrite | + | <!--T:30--> |
+ | a2enmod rewrite | ||
apache2ctl restart | apache2ctl restart | ||
+ | <!--T:31--> | ||
Luo ensimmäinen käyttäjä Observiumiin. Käytetään tason 10., eli adminia. | Luo ensimmäinen käyttäjä Observiumiin. Käytetään tason 10., eli adminia. | ||
− | cd /opt/observium | + | <!--T:32--> |
+ | cd /opt/observium | ||
− | ./adduser.php <username> <password> <level> | + | <!--T:33--> |
+ | ./adduser.php <username> <password> <level> | ||
+ | <!--T:34--> | ||
Esimerkiksi | Esimerkiksi | ||
− | ./adduser.php admin passwd123 10 | + | <!--T:35--> |
+ | ./adduser.php admin passwd123 10 | ||
+ | <!--T:36--> | ||
Luo uusi tiedosto /etc/cron.d/observium ja lisää seuraavat rivit. Cron on ajastusta varten. | Luo uusi tiedosto /etc/cron.d/observium ja lisää seuraavat rivit. Cron on ajastusta varten. | ||
− | 33 */6 * * * root /opt/observium/discovery.php -h all >> /dev/null 2>&1 | + | <!--T:37--> |
+ | 33 */6 * * * root /opt/observium/discovery.php -h all >> /dev/null 2>&1 | ||
*/5 * * * * root /opt/observium/discovery.php -h new >> /dev/null 2>&1 | */5 * * * * root /opt/observium/discovery.php -h new >> /dev/null 2>&1 | ||
*/5 * * * * root /opt/observium/poller-wrapper.py 2 >> /dev/null 2>&1 | */5 * * * * root /opt/observium/poller-wrapper.py 2 >> /dev/null 2>&1 | ||
+ | <!--T:38--> | ||
Siirry nyt http://ip-osoite ja kirjaudu Observiumiin luomillasi käyttäjätunnuksillasi. | Siirry nyt http://ip-osoite ja kirjaudu Observiumiin luomillasi käyttäjätunnuksillasi. | ||
+ | |||
+ | |||
+ | == Lisäkonfiguraatiot == <!--T:39--> | ||
+ | |||
+ | <!--T:40--> | ||
+ | Nämä lisäkonfiguraatiot ovat vapaehtoisia. Kaikki lisäkonfiguraatiot tehdään observiumin konfigurointi tiedostoon /opt/observium/config.php | ||
+ | |||
+ | === Sähköpostilmoitukset === <!--T:41--> | ||
+ | |||
+ | <!--T:42--> | ||
+ | Tämä konfiguraatio sallii observiumin lähettävän sähköpostiin ilmoituksen palvelimesta. Muuta vain [email protected] sähköpostiosoitteeksi jonne tahdot ilmoitukset ja [email protected], domainisi josta lähetetään (esim. [email protected]). Sinulla tulee olla sähköpostipalvelin (esimerkiksi [[postfix]]) jolla lähetetään ilmoitukset sähköpostiisi. | ||
+ | |||
+ | <!--T:43--> | ||
+ | Tämä ei toimi uusimman Communityn kanssa! | ||
+ | |||
+ | <!--T:44--> | ||
+ | $config['poller-wrapper']['alerter'] = TRUE; | ||
+ | $config['alerts']['alerter']['default']['descr'] = "Observium Alert"; | ||
+ | $config['alerts']['alerter']['default']['type'] = "email"; | ||
+ | $config['alerts']['alerter']['default']['contact'] = "[email protected]"; | ||
+ | $config['alerts']['alerter']['default']['enable'] = TRUE; | ||
+ | $config['email_from'] = "[email protected]"; | ||
+ | $config['alerts']['alerter']['default']['enable'] = TRUE; | ||
+ | $config['alerts']['email']['enable'] = TRUE; | ||
+ | |||
+ | === Ilmoitusasetukset === <!--T:45--> | ||
+ | |||
+ | <!--T:46--> | ||
+ | Ilmoita jos portti on alhaalla. Oletuksena pois käytöstä. | ||
+ | |||
+ | <!--T:47--> | ||
+ | $config['alerts']['port']['ifdown'] = TRUE; | ||
+ | $config['alerts']['port']['ifdown_types'] = array('core', 'transit', 'peering'); | ||
+ | |||
+ | <!--T:48--> | ||
+ | Ilmoita kun kaista on tietyn rajan yli per portti. Esimerkissä 85% ylittävän rajan lähetetään ilmoitus. Oletuksena pois käytöstä. | ||
+ | |||
+ | <!--T:49--> | ||
+ | $config['alerts']['port_util_alert'] = TRUE; | ||
+ | $config['alerts']['port_util_perc'] = 85; | ||
+ | |||
+ | === Sovellukset === <!--T:50--> | ||
+ | |||
+ | <!--T:51--> | ||
+ | Ennen sovellusten käyttä, asenna [[Observium#Unix_Agent|Unix-Agent]] ensin ennen kuin alat käyttämään sovelluksia. Tätä tarvitaan suurimman osassa sovelluksista. | ||
+ | |||
+ | <!--T:52--> | ||
+ | Kaikki tuetut sovellukset löytyvät: https://www.observium.org/wiki/Applications | ||
+ | |||
+ | ==== Apache ==== <!--T:53--> | ||
+ | |||
+ | <!--T:54--> | ||
+ | * Vaatii Unix-Agent | ||
+ | |||
+ | <!--T:55--> | ||
+ | Ota käyttään mod_status | ||
+ | |||
+ | <!--T:56--> | ||
+ | a2enmod status | ||
+ | |||
+ | <!--T:57--> | ||
+ | Käynnistä Apache2 uudelleen | ||
+ | |||
+ | <!--T:58--> | ||
+ | service apache2 restart | ||
+ | |||
+ | <!--T:59--> | ||
+ | Avaa mod_status konfigurointi | ||
+ | |||
+ | <!--T:60--> | ||
+ | nano /etc/apache2/mod-available/status.conf | ||
+ | |||
+ | <!--T:61--> | ||
+ | Sen tulisi olla seuraavanlainen: | ||
+ | |||
+ | <!--T:62--> | ||
+ | <pre> | ||
+ | ExtendedStatus On | ||
+ | <Location /server-status> | ||
+ | SetHandler server-status | ||
+ | Order deny,allow | ||
+ | Deny from all | ||
+ | Allow from 127.0.0.1 ::1 | ||
+ | </Location> | ||
+ | </pre> | ||
+ | |||
+ | <!--T:63--> | ||
+ | Varmista että apache agent scripti on Unix agentin local hakemistossa. | ||
+ | |||
+ | ==== HDDTemp ==== <!--T:64--> | ||
+ | |||
+ | <!--T:65--> | ||
+ | * Vaatii Unix-Agent | ||
+ | * Vaatii hddtemp | ||
+ | * Vaatii netcat / netcat-traditional (Debian / Ubuntu) | ||
+ | |||
+ | <!--T:66--> | ||
+ | aptitude install hddtemp netcat-traditional | ||
+ | |||
+ | <!--T:67--> | ||
+ | Varmista että hddtemp agent scripti on Unix Agentin local hakemistossa. | ||
+ | |||
+ | ==== Mailgraph ==== <!--T:68--> | ||
+ | |||
+ | <!--T:69--> | ||
+ | * Vaatii Unix-Agent | ||
+ | * Vaatii rrdtool | ||
+ | * Vaatii mailgraph | ||
+ | |||
+ | <!--T:70--> | ||
+ | aptitude install rrdtool mailgraph | ||
+ | |||
+ | <!--T:71--> | ||
+ | Varmista että scriptiti ovat oikeassa sijainissa. Varmista että RRDPATH muuttuja on oikeassa hakemistossa. Debianissa tämä pitäisi olla oletuksena oikein. | ||
+ | |||
+ | ==== MySQL ==== <!--T:72--> | ||
+ | |||
+ | <!--T:73--> | ||
+ | * Vaatii Unix-Agent | ||
+ | * Vaatii php5-cli (php-cli) | ||
+ | * Vaatii php5-mysql (php-mysql) | ||
+ | |||
+ | <!--T:74--> | ||
+ | Kopioi mysql scripti Unix-Agent local hakemistoon. | ||
+ | |||
+ | <!--T:75--> | ||
+ | Debian järjestelmissä pitäisi tämän jälkeen toimia oikein. Muut järjestelmät: https://www.observium.org/wiki/Application/MySQL#Instructions | ||
+ | |||
+ | ==== Nginx ==== <!--T:76--> | ||
+ | |||
+ | <!--T:77--> | ||
+ | * Vaatii Unix-Agent | ||
+ | |||
+ | <!--T:78--> | ||
+ | Lisää seuraava konffi /etc/nginx/sites-enabled/default tiedostoon jos ei ole jo | ||
+ | |||
+ | <!--T:79--> | ||
+ | <pre> | ||
+ | location /nginx-status #Vaihda /status jos ei toimi { | ||
+ | stub_status on; | ||
+ | access_log off; | ||
+ | allow 127.0.0.1; | ||
+ | deny all; | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | <!--T:80--> | ||
+ | Käynnistä muutoksen jälkeen palvelu uudelleen | ||
+ | |||
+ | <!--T:81--> | ||
+ | Kopioi nginx scripti User Agent local hakemistoon. | ||
+ | |||
+ | <!--T:82--> | ||
+ | Tarkista että nginx-status toimii (muuta location jos tulee error 403): | ||
+ | |||
+ | <!--T:83--> | ||
+ | w3m http://localhost/nginx-status | ||
+ | |||
+ | <!--T:84--> | ||
+ | TAI | ||
+ | |||
+ | <!--T:85--> | ||
+ | w3m http://localhost/status | ||
+ | |||
+ | <!--T:86--> | ||
+ | Jos olet muuttanut location, muuta tämäkin nginx scripti tiedostoon. Jos localhost ei toimi käytä sen sijasta 127.0.0.1 IP-osoitetta. | ||
+ | |||
+ | [[Luokka:Linux|Observium]] | ||
+ | [[Luokka:RouterOS|Observium]] | ||
+ | |||
+ | === Unix Agent === <!--T:87--> | ||
+ | |||
+ | <!--T:88--> | ||
+ | Asenna xinetd | ||
+ | |||
+ | <!--T:89--> | ||
+ | sudo apt-get install xinetd | ||
+ | |||
+ | <!--T:90--> | ||
+ | Kopioi /opt/observium/scripts/observium_agent_xinetd tiedosto Observium palvelimesta Unix-Agent palvelimen polkuun /etc/xinetd.d/observium_agent_xinet. | ||
+ | |||
+ | <!--T:91--> | ||
+ | Kopioi lisäksi /opt/observium/scripts/observium_agent tiedosto Observium palvelimesta Unix-Agent palvelimen polkuun /usr/bin/observium_agent | ||
+ | |||
+ | <!--T:92--> | ||
+ | Käytä esimerkiksi SCP:tä. Aja tämä komento palvelimessa jossa on observium asennettu: | ||
+ | |||
+ | <!--T:93--> | ||
+ | scp /opt/observium/scripts/observium_agent_xinetd [email protected]:/etc/xinetd.d/observium_agent_xinetd | ||
+ | scp /opt/observium/scripts/observium_agent [email protected]:/usr/bin/observium_agent | ||
+ | |||
+ | <!--T:94--> | ||
+ | Luo seuraavat hakemistot | ||
+ | |||
+ | <!--T:95--> | ||
+ | mkdir /usr/lib/observium_agent | ||
+ | mkdir /usr/lib/observium_agent/local | ||
+ | |||
+ | <!--T:96--> | ||
+ | Avaa observium_agent_xinetd tiedosto | ||
+ | |||
+ | <!--T:97--> | ||
+ | nano /etc/xinetd.d/observium_agent_xinetd | ||
+ | |||
+ | <!--T:98--> | ||
+ | ja määritä IP-osoite mitä Unix-Agent kuuntelee. | ||
+ | |||
+ | <!--T:99--> | ||
+ | only_from = 10.6.10.100 127.0.0.1 ::1 | ||
+ | |||
+ | <!--T:100--> | ||
+ | Käynnistä palvelu uudelleen | ||
+ | |||
+ | <!--T:101--> | ||
+ | sudo service xinetd restart | ||
+ | |||
+ | <!--T:102--> | ||
+ | Lisää tämä /opt/observium/config tiedostoon ottaaksesi käyttöön Unix-agent modulen: | ||
+ | |||
+ | <!--T:103--> | ||
+ | $config['poller_modules']['unix-agent'] = 1; | ||
+ | |||
+ | <!--T:104--> | ||
+ | Määritä käyttöoikeudet | ||
+ | |||
+ | <!--T:105--> | ||
+ | chmod 744 /usr/bin/observium_agent | ||
+ | chmod 744 -R /usr/lib/observium_agent/local/ | ||
+ | |||
+ | <!--T:106--> | ||
+ | Testaa: | ||
+ | |||
+ | <!--T:107--> | ||
+ | Telnetillä: | ||
+ | |||
+ | <!--T:108--> | ||
+ | telnet YourUnixServer.YourDomain.com 36602 | ||
+ | |||
+ | <!--T:109--> | ||
+ | Tai suoraan päätelaitteelta. | ||
+ | |||
+ | <!--T:110--> | ||
+ | /usr/bin/observium_agent | ||
+ | |||
+ | <!--T:111--> | ||
+ | Kopioi koko /opt/observium/scripts/agent-local hakemiston sisältö /usr/lib/observium_agent/local/ hakemiston alle. | ||
+ | |||
+ | <!--T:112--> | ||
+ | scp /opt/observium/scripts/agent-local/* [email protected]:/usr/lib/observium_agent/local/ | ||
+ | |||
+ | === WMI === <!--T:113--> | ||
+ | |||
+ | <!--T:114--> | ||
+ | http://jira.observium.org/secure/attachment/11319/WMIPoller-011013-1429-4.pdf | ||
+ | |||
+ | http://techedemic.com/2014/09/17/installing-wmic-in-ubuntu-14-04-lts-64-bit/ | ||
+ | |||
+ | |||
+ | == Asiakaslaitteet (SNMP) == <!--T:115--> | ||
+ | |||
+ | <!--T:116--> | ||
+ | Kaikki tuetut laitteet löytyvät täältä: http://www.observium.org/wiki/Supported_Devices | ||
+ | |||
+ | <!--T:117--> | ||
+ | Varmista että palvelimesta pystyy muodostamaan yhteyden UDP:n portin 161 kautta päätelaitteeseen. | ||
+ | |||
+ | === Debian / Ubuntu === <!--T:118--> | ||
+ | |||
+ | <!--T:119--> | ||
+ | Lisää asiakaslaite nimipalveluun A record. | ||
+ | |||
+ | <!--T:120--> | ||
+ | Asenna smpd client pakettihallinnasta. | ||
+ | |||
+ | <!--T:121--> | ||
+ | aptitude install snmpd | ||
+ | |||
+ | <!--T:122--> | ||
+ | Avaa SNMP konfigurointi tiedosto | ||
+ | |||
+ | <!--T:123--> | ||
+ | nano /etc/snmpd.conf | ||
+ | |||
+ | <!--T:124--> | ||
+ | Poista risuaita riviltä 17 ja lisää risuaita riville 15. | ||
+ | |||
+ | <!--T:125--> | ||
+ | # Listen for connections from the local system only | ||
+ | #agentAddress udp:127.0.0.1:161 | ||
+ | # Listen for connections on all interfaces (both IPv4 *and* IPv6) | ||
+ | agentAddress udp:161,udp6:[::1]:161 | ||
+ | |||
+ | <!--T:126--> | ||
+ | Lisää risuaita riville 51 ja lisää rocommunity. Rocomminityyn (community = salasana) ja IP, jonka sallitaan hakevan tietoja. | ||
+ | |||
+ | <!--T:127--> | ||
+ | #rocommunity public default -V systemonly | ||
+ | rocommunity <community> <ip> | ||
+ | |||
+ | <!--T:128--> | ||
+ | Esimerkiksi | ||
+ | |||
+ | <!--T:129--> | ||
+ | rocommunity observium123 192.168.1.44 | ||
+ | |||
+ | <!--T:130--> | ||
+ | Lisää risuaita | ||
+ | |||
+ | <!--T:131--> | ||
+ | #rouser authOnlyUser | ||
+ | |||
+ | <!--T:132--> | ||
+ | Muuta syslocation (sijainti) ja sähköpostiosoite. Tähän sähköpostiosoitteeseen lähtetetään ilmoitukset ellei erikseen muuteta palvelimella tietoja. | ||
+ | |||
+ | sysLocation Helsinki | ||
+ | sysContact [email protected] | ||
+ | |||
+ | <!--T:133--> | ||
+ | Tallenna ja sulje tiedosto ja käynnistä palvelu uudelleen | ||
+ | |||
+ | <!--T:134--> | ||
+ | service snmpd restart | ||
+ | |||
+ | <!--T:135--> | ||
+ | Siirry observium palvelimelle ja lisää asiakaslaite konfiguraatioon. | ||
+ | |||
+ | <!--T:136--> | ||
+ | cd /opt/observium | ||
+ | |||
+ | <!--T:137--> | ||
+ | ./add_device.php <hostname> <community> v2c | ||
+ | |||
+ | |||
+ | === RouterOS === <!--T:138--> | ||
+ | |||
+ | <!--T:139--> | ||
+ | Luodaan ensimmäiseksi ''community trap'' '''observium''' jolla Observium-palvelin pystyy hakemaan tietoja asiakaslaitteelta. | ||
+ | |||
+ | <!--T:140--> | ||
+ | /snmp community add name=observium addresses=0.0.0.0/0 security=none read-access=yes write-access=no | ||
+ | |||
+ | <!--T:141--> | ||
+ | [[Tiedosto:RouterOS snmp 2.png]] | ||
+ | |||
+ | <!--T:142--> | ||
+ | Otetaan käyttöön SNMP asiakas ja liitetään aikaisemmin luotu ''community trap'' '''observium''' siihen. | ||
+ | |||
+ | <!--T:143--> | ||
+ | /snmp set enabled=yes location=Turku [email protected] trap-community=observium trap-target=10.0.0.5 | ||
+ | |||
+ | <!--T:144--> | ||
+ | [[Tiedosto:RouterOS snmp 1.png]] | ||
+ | |||
+ | <!--T:145--> | ||
+ | Siirry observium palvelimelle ja lisää asiakaslaite konfiguraatioon. | ||
+ | |||
+ | <!--T:146--> | ||
+ | cd /opt/observium | ||
+ | |||
+ | <!--T:147--> | ||
+ | ./add_device.php <hostname> <community> v2c | ||
+ | |||
+ | == Aiheeseen liittyvää == <!--T:148--> | ||
+ | |||
+ | <!--T:149--> | ||
+ | * [[Nagios3]] | ||
+ | * [[Munin]] | ||
+ | |||
+ | <!--T:150--> | ||
+ | [[Category:Linux]] | ||
+ | [[Category:RouterOS]] | ||
+ | |||
+ | == Lähteet == <!--T:151--> | ||
+ | |||
+ | <!--T:152--> | ||
+ | https://www.observium.org/wiki/Unix_Agent | ||
+ | |||
+ | </translate> |
Nykyinen versio 28. toukokuuta 2016 kello 08.51
Observium on ilmainen valvontaohjelma. Ohjelmalla voi valvoa palvelimia ja verkkolaitteita. Palvelimen tai verkkolaitteen vikaantuessa observium lähettää käyttäjälle sähköpostiviestin.
Sisällysluettelo
Asentaminen ja konfigurointi
Asenna seuraavat paketit pakettihallinnasta
apt-get install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-mcrypt php5-json php-pear snmp fping mysql-server mysql-client python-mysqldb rrdtool subversion whois mtr-tiny ipmitool graphviz imagemagick
Ubuntu 16.04
apt-get install libapache2-mod-php7.0 php7.0-cli php7.0-mysql php7.0-mysqli php7.0-gd php7.0-mcrypt php7.0-json \ php-pear snmp fping mysql-server mysql-client python-mysqldb rrdtool subversion whois mtr-tiny ipmitool \ graphviz imagemagick apache2
Luo hakemisto Observium:ille ja siirrytään siihen
mkdir -p /opt/observium && cd /opt
Ladataan Observium free editon
wget http://www.observium.org/observium-community-latest.tar.gz
Puretaan tar paketti
tar zxvf observium-community-latest.tar.gz
Siirrytään observium hakemistoon
cd observium
Kopioidaan default konfiguraatio tiedosto
cp config.php.default config.php
Kirjautu tietokantaan ja luo uusi tietokanta Observiumille
mysql -u root -p <mysql root password> mysql> CREATE DATABASE observium DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; mysql> GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost' -> IDENTIFIED BY '<observium db password>';
Avaa config.php tiedosto ja päivitä siihen tietokantasi tiedot.
// Database config $config['db_host'] = 'localhost'; $config['db_user'] = 'observium'; $config['db_pass'] = '<observium db password>'; $config['db_name'] = 'observium';
Aja seuraava komento. Tämä määrittää automaattisesti tietokantaasi taulut.
php includes/update/update.php
Luo hakemisto Observiumin lokille
mkdir logs
Avaa Apachen konfigurointi tiedosto
nano /etc/apache2/sites-available/default
ja muuta se seuraavanlaiseksi
<VirtualHost *:80> ServerAdmin webmaster@localhost DocumentRoot /opt/observium/html <Directory /> Options FollowSymLinks AllowOverride None </Directory> <Directory /opt/observium/html/> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all </Directory> ErrorLog ${APACHE_LOG_DIR}/error.log LogLevel warn CustomLog ${APACHE_LOG_DIR}/access.log combined ServerSignature On </VirtualHost>
Ota käyttöön php mcrypt moduuli
php5enmod mcrypt
Ota käyttään Apachen moduuli mod_rewrite
a2enmod rewrite apache2ctl restart
Luo ensimmäinen käyttäjä Observiumiin. Käytetään tason 10., eli adminia.
cd /opt/observium
./adduser.php <username> <password> <level>
Esimerkiksi
./adduser.php admin passwd123 10
Luo uusi tiedosto /etc/cron.d/observium ja lisää seuraavat rivit. Cron on ajastusta varten.
33 */6 * * * root /opt/observium/discovery.php -h all >> /dev/null 2>&1 */5 * * * * root /opt/observium/discovery.php -h new >> /dev/null 2>&1 */5 * * * * root /opt/observium/poller-wrapper.py 2 >> /dev/null 2>&1
Siirry nyt http://ip-osoite ja kirjaudu Observiumiin luomillasi käyttäjätunnuksillasi.
Lisäkonfiguraatiot
Nämä lisäkonfiguraatiot ovat vapaehtoisia. Kaikki lisäkonfiguraatiot tehdään observiumin konfigurointi tiedostoon /opt/observium/config.php
Sähköpostilmoitukset
Tämä konfiguraatio sallii observiumin lähettävän sähköpostiin ilmoituksen palvelimesta. Muuta vain [email protected] sähköpostiosoitteeksi jonne tahdot ilmoitukset ja [email protected], domainisi josta lähetetään (esim. [email protected]). Sinulla tulee olla sähköpostipalvelin (esimerkiksi postfix) jolla lähetetään ilmoitukset sähköpostiisi.
Tämä ei toimi uusimman Communityn kanssa!
$config['poller-wrapper']['alerter'] = TRUE; $config['alerts']['alerter']['default']['descr'] = "Observium Alert"; $config['alerts']['alerter']['default']['type'] = "email"; $config['alerts']['alerter']['default']['contact'] = "[email protected]"; $config['alerts']['alerter']['default']['enable'] = TRUE; $config['email_from'] = "[email protected]"; $config['alerts']['alerter']['default']['enable'] = TRUE; $config['alerts']['email']['enable'] = TRUE;
Ilmoitusasetukset
Ilmoita jos portti on alhaalla. Oletuksena pois käytöstä.
$config['alerts']['port']['ifdown'] = TRUE; $config['alerts']['port']['ifdown_types'] = array('core', 'transit', 'peering');
Ilmoita kun kaista on tietyn rajan yli per portti. Esimerkissä 85% ylittävän rajan lähetetään ilmoitus. Oletuksena pois käytöstä.
$config['alerts']['port_util_alert'] = TRUE; $config['alerts']['port_util_perc'] = 85;
Sovellukset
Ennen sovellusten käyttä, asenna Unix-Agent ensin ennen kuin alat käyttämään sovelluksia. Tätä tarvitaan suurimman osassa sovelluksista.
Kaikki tuetut sovellukset löytyvät: https://www.observium.org/wiki/Applications
Apache
- Vaatii Unix-Agent
Ota käyttään mod_status
a2enmod status
Käynnistä Apache2 uudelleen
service apache2 restart
Avaa mod_status konfigurointi
nano /etc/apache2/mod-available/status.conf
Sen tulisi olla seuraavanlainen:
ExtendedStatus On <Location /server-status> SetHandler server-status Order deny,allow Deny from all Allow from 127.0.0.1 ::1 </Location>
Varmista että apache agent scripti on Unix agentin local hakemistossa.
HDDTemp
- Vaatii Unix-Agent
- Vaatii hddtemp
- Vaatii netcat / netcat-traditional (Debian / Ubuntu)
aptitude install hddtemp netcat-traditional
Varmista että hddtemp agent scripti on Unix Agentin local hakemistossa.
Mailgraph
- Vaatii Unix-Agent
- Vaatii rrdtool
- Vaatii mailgraph
aptitude install rrdtool mailgraph
Varmista että scriptiti ovat oikeassa sijainissa. Varmista että RRDPATH muuttuja on oikeassa hakemistossa. Debianissa tämä pitäisi olla oletuksena oikein.
MySQL
- Vaatii Unix-Agent
- Vaatii php5-cli (php-cli)
- Vaatii php5-mysql (php-mysql)
Kopioi mysql scripti Unix-Agent local hakemistoon.
Debian järjestelmissä pitäisi tämän jälkeen toimia oikein. Muut järjestelmät: https://www.observium.org/wiki/Application/MySQL#Instructions
Nginx
- Vaatii Unix-Agent
Lisää seuraava konffi /etc/nginx/sites-enabled/default tiedostoon jos ei ole jo
location /nginx-status #Vaihda /status jos ei toimi { stub_status on; access_log off; allow 127.0.0.1; deny all; }
Käynnistä muutoksen jälkeen palvelu uudelleen
Kopioi nginx scripti User Agent local hakemistoon.
Tarkista että nginx-status toimii (muuta location jos tulee error 403):
w3m http://localhost/nginx-status
TAI
w3m http://localhost/status
Jos olet muuttanut location, muuta tämäkin nginx scripti tiedostoon. Jos localhost ei toimi käytä sen sijasta 127.0.0.1 IP-osoitetta.
Unix Agent
Asenna xinetd
sudo apt-get install xinetd
Kopioi /opt/observium/scripts/observium_agent_xinetd tiedosto Observium palvelimesta Unix-Agent palvelimen polkuun /etc/xinetd.d/observium_agent_xinet.
Kopioi lisäksi /opt/observium/scripts/observium_agent tiedosto Observium palvelimesta Unix-Agent palvelimen polkuun /usr/bin/observium_agent
Käytä esimerkiksi SCP:tä. Aja tämä komento palvelimessa jossa on observium asennettu:
scp /opt/observium/scripts/observium_agent_xinetd [email protected]:/etc/xinetd.d/observium_agent_xinetd scp /opt/observium/scripts/observium_agent [email protected]:/usr/bin/observium_agent
Luo seuraavat hakemistot
mkdir /usr/lib/observium_agent mkdir /usr/lib/observium_agent/local
Avaa observium_agent_xinetd tiedosto
nano /etc/xinetd.d/observium_agent_xinetd
ja määritä IP-osoite mitä Unix-Agent kuuntelee.
only_from = 10.6.10.100 127.0.0.1 ::1
Käynnistä palvelu uudelleen
sudo service xinetd restart
Lisää tämä /opt/observium/config tiedostoon ottaaksesi käyttöön Unix-agent modulen:
$config['poller_modules']['unix-agent'] = 1;
Määritä käyttöoikeudet
chmod 744 /usr/bin/observium_agent chmod 744 -R /usr/lib/observium_agent/local/
Testaa:
Telnetillä:
telnet YourUnixServer.YourDomain.com 36602
Tai suoraan päätelaitteelta.
/usr/bin/observium_agent
Kopioi koko /opt/observium/scripts/agent-local hakemiston sisältö /usr/lib/observium_agent/local/ hakemiston alle.
scp /opt/observium/scripts/agent-local/* [email protected]:/usr/lib/observium_agent/local/
WMI
http://jira.observium.org/secure/attachment/11319/WMIPoller-011013-1429-4.pdf
http://techedemic.com/2014/09/17/installing-wmic-in-ubuntu-14-04-lts-64-bit/
Asiakaslaitteet (SNMP)
Kaikki tuetut laitteet löytyvät täältä: http://www.observium.org/wiki/Supported_Devices
Varmista että palvelimesta pystyy muodostamaan yhteyden UDP:n portin 161 kautta päätelaitteeseen.
Debian / Ubuntu
Lisää asiakaslaite nimipalveluun A record.
Asenna smpd client pakettihallinnasta.
aptitude install snmpd
Avaa SNMP konfigurointi tiedosto
nano /etc/snmpd.conf
Poista risuaita riviltä 17 ja lisää risuaita riville 15.
# Listen for connections from the local system only #agentAddress udp:127.0.0.1:161 # Listen for connections on all interfaces (both IPv4 *and* IPv6) agentAddress udp:161,udp6:[::1]:161
Lisää risuaita riville 51 ja lisää rocommunity. Rocomminityyn (community = salasana) ja IP, jonka sallitaan hakevan tietoja.
#rocommunity public default -V systemonly rocommunity <community> <ip>
Esimerkiksi
rocommunity observium123 192.168.1.44
Lisää risuaita
#rouser authOnlyUser
Muuta syslocation (sijainti) ja sähköpostiosoite. Tähän sähköpostiosoitteeseen lähtetetään ilmoitukset ellei erikseen muuteta palvelimella tietoja.
sysLocation Helsinki sysContact [email protected]
Tallenna ja sulje tiedosto ja käynnistä palvelu uudelleen
service snmpd restart
Siirry observium palvelimelle ja lisää asiakaslaite konfiguraatioon.
cd /opt/observium
./add_device.php <hostname> <community> v2c
RouterOS
Luodaan ensimmäiseksi community trap observium jolla Observium-palvelin pystyy hakemaan tietoja asiakaslaitteelta.
/snmp community add name=observium addresses=0.0.0.0/0 security=none read-access=yes write-access=no
Otetaan käyttöön SNMP asiakas ja liitetään aikaisemmin luotu community trap observium siihen.
/snmp set enabled=yes location=Turku [email protected] trap-community=observium trap-target=10.0.0.5
Siirry observium palvelimelle ja lisää asiakaslaite konfiguraatioon.
cd /opt/observium
./add_device.php <hostname> <community> v2c