FAQs

How can I change the password of nagiosadmin user?

Open a DOS command prompt
Change working directory to the Nagwin installation directory\bin
Run the following command to update the password:

htpasswd2 -b /etc/lighttpd/htpasswd nagiosadmin new-password

view

How can I get notified by e-mail in Nagwin ?

Nagwin has blat smtp mailer included. The first step is to let blat save your smtp server settings for later use:

bin/blat -SaveSettings -f from-address -server your.smtp.server -u login -pw password

You need also to specify your e-mail address for the contact nagiosadmin in etc/nagios/nagwin/contacts.cfg:

define contact{
        contact_name   nagiosadmin ; .....
        use generic-contact ; .....
        alias Nagios Admin ; .....
        email ******@******    ; << CHANGE THIS TO YOUR EMAIL ADDRESS
}

As a last step, You need to update smtp server information in two notification commands etc/nagios/nagwin/commands.cfg:

# 'notify-host-by-email' command definition
define command{
    command_name    notify-host-by-email
    command_line    /usr/bin/printf "%b" "***** Nagios *****\n\nNotification Type: $NOTIFICATIONTYPE$\nHost: $HOSTNAME$\nState: $HOSTSTATE$\nAddress: $HOSTADDRESS$\nInfo: $HOSTOUTPUT$\n\nDate/Time: $LONGDATETIME$\n" | /bin/blat - -to $CONTACTEMAIL$ -subject "** $NOTIFICATIONTYPE$ Host Alert: $HOSTNAME$ is $HOSTSTATE$ **" -server smtp.server
    }

# 'notify-service-by-email' command definition
define command{
    command_name    notify-service-by-email
    command_line    /usr/bin/printf "%b" "***** Nagios *****\n\nNotification Type: $NOTIFICATIONTYPE$\n\nService: $SERVICEDESC$\nHost: $HOSTALIAS$\nAddress: $HOSTADDRESS$\nState: $SERVICESTATE$\n\nDate/Time: $LONGDATETIME$\n\nAdditional Info:\n\n$SERVICEOUTPUT$\n" | /bin/blat - -to $CONTACTEMAIL$ -subject "** $NOTIFICATIONTYPE$ Service Alert: $HOSTALIAS$/$SERVICEDESC$ is $SERVICESTATE$ **" -server smtp.server
    }

Replace smtp.server by name/ip of your smtp server (your Exchange server for example). Make sure that your smtp server is configured to accept smtp requests from Nagwin machine.

Restart the Nagwin_Nagios service to apply changes.

You can issue the command below to test if your mail notification works:

echo "Test message" | bin\blat - -to mail@address -f from@address -subject "Test mail" -server smtp.server

view

How to monitor Nagwin itself ?

As you use Nagwin to monitor other hosts, you may wonder how the Nagwin itself can be monitored. This can be achieved by checking status.dat file age and existence of key processes. Here is a recipe to establish an out-of-band monitoring of Nagwin:

Make sure that your Nagwin installation is configured to send notifications. See FAQ for instructions.
Create bin/check_nagwin.sh script with the content below (Unix-format):

#!/bin/bash

# customize - start

to=your@email.address

from=from@email.address

server=smtp.server

# customize - end

instroot=$(cygpath -m /)

logdir=/var/log/check_nagwin

mkdir -p $logdir

logfile=$logdir/$(date +"%d").log

echo "***" `date` >> $logfile

# Function to report failure, message body as argument

CheckFail ()

{

printf "$1" | /bin/blat - -to $to -f $from -subject "Nagwin is not operational" -server $server >> $logfile

exit 1

}

# Function to check a process, process name and expected number of instances as arguments

CheckProcess ()

{

/plugins/check_winprocess --filter "imagename eq $1.exe" --compare lt --critical $2 >> $logfile

if (($? > 0)); then

CheckFail "Must be at least $2 $1 process(es) running."

}

# check status.dat age

/plugins/check_winfile --target "$instroot/var/opt/nagios/status.dat" --filter "age lt -15 minutes" --critical 1 --compare eq >> $logfile

if (($? > 0)); then

CheckFail "Nagios status.dat getting old."

# check processes

CheckProcess nagios 4

CheckProcess lighttpd 1

printf "\n" >> $logfile

You need to customize mail configuration (red) according to your setup. The script above checks if status.dat is updated within the last 15 minutes and if key processes are running with an expected number of intances. It will send an e-mail if any of the criteria are not met. Results from checks will be logged in /var/log/check_nagwin directory in a rotating manner for days of a month.