Centreon 2.1.4 on FreeBSD (English)
Update Tutorial: http://www.luizgustavo.pro.br/blog/2011/12/09/english-centreon-2-3-3-freebsd-9/
This tutorial will guide the User to perform the installation of Centreon on FreeBSD. We will be using an installation in a Jail in FreeBSD kernel version 7.3-PRERELEASE, the kernel version will not influence the tutorial.
What is Centreon?
Centreon is a powerful tool for monitoring hosts and services, it is a frontend that runs on top of Nagios, adding more facilities for viewing and alert history, status, etc. ..
To learn more about the tool, I invite you to visit the official website at the address http://www.centreon.com
What we need?
- Apache
- PHP + a lot of dependencies
- Mysql
- Nagios
- Pear + a lot of dependencies
- Perl + a lot of dependencies
- rrdtool
- snmp
- sudo
- Centreon (obvious :-p)
Starting installation of packages
Installation of Perl
cd /usr/ports/lang/perl5.10 make install clean
Mark the options:
│ │ [X] PERL_64BITINT Use 64 bit integers (on i386) │ │ │ │ [X] THREADS Build threaded perl │ │ │ │ [X] USE_PERL Rewrite links in /usr/bin │ │
Installation of BASH:
Basically we use the BASH only to run the installation script
cd /usr/ports/shells/bash make install clean
Installation SUDO to perform tasks for the Apache User:
cd /usr/ports/security/sudo make batch=yes install clean
Installation of Apache server:
cd /usr/ports/www/apache20 make install clean
Configure Apache to start with FreeBSD:
echo 'apache2_enable="YES"' >> /etc/rc.conf
Installation of Net-SNMP:
cd /usr/ports/net-mgmt/net-snmp make install clean
Mark the options:
│ │ [X] IPV6 Build with IPv6 support │ │ │ │ [X] MFD_REWRITES Build with 64-bit Interface Counters │ │ │ │ [X] PERL Install additional perl modules │ │ │ │ [X] PERL_EMBEDDED Build embedded perl │ │ │ │ [X] DUMMY Enable dummy values as placeholders │ │
Options for startup service:
mkdir /usr/local/etc/snmp cp /usr/local/share/snmp/snmpd.conf.example /usr/local/etc/snmp/snmpd.conf perl -p -i -e 's/com2sec local localhost COMMUNITY/com2sec local localhost public/g' /usr/local/etc/snmp/snmpd.conf echo 'snmpd_enable="YES"' >> /etc/rc.conf echo 'snmpd_pidfile="/usr/local/etc/snmp/snmpd.conf"' >> /etc/rc.conf /usr/local/etc/rc.d/snmpd start
Installation of PHP5:
cd /usr/ports/lang/php5 make install clean
Mark the options:
│ │[X] CLI Build CLI version │ │ │ │[X] APACHE Build Apache module │ │ │ │[X] IPV6 Enable ipv6 support │ │
Configure the PHP:
cd /usr/local/etc cp php.ini-recommended php.ini
Configure the Apache for use with PHP
echo "AddType application/x-httpd-php .php" >> /usr/local/etc/apache2/httpd.conf echo "AddType application/x-httpd-php-source .phps" >> /usr/local/etc/apache2/httpd.conf cat /usr/local/etc/apache2/httpd.conf | sed 's/DirectoryIndex index.html index.html.var/DirectoryIndex index.html index.html.var index.php/' > /tmp/httpd.conf && mv /tmp/httpd.conf /usr/local/etc/apache2/httpd.conf
Installation of Database MySQL:
cd /usr/ports/databases/mysql51-server make install clean
Configure the MySQL for start with FreeBSD:
echo 'mysql_enable="YES"' >> /etc/rc.conf
Installing the dependencies of PHP:
cd /usr/ports/databases/php5-mysql make install clean
cd /usr/ports/graphics/php5-gd make BATCH=yes install clean
cd /usr/ports/www/php5-session make install clean
cd /usr/ports/archivers/php5-zlib make install clean
cd /usr/ports/sysutils/php5-posix make install clean
cd /usr/ports/devel/php5-pcre make install clean
Mark the options:
│ │ [X] BUNDLED_PCRE Select if you use apache 2.0.x │ │
cd /usr/ports/security/php5-filter make install clean
cd /usr/ports/converters/php5-mbstring make install clean
Mark the options:
│ │ [X] REGEX Enable multibyte regex support │ │
cd /usr/ports/textproc/php5-xml make install clean
cd /usr/ports/textproc/php5-xmlwriter make install clean
cd /usr/ports/devel/php5-gettext make install clean
Installation of PEAR and its dependencies:
cd /usr/ports/devel/pear make install clean
cd /usr/ports/databases/pear-DB_DataObject make BATCH=yes install clean
cd /usr/ports/databases/pear-DB_DataObject_FormBuilder make BATCH=yes install clean
cd /usr/ports/databases/pear-MDB2 make install clean
cd /usr/ports/textproc/pear-Numbers_Roman make install clean
cd /usr/ports/textproc/pear-Numbers_Words make install clean
cd /usr/ports/devel/pear-HTML_QuickForm2 make install clean
cd /usr/ports/devel/pear-HTML_QuickForm_advmultiselect make install clean
cd /usr/ports/devel/pear-HTML_Table make install clean
cd /usr/ports/security/pear-Auth_SASL make BATCH=yes install clean
cd /usr/ports/graphics/pear-Image_Canvas make install clean
cd /usr/ports/graphics/pear-Image_Graph make BATCH=yes install clean
cd /usr/ports/graphics/pear-Image_GraphViz make BATCH=yes install clean
cd /usr/ports/net/pear-Net_SMTP make BATCH=yes install clean
Installing some packages in PERL for the Centreon:
cd /usr/ports/devel/p5-Config-IniFiles make install clean
cd /usr/ports/graphics/p5-GD make install clean
cd /usr/ports/databases/p5-DBD-mysql make install clean
cd /usr/ports/security/p5-Crypt-DES make install clean
cd /usr/ports/security/p5-Digest-HMAC make install clean
cd /usr/ports/net/p5-IO-INET6 make install clean
cd /usr/ports/net-mgmt/p5-Net-SNMP make install clean
Installing the main tool for creating graphics, RRDTOOL:
cd /usr/ports/databases/rrdtool make BATCH=yes install clean
Installation of Nagios 3:
cd /usr/ports/net-mgmt/nagios make install clean
Mark the options:
│ │[X] EMBEDDED_PERL Enable embedded Perl [requires Perl 5.8.0+] │ │ │ │[X] NANOSLEEP Use nanosleep in event timing │ │ │ │[X] EVENT_BROKER Enable event broker functionality │ │
Nagios-plugins:
│ │ [X] FPING Support for non-flooding fast ping (check_fping) │ │ │ │ [X] NETSNMP SNMP support (check_snmp) │ │
If you are installing inside a Jail, select the option below:
│ │ [X] JAIL Compilation within jail(8) (see Makefile) │ │
Rename the configuration of Nagios (running the shell csh)
cd /usr/local/etc/nagios foreach arquivo ( "`ls -1`" ) mv $arquivo `echo $arquivo | sed 's/-sample//g'` end cd objects foreach arquivo ( "`ls -1`" ) mv $arquivo `echo $arquivo | sed 's/-sample//g'` end
Image Pack for Nagios:
cd /usr/ports/misc/nagios-base-logos make install clean
Installation of NDO-utils:
cd /usr/ports/net-mgmt/ndoutils/ make install clean
Mark the options:
│ │ [X] MYSQL MySQL Backend │ │
Now is the time we start the installation of Centreon for this, we must first download the installation package Centreon and unpack it in a directory to work:
cd /tmp fetch http://download.centreon.com/centreon/centreon-2.1.4.tar.gz tar zxf centreon-2.1.4.tar.gz cd centreon-2.1.4
Let’s make some adjustments to run on FreeBSD:
perl -p -i -e 's/\/bin\/bash/\/usr\/local\/bin\/bash/g' install.sh perl -p -i -e 's/\/bin\/bash/\/usr\/local\/bin\/bash/g' libinstall/* mkdir /usr/local/etc/cron.d cd /tmp/centreon-2.1.4/tmpl/vardistrib fetch -o freebsd http://www.luizgustavo.pro.br/blog/wp-content/uploads/2010/02/freebsd.txt
We will now begin installing Centreon:
cd ../.. ./install.sh -f tmpl/vardistrib/freebsd
Follow as the video:
When installation is complete, we will leave for the web, so, start MySQL and Apache:
/usr/local/etc/rc.d/apache2 start /usr/local/etc/rc.d/mysql-server start
We hit a permission not ok:
chown -R www:www /usr/local/etc/centreon/
Now so we can point our browser to the server address Centreon:
http://<ip_ou_url>/centreon
Follow the video to configure web:
still need to export the configuration files for our NDO-Utils to work for that accompanies the video on the export of the same web:
That done, we can initialize the NDO:
echo 'ndo2db_enable="YES"' >> /etc/rc.conf /usr/local/etc/rc.d/ndo2db start
Now, let’s start the process of Centreon:
pw user mod nagios -s /bin/sh /usr/local/etc/rc.d/centcore start /usr/local/etc/rc.d/centstorage start
We hit a path within the SUDO:
perl -p -i -e 's/\/etc\/init\.d\/nagios/\/usr\/local\/etc\/rc\.d\/nagios/g' /usr/local/etc/sudoers
Setting the part of CRON for FreeBSD:
cat /usr/local/etc/cron.d/* >> /etc/crontab /etc/rc.d/cron restart
and now the Nagios:
echo 'nagios_enable="YES"' >> /etc/rc.conf /usr/local/etc/rc.d/nagios start
Finished ! Now you can set up your hosts and start monitoring.
If you need support Centreon, please contact the Mundounix, we offer support and advice for monitoring networks solution.
Very good! Thanks!
Thank you for your tutorial, it’s really good for FreeBSD.
Once I have done all this, I try to import my existing nagios config, but nothing comes up in home and monitoring. Do you know where that could come from?