Escolar Documentos
Profissional Documentos
Cultura Documentos
Contents
1 Intro
1.1 Features
2 CentOS Requirements
2.1 Installing Centos 5.x
2.2 Post CentOS Install
2.3 Adding RPMforge Repository
3 LAMP Requirements for Centreon
3.1 LAMP components needed
3.1.1 Standard
3.1.2 Library
3.1.3 System
3.1.4 Pear Packages
4 Centreon/Oreon
4.1 Requirements for Centreon/Oreon
4.1.1 Installing Centreon/Oreon
4.1.2 install.sh
4.2 All you need for the web install is to actually provide the MySQL root password
4.2.1 Apache
4.3 PHP
4.4 All you need for the web install is to actually provide the MySQL root password
4.4.1 Apache
4.5 PHP
4.6 Directory Structure in /etc/nagios
4.7 Permissions
4.8 Centreon/Oreon Graphing and ODS (Oreon Data Storage)
4.8.1 How to actually make the graphs
4.8.1.1 Checking Data For Graph Generation (ODS)
4.8.1.2 What to check if you don't have any graphs
4.9 Troubleshooting
Intro
Oreon/Centreon (http://www.oreon-project.org) , frontend GUI applications that manages Nagios (similar to Groundwork's Fruity), uses MySQL database
to create the /etc/nagios/*.cfg files necessary for the Nagios daemon.
Features
"At a Glance" type console for the Directors and Execs
RRD Graphing of perfdata
Unified configuration from web control panel
Centreon obviously cannot be yum'd or apt-get'd, you'll have to download, install, and configure.
CentOS Requirements
Installing Centos 5.x
Install CentOS 5 (http://isoredirect.centos.org/centos/5/isos/i386/)
No "single server cd" available, like in 4.x
You only need CD1 if you deselect all the packages, if you select packages, then you will need the other CDs (n/a if you use the DVD, of
course)
Do a minimal install (with as few packages as possible)
unselect all the packages, then click "customize now" and deselect the rest of them
Turn off SELinux (http://www.nsa.gov/selinux/) (if you leave this on, you will likely experience many problems trying to get Nagios working)
Reboot
1 of 8 7/2/2011 11:53 AM
Installing Centreon on Centos 5 - Nagios Wiki http://www.nagioswiki.com/wiki/index.php/Installing_Centreon_o...
(optional)
[main]
enabled=1
priority=N
and
wget http://apt.sw.be/redhat/el5/en/i386/dag/RPMS/rpmforge-release-0.3.6-1.el5.rf.i386.rpm
rpm --import http://dag.wieers.com/rpm/packages/RPM-GPG-KEY.dag.txt
rpm -K rpmforge-release-0.3.6-1.el5.rf.*.rpm
rpm -i rpmforge-release-0.3.6-1.el5.rf.*.rpm
make sure it all works ok (i.e. show which packages were held back)
yum check-update
.
.
.
yum check-update --> 176 packages excluded due to repository priority protections
yum update
General instructions
http://www.flmnh.ufl.edu/linux/install_apache.htm
Standard
yum -y install nagios nagios-devel nagios-plugins nagios-plugins-setuid httpd httpd-manual mysql mysql-server mysql-devel php gd gd-devel rrdtool net-snmp
Library
php-mysql
php-pear
php-snmp
php-posix
libgd2
gd-devel
libpng
libpng-devel
perl-config-IniFiles
perl-Crypt-DES
perl-Digest-HMAC
2 of 8 7/2/2011 11:53 AM
Installing Centreon on Centos 5 - Nagios Wiki http://www.nagioswiki.com/wiki/index.php/Installing_Centreon_o...
perl-Digest-SHA1
perl-GD
perl-IO-Socket-INET6
perl-Net-SNMP
perl-rrdtool
perl-Socket6
yum -y install php-mysql php-pear php-snmp (php-posix) (libgd2) gd-devel (libpng libpng-devel) perl-Config-IniFiles perl-crypt-des perl-digest-hmac
perl-digest-sha1 perl-gd perl-IO-Socket-INET6 perl-net-snmp perl-rrdtool perl-socket6
System
sudo
make
gcc
Pear Packages
Auth_SASL
Date
DB
DB_DataObject
DB_DataObject_FormBuilder
HTML_Common
HTML_QuickForm
HTML_QuickForm_advmultiselect
HTML_Table
Image_Canvas
Image_Color
Image_Graph
Image_GraphViz
Mail_Mime
MDB2
Net_Ping
Net_Traceroute
Numbers_Roman
Numbers_Words
PEAR
Validate
XML_RPC
pear install -o -f --alldeps DB DB_DataObject DB_DataObject_FormBuilder MDB2 Date Numbers_Roman Numbers_Words HTML_Common HTML_QuickForm HTML_QuickForm_advmultiselect H
/etc/init.d/nagios start
chkconfig nagios on
/etc/init.d/mysqld start
chkconfig mysqld on
/etc/init.d/httpd start
chkconfig httpd on
You will need all the latest PEAR modules + GD so it can do RRD-related things.
type in IP address in browser, make sure page is served and that you can see host checks (otherwise permissions probably aren't set right)
to troubleshoot what might be wrong with Apache, type in "tail /etc/httpd/logs/error_log"
Centreon/Oreon
Centreon is a French development so most documentation and most of the forums are in French, there is adequate documentation in English but I made
this so we can skip by most of that.
Installing Centreon/Oreon
The Oreon project actually has neat videos in Flash for installation: (the other install docs are in French)
3 of 8 7/2/2011 11:53 AM
Installing Centreon on Centos 5 - Nagios Wiki http://www.nagioswiki.com/wiki/index.php/Installing_Centreon_o...
http://<yourserver>/oreon/
install.sh
cd /tmp
wget http://download.oreon-project.org/index.php?id=65
tar zxfv centreon-1.4.1.tar.gz
cd centreon-1.4.1
./install.sh
4 of 8 7/2/2011 11:53 AM
Installing Centreon on Centos 5 - Nagios Wiki http://www.nagioswiki.com/wiki/index.php/Installing_Centreon_o...
###############################################################################
# OREON Project (www.oreon-project.org) #
# Thanks for using OREON #
# #
# v 1.4.1 #
# #
# infos@oreon-project.org #
# #
# Make sure you have installed and configured #
# sudo - sed #
# php - apache - rrdtool - mysql #
# #
# #
###############################################################################
# The Team OREON #
###############################################################################
WARNING : Setup will delete all previous informations in your OREON DATABASE.
Where is sudo ?
default to [/etc/sudoers]:
------------------------------------------------------------------------
User Management
------------------------------------------------------------------------
------------------------------------------------------------------------
Other Stuff
------------------------------------------------------------------------
------------------------------------------------------------------------
Configure Apache server
------------------------------------------------------------------------
Stopping httpd: [ OK ]
Starting httpd: [ OK ]
------------------------------------------------------------------------
Start Oreon Installation
------------------------------------------------------------------------
------------------------------------------------------------------------
Start Plugins Oreon Installation
------------------------------------------------------------------------
5 of 8 7/2/2011 11:53 AM
Installing Centreon on Centos 5 - Nagios Wiki http://www.nagioswiki.com/wiki/index.php/Installing_Centreon_o...
Y (to continue) Where is Nagios installed? /usr/share/nagios Where is your Nagios etc directory? /etc/nagios
All you need for the web install is to actually provide the MySQL root password
Apache
PHP
vim /etc/php.ini
magic_quotes_gpc = On
configuring permissions
All you need for the web install is to actually provide the MySQL root password
Apache
PHP
vim php.ini
configuring permissions
If you wish to import your existing config, please see this: Centreon Wiki page for importing existing config (http://wiki.oreon-project.org/index.php
/Load_your_previous_nagios_cfg)
Centreon uses a FLAT config directory unlike other Nagios frontends which may use a tree'd (NagiosQL for instance)
Permissions
Give Apache appropriate permissions.
Making sure Nagios can write to command file. If it is not there, then you will need to enable the check_external_commands option to 1 in nagios.cfg.
6 of 8 7/2/2011 11:53 AM
Installing Centreon on Centos 5 - Nagios Wiki http://www.nagioswiki.com/wiki/index.php/Installing_Centreon_o...
The primary thing is to make sure that Nagios has perfdata collection on.
Most of the information here can be gleaned from this half French/English thread in their forums, but I'll summarize them here for easier edification.
http://forum.oreon-project.org/showthread.php?t=4747
http://wiki.oreon-project.org/index.php/Graphs
For some reason if you do not have a process-service-perfdata script they tell you how to create one, but you should have one already.
The wiki article then goes through to tell you what to do from the web interface to modify the nagios.cfg to enable perfdata collection and default
RRD settings page
One of the main reasons that ODS doesn't work is usually because you don't have the ODS service actually running.
$> ls /usr/local/oreon/OreonDataStorage/
At this point the graph setup should be complete as long as your service has perfdata turned ON.
Now you go in and check the ODS directory to make sure RRD's are being generated:
ls -l /usr/local/oreon/ODS
If you do not see any RRD's, check your Nagios directory to make sure perfdata is being collected:
7 of 8 7/2/2011 11:53 AM
Installing Centreon on Centos 5 - Nagios Wiki http://www.nagioswiki.com/wiki/index.php/Installing_Centreon_o...
Make sure that service-perfdata.tmp is in there and has a size greater than 0.
Then you should start seeing graphs when you go to the Centreon View page.
Check the above files mentioned, see if they exist and if they have sizes
Make sure ODS is running if they aren't being generated
Look inside /usr/local/oreon/ODS/var there are some logs in there also
Check /var/log/messages
Check /etc/httpd/logs
Make sure you selected the right graph template to match your service collection type (parsing problem)
Troubleshooting
tail /var/log/httpd/error_log
8 of 8 7/2/2011 11:53 AM