Agenda: smokeping-exercise.txt

Smokeping Monitoring
--------------------

On Master Server, access and become root

        $ sudo su -
        
1. Configure Smokeping

        Go to Smokeping's working directory

        # cd /usr/local/etc/smokeping

        Backup Smokeping's original config as we will use a simpler configuration
        
        # mv config config.orig

        Download a smokeping configuration file
        
        # fetch http://noc.ws.nsrc.org/config
        
        Take a look a Smokeping's configuration, it's fairly simple
        
        # less config 

        Edit the file, and find the sections near the bottom where
        it is written '10.10.xx.', and replace these with the IP of your
        group (you should now have 3 functioning DNS servers).

        Have a look at the rest of the file - most of the values have been
        set, but you may want to change your name & email near the top.
        
        Next, we will need to change Smokeping's working directory permission 

        # chown smokeping /usr/local/var/smokeping

2. Enable and Start Smokeping Service 

        Add into /etc/rc.conf

        smokeping_enable="YES"
        
        Start smokeping service 
        
        # /usr/local/etc/rc.d/smokeping start 
        

3. Apache Web Server Configuration for smokeping 

        Go to Apache's working directory 
        
        # cd /usr/local/etc/apache22 
        
        Create a new configuration file for Smokeping:

        # vi Includes/smokeping.conf
        (or ee Includes/smokeping.conf, if you would rather use 'ee')
        
- - - - - - - - - - - - - - - - - cut below - - - - - - - - - - - - - - -

Alias /smokeping/ "/usr/local/smokeping/htdocs/"
AddHandler cgi-script .cgi

<Directory "/usr/local/smokeping/htdocs">
    Options ExecCGI FollowSymLinks
    AllowOverride None
    Order allow,deny 
    Allow from all
</Directory>    

- - - - - - - - - - - - - - - - - cut above - - - - - - - - - - - - - - - 

        Restart apache service for new config to take place
        
        # /usr/local/etc/rc.d/apache22 reload
        
        Access to your smokeping via http://10.10.x.1/smokeping/smokeping.cgi 

        It will take at least 3 - 4 minutes to start receiving data.