Thursday, November 20, 2008
Thanks for choosing to install the simplest and most stable monitoring software that you will ever use.

The installation guide below will give you a hassle free way to manage your machines so you can focus on the fun stuff you really want to work on.


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 /etc/monitorsuite/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