Agenda: nagios-exercises.txt

NAGIOS MONITORING
-----------------

On Master server

1. Go to Nagios working directory

        # cd /usr/local/etc/nagios
        
2. Copy Nagios sample files

        To do this, make sure you are in Nagios working directory from the first step
        There are Nagios's sample files in the directory, which we need to copy them 
        as working copies:
        
        # cp cgi.cfg-sample cgi.cfg
        # cp nagios.cfg-sample nagios.cfg
        # cp resource.cfg-sample resource.cfg
        # cp objects/commands.cfg-sample objects/commands.cfg
        # cp objects/contacts.cfg-sample objects/contacts.cfg
        # cp objects/localhost.cfg-sample objects/localhost.cfg
        # cp objects/templates.cfg-sample objects/templates.cfg
        # cp objects/timeperiods.cfg-sample objects/timeperiods.cfg

        
3. Create monitoring configuration files for DNS Servers 

        While are you still in Nagios working directory, create a new file for DNS servers monitoring
        
        Change the following below:
                xx:     your group number
                yy:     group number of your slave server
                MYTLD:  your zone name
        
        # Edit objects/dns-servers.cfg
        
- - - - - - - - - - - - - - - - - cut below - - - - - - - - - - - - - - -

### Define the host server

define host{
        use                     freebsd-server
        host_name               master
        alias                   master
        address                 10.10.xx.1
}

define host{
        use                     freebsd-server
        host_name               cache
        alias                   cache
        address                 10.10.xx.2
}

define host{
        use                     freebsd-server
        host_name               slave
        alias                   slave
        address                 10.10.YY.1
}

### Define the group

define hostgroup{
        hostgroup_name  dns-servers
        alias           DNS Servers
        members         cache,master,slave
}

### Define Services

define service {
        use                             generic-service         ; Name of service template to use
        hostgroup_name                  dns-servers
        service_description             PING
        check_command                   check_ping!100.0,20%!500.0,60%
}

define service {
        use                             generic-service         ; Name of service template to use
        hostgroup_name                  dns-servers
        service_description             Check DNS
        check_command                   check_dns!www.MYTLD
}

- - - - - - - - - - - - - - - - - cut end - - - - - - - - - - - - - - -

4. Add check_dns service

        By default, Nagios doesn't configure check_dns service, we need to add line below into commands.cfg
        
        # Edit objects/commands.cfg

        - Place this below the check_nt service check definition:

- - - - - - - - - - - - - - - - - cut below - - - - - - - - - - - - - - -

define command{ 
        command_name    check_dns
        command_line    $USER1$/check_dns -s $HOSTADDRESS$ -H $ARG1$
}

- - - - - - - - - - - - - - - - - cut end - - - - - - - - - - - - - - -

5. Enable DNS monitoring group in Nagios configuration files

        Now you have DNS Server monitoring files (dns-server.cfg) created. We need to enable on nagios.cfg file for monitoring
        
        # Edit /usr/local/etc/nagios/nagios.cfg

        Look for the line "cfg_file=/usr/local/etc/nagios/objects/localhost.cfg" and add below content
        
- - - - - - - - - - - - - - - - - cut below - - - - - - - - - - - - - - -

# Definition for DNS servers
cfg_file=/usr/local/etc/nagios/objects/dns-servers.cfg

- - - - - - - - - - - - - - - - - cut end - - - - - - - - - - - - - - -

 
6. Enable Nagios service 

        To enable nagios service add the line below in /etc/rc.conf
        
        nagios_enable="YES"
        
        
7. Start Nagios service

        To start nagios service
        
        # /usr/local/etc/rc.d/nagios start
        
        Nagios should be running right now without any error report.


#. Create Apache password authentication file for Nagios 

        Nagios required authentication via http to gain admin access to it web interface. 
        Let's create the password file
        
        # htpasswd -c /usr/local/etc/apache22/nagios.auth nagiosadmin
        
        Set your desire password (perhaps, use the class password)
        
        Password file is now created
        
#. Create Nagios' Apache configuration for web interface access

        Go to Apache Include directory 
        
        # cd /usr/local/etc/apache22/Include

        There is already a nagios.conf file. We need to update this. The
        simplest method is to remove and rebuild the file as our new 
        configuration is significantly different. To do this do:

        # rm nagios.conf
        
        Then edit the file:
        
        # Edit Includes/nagios.conf
        
        Add the lines below into the file: 
        
- - - - - - - - - - - - - - - - - cut below - - - - - - - - - - - - - - -

AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps

ScriptAlias /nagios/cgi-bin/ /usr/local/www/nagios/cgi-bin/
Alias /nagios/ /usr/local/www/nagios/

<Directory "/usr/local/www/nagios/cgi-bin">
        Options ExecCGI
        AllowOverride None
        Order allow,deny
        Allow from all
        AuthName "Nagios Access"
        AuthType Basic
        Require valid-user
        AuthUserFile /usr/local/etc/apache22/nagios.auth
</Directory>

<Directory "/usr/local/www/nagios">
        AllowOverride None
        Order allow,deny
        Allow from all
        AuthName "Nagios Access"
        AuthType Basic
        Require valid-user
        AuthUserFile /usr/local/etc/apache22/nagios.auth
</Directory>

- - - - - - - - - - - - - - - - - cut end - - - - - - - - - - - - - - -

        # In /usr/local/etc/apache22/httpd.conf, find the line:

DirectoryIndex index.html
        
        And change it to:
        
DirectoryIndex index.html index.php

        # Enable and start Apache web service
        Add into /etc/rc.conf
        apache22_enable="YES"
        
        # /usr/local/etc/rc.d/apache22 start
        
        Access to Nagios web page via http://10.10.xxx.1/nagios/index.php

        You will need to user "nagiosadmin" as the user and the password you 
        specified previously using the "htpasswd" command.

        Take a looking around the Nagios interface to see what is being 
        reported.