Monitor Suite Installation Guide

System Requirements:

Install wget.

Install NET::SMTP Perl module.

Install NET::telnet Perl module.

Install PHP

The following steps are performed as the root user

1. Create a local user named monitorsuite.

   adduser monitorsuite
   
   

2. Extract Files.

   cd /tmp

   tar zxvf monitor_suite.tgz

   
   

3. Install Monitor Suite using install.sh

   Note1: The syntax is: ./install.sh path_to_install_scripts webroot

   Note2: Do not enter a trailing slash for path_to_install_scripts or webroot.

   
   

   ./install.sh /usr/local/admin/bin /var/www

   
   

4. Edit the main config file, /etc/monitorsuite/monitor_suite.conf

   Set at least one SMTP server (i.e SMTP1) to send alerts through.

   Set RECIPIENT and CC (optional) to the email address receiving alerts.

   You may ignore any other entries in this file.

   
   

5. Add Services you wish to monitor

   Edit webroot/webmon/conf/urls.txt to add HTTP URLS to monitor

   Edit webroot/dnsmon/conf/dnsservers.txt to add DNS Servers URLS to monitor

   Edit webroot/smtpmon/conf/smtpservers.txt to add SMTP Servers to monitor

   
   

6. For monitor_dns.sh only:

   Edit webroot/dnsmon/conf/monitor_dns.conf

   Set HOSTCHECK as the Defined host to check for DNS queries.

   
   

7. To Complete installation set up each script to run in cron for the user monitorsuite.

   crontab -e -u monitorsuite
   

   0,10,20,30,40,50 * * * * /bin/monitor_web.sh > /webroot/webmon/monitor_web.log 2>&1
   0,10,20,30,40,50 * * * * /bin/monitor_dns.sh > /webroot/dnsmon/monitor_dns.log 2>&1
   0,10,20,30,40,50 * * * * /bin/monitor_smtp.sh > /webroot/smtpmon/monitor_smtp.log 2>&1
   

   
   

8. Monitor Suite DashBoard for each service (dns,smtp,web) will be available at:

   http://yourwebserver/xxxmon/xxxmon.php

   I.E http://yourwebserver/webmon/webmon.php