How To Install Observium in Ubuntu 13.10 To 15.04: Observium SNMP PHP Mysql

Download as docx, pdf, or txt
Download as docx, pdf, or txt
You are on page 1of 3

How to install Observium in Ubuntu 13.10 to 15.

04

Introduction
Today we will be installing Observium.
Observium is a Network Management and Monitoring System that collects data from multiple
devices using SNMP and allows you to monitor all of the networks devices via an easy to use
interface. It is PHP-based and uses a MySQL database to store data.

Note
This guide works with Ubuntu 13.10 to 15.04 and Debian 7.

Install
Connect to your server via SSH

ssh [email protected] Dependenciessudo apt-get -y 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 imagemagickEnter the Mysql password
for the root user. Note: For security make this one different than your server's password, and try not
to use this user in any application that requires a database to store and pull data from.

Download and Extract Observiumsudo


mkdir -p /opt/observium && cd /opt
sudo wget http://www.observium.org/observium-community-latest.tar.gz
sudo tar zxvf observium-community-latest.tar.gz
Configuration
create the MYSQL database and user Enter your MySQL password that you gave the root user from
before

mysql -u root -p</pre> Once in MySQL enter the following commands to create the
database, the user and to allow the user access to the database.CREATE DATABASE observium
DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; Make sure to change the
Observium database password with your own, you will need this in the next step.GRANT ALL
PRIVILEGES ON observium.* TO 'observium'@'localhost' IDENTIFIED BY
'observium db password'; Changing the config filecd observiumsudo cp
config.php.default config.phpChange the setting on the config.php to reflect your systems
settingssudo nano config.phpSet the username and password on the observium config file and
an email address for alerts to get sent to.<?php## Check
http://www.observium.org/wiki/Configuration_Options for documentation of
these settings// Database config --- This MUST be
configured$config['db_host'] = 'localhost';$config['db_user'] =
'USERNAME';//observium user that we created before$config['db_pass'] =
'PASSWORD';//observium password thet you gave the observium
user$config['db_name'] = 'observium';// Base
directory$config['install_dir'] = "/opt/observium";// Default community
list to use when adding/discovering$config['snmp']['community'] =
array("public");// Authentication Model$config['auth_mechanism'] =
"mysql"; // default, other options: ldap, http-auth, please see
documentati$// Enable alerter (not available in CE)#$config['poller-
wrapper']['alerter'] = TRUE;// Set up a default alerter (email to a single
address)$config['alerts']['alerter']['default']['descr'] = "Default
Email Alert";$config['alerts']['alerter']['default']['type'] = "email";
$config['alerts']['alerter']['default']['contact'] ="[email protected]";
$config['alerts']['alerter']['default']['enable'] = TRUE;// End
config.phpControl +X to write file in nano. Run this script to Setup the MySQL database and insert
the default schema:./discovery.php -u

Create required directories


Directory where logs are storedsudo mkdir logsDirectory for the round-robin database sudo
mkdir rrdGive the apache user and group ownership of the directorysudo chown www-
data:www-data rrd

Configuring Apache web server


sudo nano /etc/apache2/sites-available/000-default.confMake the file look like
this<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
Require all granted </Directory> ErrorLog $
{APACHE_LOG_DIR}/error.log LogLevel warn CustomLog $
{APACHE_LOG_DIR}/access.log combined ServerSignature On</VirtualHost>
Enable php mcrypt module:sudo php5enmod mcryptEnable mod_rewrite for Observium's cleaner
URLs:sudo a2enmod rewriteRestart Apachesudo service apache2 restart
Getting Started
Adding an Admin User./adduser.php admin password 10Adding your First SNMP enabled
device to monitor./add_device.php <hostname> <community> v2c

Note: if your internal network can't resolve hostnames, add them to your hosts file.

Adding the cron jobs


Create this cron file
sudo nano /etc/cron.d/observium

Add the following content inside. these jobs are required by Observium for Polling and Discovering
Devices
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

That's It

Open The panel at and Login with the password you set earlier
http://Server-IP

You might also like