OpenSource NetMonitoring » network-monitoring

vnStat PHP Frontend – Install & Config Webinterface for vnStat

admin — Mon, 17 Mar 2008 23:07:50 +0000

B. Dijkstra at SQWEEK.com has written a simple PHP web frontend for vnStat. The latest stable version is 1.4.1 and is available for download here

vnStat PHP Frontend requires

Apache Webserver (use Apache2.2.3 here)

PHP (use PHP5.2.0-8)

GD Image librariesvnStat already installed

So lets get the prerequisites install.

Install PHP5

DebianSystem# aptitude install php5

Install GD Image Libraries

DebianSystem# aptitude install php5-gd

Install Apache2 Webserver

DebianSystem# aptitude install apache2

Now, the pre-requisites are installed. You need to have a functional vnStat running on the system. For install instructions click here

Download vnStat PHP Frontend

Download the vnStat PHP Frontend from here

DebianSystem# wget http://www.sqweek.com/sqweek/files/vnstat_php_frontend-1.4.1.tar.gz

Unzip & Untar the files

DebianSystem# tar -zxvf vnstat_php_frontend-1.4.1.tar.gz

Move the files to Apache Webserver Root

DebianSystem# mv vnstat_php_frontend-1.4.1 /var/www/vnstat

Edit Config file for the Interfaces

DebianSystem# vi config.php

Look for

$iface_list = array(‘eth0′);

and

$iface_title['eth0'] = ‘Internal’;
//$iface_title['eth1'] = ‘Internet’;
//$iface_title['sixxs'] = ‘SixXS IPv6′;

and alter it to your systems requirement acfordingly (say change name of interfaces or add multiple interfaces)

Example

$iface_list = array(‘eth0′ , ‘eth1′);

Now, that all is done, simply access the site and you can see the vnStat stats with graphs that you would otherwise see only in console.

Install and run vnStat as a Non-Root user

admin — Mon, 17 Mar 2008 22:26:38 +0000

One of the advantages of vnStat is that it can be installed and run as a Non-Root user. This can be of a great help to query vnStat of scripts or allow operators to run the vnStat utility.

Download vnStat

Download vnStat from here

DebianSystem# wget http://humdi.net/vnstat/vnstat-1.6.tar.gz

Unzip & Untar the downloaded the file

DebianSystem# tar -zxvf vnstat-1.6.tar.gz

ChangeDirectory & Compile

DebianSystem# cd vnstat-1.6

DebianSystem:/vnstat-1.6# make

Create Database Directory

If there was no errors, copy src/vnstat to some directory included in $PATH variable(say ~/bin/) and create the database directory.

DebianSystem# cp src/vnstat ~/bin/
DebianSystem# cp cfg/vnstat.conf ~/.vnstatrc
DebianSystem# mkdir ~/.vnstat

Test Kernel compatibility

DebianSystem# vnstat –testkernel

Edit Config file & Add Database Directory

DebianSystem# vi ~/.vnstatrc

Locate

DatabaseDir “/var/lib/vnstat”

and replace with

DatabaseDir “/pathtoyourhomedir/.vnstat”

and save the file.

Next every interface that should be monitored needs to be added to vnStat. This creates a database for each of the interface.

DebianSystem# vnstat -u -i eth0

where eth0 is the interface name. Change it to the interface on your system.

CRON Job
Add a crontab job entry for vnStat.

DebianSystem# crontab -e

and add the following line

*/5 * * * * ~/bin/vnstat -u

Allow it to collect enough traffic information after which run vnstat

DebianSystem# vnstat

Also, in any case you can check the config file ~/.vnstatrc for interface and other settings.

For more options and examples for the command, click here

vnStat Network traffic/Bandwidth Monitoring for Linux

admin — Sun, 16 Mar 2008 21:59:52 +0000

vnStat is a free OpenSource (GPL License) network traffic monitor for Linux that keeps a log of daily network traffic for the selected interface(s) on the system. Unlike other Network Traffic monitors, vnStat analyzes the traffic information from the /proc filesystem. And, vnStat can be used even without root permissions.

vnStat maintains a database for every interface for which the network traffic analysed. We can watch the live Traffic status on the selected interface(s) or run reports on Hourly, Daily, Weekly and Monthly bandwidth statics for the selected network interfaces.

To install vnStat, all you need is the required C compiler installed.

Here I install vnStat on a Debian 4.0R2 system

Download vnStat

Download the vnStat from here

DebianSystem# wget http://humdi.net/vnstat/vnstat-1.6.tar.gz

Unzip & Untar the downloaded the file

DebianSystem# tar -zxvf vnstat-1.6.tar.gz

Install C Compilers

Ensure that the required C compilers are installed in the system. In debian to install the required packages to compile

DebianSystem# aptitude install build-essentials

ChangeDirectory & Install

DebianSystem# cd vnstat-1.6

DebianSystem:/vnstat-1.6# make

DebianSystem:/vnstat-1.6# make all

That installs the vnStat Bandwidth monitoring software.

Test the Kernel

DebianSystem# vnstat –testkernel

Create Interface Database

Run the following to create a database for each of the interfaces that you would want to monitor traffic bandwidth on.

DebianSystem# vnu -u -i eth0

This creates a database for the interface eth0

Now, give it a few minutes to collect enough data to provide useful statistics.

To show the summary simply type vnstat

DebianSystem# vnstat
Database updated: Sun Dec 2 22:20:01 2007

inet (eth0)

received:     735.00 GB (48.9%)
transmitted:     769.38 GB (51.1%)
total:       1.47 TB

rx     |     tx     | total
———————–+————+———–
yesterday     23.35 MB |   20.25 MB |   43.60 MB
today     27.47 MB |   21.37 MB |   48.84 MB
———————–+————+———–
estimated        29 MB |      22 MB |      51 MB

To show hourly statistics

DebianSystem# vnstat -h
inet (eth0)                                                              22:15
^                                                                 r
|                                                                 rt r
|                                                                 rt rt
|                                                                 rt rt
|                                                              r rt rt
|     rt                                                       r rt rt
|     rt                                                 rt    rt rt rt
| rt rt rt                                  r r rt r rt r rt rt rt
| rt rt rt                               r rt rt rt rt rt rt rt rt rt
| rt rt rt rt r              r     r r r rt rt rt rt rt rt rt rt rt rt
-+—————————————————————————>
| 23 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22

h   rx (kB)    tx (kB)      h   rx (kB)    tx (kB)      h   rx (kB)    tx (kB)
23      1,352      1,219    07        277        151    15      1,352      1,165
00      2,281      2,140    08        402        158    16      1,487        878
01      1,485      1,261    09        290        155    17      1,752      1,559
02        648        522    10        589        185    18      1,455      1,001
03        392        261    11        650        202    19      2,332      1,835
04        323        240    12        907        350    20      3,881      3,619
05        311        179    13      1,234      1,044    21      3,695      3,237
06        281        173    14      1,221        812    22        675        591

Other options are

   -q, –query        query database
-h, –hours        show hours
-d, –days        show days
-m, –months        show months
-w, –weeks        show weeks
-t, –top10        show top10
-s, –short        use short output
-u, –update        update database
-i, –iface        change interface (default: eth0)
-?, –help        short help
-v, –version        show version
-tr, –traffic        calculate traffic
-l, –live        show transfer rate in real time

Install & Configure Centreon Network Monitoring in Debian

admin — Sun, 20 Jan 2008 00:00:36 +0000

Centreon, previously Oreon-Project is network, system and application monitoring system modelled on the best ever opensource monitoring solution, Nagios. Centreon provides a new frontend and new functionnalities to Nagios.

It allows you to be more efficient in your network monitoring, but also allows you to make your supervision information readable by a largest range of users. Indeed, a non technical user can now use the Centreon/Nagios couple to easily understand your network infrastructure thanks to charts and graphical representations of the gathered information. Skilled users still have access to specific and technical information collected by Nagios though.

For a detailed list of features offered by Centreon, click here

The process of Installation of Centreon includes installation of the pre-requisites then Nagios and finally the Centreon binaries and configure.

The following is a four step procedure to install Centreon:

1. Install Centreon Pre-Requisites

2. Install Nagios & Nagios Plugin

3. Install Centreon binaries

4. Configure Setup Parameters & Database

The platform for this samplpe installation is

Operating System: Debian 4.0 R2

Webserver: Apache 2.2.3

PHP: PHP5.2.0

MySQL: MySQl Server 5.0

Nagios: Nagios 2.10

Nagios Plugin: Nagios-Plugin 1.4.11

Configure Centreon setup and database

admin — Sat, 19 Jan 2008 23:34:22 +0000

We have now installed Centreon Network Monitoring pre-requisites, Nagios, Nagios Plugins & centreon binaries. The final part of this installation procedure is to configure the setup paramaters from the web interface.

If you jumped into this article then please have a look at the previous three steps of this four part installation procedure:

1. Install Centreon Pre-Requisites

2. Install Nagios & Nagios Plugin

3. Install Centreon binaries

Logon to the web interface after the successful installation of Centreon binaries

http:///centreon/

where is the IP Address or the hostname of the webserver. This redirects to

http:///centreon/install/setup.php

The following are the step by step configuration screenshots which can take you through and complete the configuration

1. Centreon Web Configuration Welcome

2. Centreon License Acceptance page

3. Centreon Envirnment variables config

4. Centreon Verify Configs

5. PHP PEAR config

6. Database Configuration

7. Database Verification

8. User Interface config

9. LDAP Config

10. Component Verification

11. Create Database

12. Post Install verifiy

13. Centreon login page

Install Centreon Network Monitoring binaries in Debian

admin — Sat, 19 Jan 2008 22:17:48 +0000

After having installed the pre-requisites, Nagios & Nagios plugins, the next part of the installation of centreon Network monitoring solution involves the centreon binaries itself.

If you jumped into this article then please have a look at the previous three steps of this four part installation procedure:

1. Install Centreon Pre-Requisites

2. Install Nagios & Nagios Plugin

Download the latest version of Centreon (1.4.2.3 at the time of writing) from

http://download.oreon-project.org/index.php?id=73

Use wget to download the files

debian4r2:/software# wget http://download.oreon-project.org/index.php?id=73

Untar and Unzip the files

debian4r2:/software# tar -zxvf centreon-1.4.2.3.tar.gz

Change Directory to the extracted cenreon-1.4.2.3 directory

debian4r2:/software# cd centreon-1.4.2.3

Run the install script. This will start the installation and take you through a series questions, mostly accept the default, however if required change as appropriate.

debian4r2:/software/centreon-1.4.2.3# ./install.sh

The following is from my installation:

######################################################
#                            Centreon (www.centreon.com)                      #
#                            Thanks for using Centreon                        #
#                                                                             #
#                                   v 1.4.2.3                                 #
#                                                                             #
#                             infos@oreon-project.org                         #
#                                                                             #
#                     Make sure you have installed and configured             #
#                                   sudo – sed                                #
#                          php – apache – rrdtool – mysql                     #
#                                                                             #
#                                                                             #
######################################################
#                                 The Team Centreon                           #
######################################################

                     Make sure you have root permissions !
WARNING : Setup will delete all previous informations in your Centreon DATABASE                                             .

Are you sure to continue ?
[y/n], default to [n]:y
Where is installed Nagios ?
default to [/usr/local/nagios]:
Where is your nagios etc directory ?
default to [/usr/local/nagios/etc]:
Path /usr/local/nagios/etc                                 OK

Where is your nagios var directory ?
default to [/usr/local/nagios/var]:
Path /usr/local/nagios/var                                 OK

Where is your nagios plugins (libexec) directory ?
default to [/usr/local/nagios/libexec]:
Path /usr/local/nagios/libexec                             OK

Where is your nagios bin directory?
default to [/usr/local/nagios/bin]:
Path /usr/local/nagios/bin                                 OK

Where is your nagios image directory ?
default to [/usr/local/nagios/share/images]:
Path /usr/local/nagios/share/images                        OK

Where do I install centreon ?
default to [/usr/local/centreon]:
Directory /usr/local/centreon does not exits.              CRITICAL

Do you want me to create this directory [/usr/local/centreon]?[Y/n]y
Path /usr/local/centreon                                   OK

Where is installed RRD perl modules [RRDs.pm] ?
Just put directory, not full path.
default to [/usr/local/rrdtool/lib/perl]:/usr/lib/perl5
File /usr/lib/perl5                                        OK

Where is rrdtool binary ?
default to [/usr/bin/rrdtool]:
/usr/bin/rrdtool                                           OK

Where is mail binary ?
default to [/usr/bin/mail]:
/usr/bin/mail                                              OK

Where is PEAR Path ?
default to [/usr/share/pear]:/usr/share/php/
PEAR Path /usr/share/php                                   OK

————————————————————————
                           User Management
————————————————————————
Finding Apache group :                                     www-data
Finding Apache user :                                      www-data
Finding Nagios group :                                     nagios
Finding nagios group ‘nagios’ in /etc/group                YES
Finding Nagios user :                                      nagios
Finding nagios user ‘nagios’ in /etc/passwd                YES

————————————————————————
                              Other Stuff
————————————————————————
TrueType directory created                                 OK
TrueType verdana installed                                 OK
Finding PEAR Path : /usr/share/php                         OK
PEAR Font directory created                                OK
PEAR Font installed                                        OK

————————————————————————
                        Configure Apache server
————————————————————————
Create ‘/etc/apache2/conf.d/oreon.conf’                    OK
Configuring Apache                                         OK
User www-data added to nagios group                        OK
————————————————————————
                              Start Centreon Installation
————————————————————————
Centreon Directory already exists                          PASSED
Copy ‘filesGeneration’                                     OK
Copy ‘filesUpload’                                         OK
Copy ‘GPL_LIB’                                             OK
Copy ‘log’                                                 OK
Copy ‘www’                                                 OK
Copy ‘cron’                                                OK
Copy ‘ODS’                                                 OK
Copy ‘ODS_SRC_ETC’                                         OK
Copy ‘doc’                                                 OK

————————————————————————
                   Start Plugins Centreon Installation
————————————————————————
/usr/local/nagios/libexec already exists                   PASSED

Preparing Oreon Plugins…
-> centreon.conf                                         OK
-> centreon.pm                                           OK
-> check_centreon_dummy                                  OK
-> check_centreon_MS_multiple_services                   OK
-> check_centreon_nt                                     OK
-> check_centreon_ping                                   OK
-> check_centreon_snmp_cpu                               OK
-> check_centreon_snmp_loadaverage                       OK
-> check_centreon_snmp_multiple_process                  OK
-> check_centreon_snmp_packetErrors                      OK
-> check_centreon_snmp_process                           OK
-> check_centreon_snmp_process_detailed                  OK
-> check_centreon_snmp_remote_storage                    OK
-> check_centreon_snmp_TcpConn                           OK
-> check_centreon_snmp_traffic                           OK
-> check_centreon_snmp_uptime                            OK
-> check_centreon_snmp_value                             OK
-> check_meta_service                                    OK
-> check_snmp_cpfw.pl                                    OK
-> check_snmp_load.pl                                    OK
-> check_snmp_mem.pl                                     OK
-> check_snmp_process.pl                                 OK
-> check_snmp_processus_loaded.pl                        OK
-> check_snmp_script_result.pl                           OK
-> check_snmp_storage.pl                                 OK
-> check_snmp_win.pl                                     OK
-> process-service-perfdata                              OK
-> submit_host_check_result                              OK
-> submit_service_check_result                           OK

Do you want to install Centreon Plugins ?

[y/n], default to [y]:y
Installing Centreon Plugins on ‘/usr/local/nagios/libexec’ OK

————————————————————————
                     Start Traps Handler Installation
————————————————————————

Preparing Oreon Plugins…
-> fill_trapDB
-> genSnmpttConfFile
-> trapHandler

Do you want to install Centreon Traps Plugins ?

[y/n], default to [y]:y

[y/n], default to [y]:y
Installing Centreon Traps Plugins on
/usr/local/nagios/libexec/traps created                    OK

Where is your SNMP configuration file?
default to [/etc/snmp/]:

Moving snmptrapd.conf to /etc/snmp/                        OK
/etc/snmp/centreon_traps created                           OK
Moving snmptt.ini to /etc/snmp/centreon_traps/             OK
Moving snmp.conf to /etc/snmp/                             OK
Moving snmptt to /usr/sbin/                                OK
Moving snmpttconvertmib to /usr/sbin/                      OK
/usr/local/nagios/libexec/traps/’                          OK
Finding Centreon Plugins configuration file ‘centreon.conf’OK
You already seem to have installed the plugins Centreon.
Do you want overwrite this file ? You must regenerate this one from Centreon interface.
[y/n], default to [n]:

/usr/local/centreon/filesGeneration/nagiosCFG already existPASSED
/usr/local/centreon/filesUpload/nagiosCFG already exists   PASSED

————————————————————————
                       Start ODS Installation
————————————————————————
Checking ODS data folder :
Creating Centreon Directory ‘/var/lib/ods’                 OK
Checking ODS database folder :
Creating Centreon Directory ‘/var/lib/ods/database/’       OK
Checking ODS log folder :
Creating Centreon Directory ‘/var/log/ods/’                OK
Replace ODS Macro                                          OK
Install ODS Binary                                         OK
Set ODS properties                                         OK

————————————————————————
                    Replace Macro In ODS cron script
————————————————————————
in /usr/local/centreon/cron/inventory_update.php           OK
in /usr/local/centreon/cron/reporting/ArchiveLogInDB.php   OK
in /usr/local/centreon/cron/parsing_status.pl              OK
in /usr/local/centreon/cron/parsing_log.pl                 OK

————————————————————————
                       Start Centreon Cron Configuration
————————————————————————
Specify user do you use for Centreon cron
/usr/local/centreon/filesGeneration/nagiosCFG already existPASSED
/usr/local/centreon/filesUpload/nagiosCFG already exists   PASSED

————————————————————————
                       Start ODS Installation
————————————————————————
Checking ODS data folder :
Creating Centreon Directory ‘/var/lib/ods’                 OK
Checking ODS database folder :
Creating Centreon Directory ‘/var/lib/ods/database/’       OK
Checking ODS log folder :
Creating Centreon Directory ‘/var/log/ods/’                OK
Replace ODS Macro                                          OK
Install ODS Binary                                         OK
Set ODS properties                                         OK

————————————————————————
                    Replace Macro In ODS cron script
————————————————————————
in /usr/local/centreon/cron/inventory_update.php           OK
in /usr/local/centreon/cron/reporting/ArchiveLogInDB.php   OK
in /usr/local/centreon/cron/parsing_status.pl              OK
in /usr/local/centreon/cron/parsing_log.pl                 OK

————————————————————————
                       Start Centreon Cron Configuration
————————————————————————
Specify user do you use for Centreon cron
Default to [nagios]
no crontab for nagios
You old crontab is backup on /tmp/crontab_nagios.G22876 file

————————————————————————
                            Configure Sudo
————————————————————————
Finding nagios init script :                               /etc/init.d/nagios
Configuring Sudo                                           OK

————————————————————————
                          Centreon Post Install
————————————————————————
Finding mail binary : /usr/bin/mail                        OK
Finding rrdtool binary : /usr/bin/rrdtool                  OK
Create /usr/local/centreon/www/install/installoreon.conf.phOK
Create /etc/oreon.conf                                     OK
Configuring Oreon post-install                             OK

######################################################
#      Go to the URL : http://your-server/oreon/                                              #
#                   or http://your-server/centreon/ to finish the setup                 #
#                                                                                                                              #
#                    Report bugs at bugs@oreon-project.org                                      #
#                           Thanks for using Centreon.                        #
#                             ———————–                         #
#                        Contact : infos@oreon-project.org                    #
#                            http://www.centreon.com                          #

Now, proceed to the final step of configuring the setup parameters and database here

4. Configure Setup Parameters & Database

Install pre-requisites for Centreon Network Monitoring in Debian

admin — Sat, 19 Jan 2008 21:22:22 +0000

Step 1 of installing Centreon Network Monitoring system covers the installation of Pre-Requisites. Centreon Network Monitoring system has a pre-requisites that needs to be included before we actually start installing the centreon binaries.

The following are the list of pre-requisites for Centreon

gcc & make  

Sudo  

Nagios 1.x / 2.x  

Nagios-plugins 1.3.x / 1.4.x  

Apache 2.x  

MySQL 3.x / 4.x / 5.x  

PHP 4.x / 5.x  

GD, GD-devel, libgd2,libpng, libpng-devel  

RRDTool 1.2  

Net-SNMP

PHP modules php-mysql php-pear php-snmp php-posix

Perl Modules

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

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

So lets get started

Install GNU Compiler Collection

debian4r2:~# aptitude install gcc

Install Make package

debian4r2:~# aptitude install make

Install Sudo

debian4r2:~# aptitude install sudo

Install Apache 2 Webserver

debian4r2:~# aptitude install apache2

Install MySQL Database Server

debian4r2:~# aptitude install mysql-server

Install PHP 5

debian4r2:~# aptitude install php5

Install PHP5 modules

debian4r2:~# aptitude install php5-mysql php5-pear php5-snmp php5-posix php5-gd

Install RRD Tool

debian4r2:~# aptitude install rrdtool

Install Net-SNMP

debian4r2:~# aptitude install snmp snmpd libnetsnmp-perl

Install NMap

debian4r2:~# aptitude install nmap

Install Perl Modules

debian4r2:~# aptitude install libgd-gd2-perl libnet-snmp-perl librrds-perl

Install PEAR packages

debian4r2:~# pear install -o -f –alldeps DB DB_DataObject DB_DataObject_FormBuilder MDB2 Date Numbers_Roman Numbers_Words HTML_Common HTML_QuickForm HTML_QuickForm_advmultiselect HTML_Table Auth_SASL HTTP Image_Canvas Image_Color Image_Graph Image_GraphViz Mail Mail_Mime Net_SMTP Net_Socket Net_Traceroute Net_Ping Validate XML_RPC SOAP Mail_Mime-1.3.1 HTML_Table-1.6.1 Numbers_Roman-1.0.1

That installs all the pre-requisites for Centreon network monitoring system to run properly on Debian.

Follow the procedures below to

Step 2. Install and Configure Nagios 2.x on Debian 4.0 with Apache2

Step 3. Install Centreon binaries

Step 4. Configure Setup Parameters & Database

OpenSource NetMonitoring » network-monitoring

vnStat PHP Frontend – Install & Config Webinterface for vnStat

Related Post

Install and run vnStat as a Non-Root user

Related Post

vnStat Network traffic/Bandwidth Monitoring for Linux

Related Post

Install & Configure Centreon Network Monitoring in Debian

Related Post

Configure Centreon setup and database

Related Post

Install Centreon Network Monitoring binaries in Debian

Related Post

Install pre-requisites for Centreon Network Monitoring in Debian

Related Post