Location: PHPKode > projects > WhoisUP > whoisup/INSTALL.txt
What is it?
WhoisUP monitors hosts via ICMP and shows the status in a web page. When a host is down, the script can send mail, syslog message, open a popup message or play a sound. 


When use it?
WhoisUP is useful to monitor hosts (PC, Server, NAS, Router, Switch and so on...) and to receive alerts when a host go down. 


Is it OS dependent?
No, the script works on Windows, Linux, ... 


How works WhoisUP?
The script uses NMap to send ICMP packets and to save the host status into an XML file. Then, WhoisUP reads the XML and shows the report in a web page with AJAX features; in case of host failure the script can send alarms. 


Requirements: 
•WEB Server (Apache, ISS, ...) 
•PHP 5 >= 5.1.0 
•NMAP 


Components used: 
* JQuery for Ajax interactions 
* Nmap to check the host status 
* PHPMailer to send mail 
* Timezone-Selector to generate select input to choose a time zone 


How to install it? 
1. Unzip the files and place them on your webserver 
2. Set the 'TMP' and 'conf' folders to chmod 777 (on *nix systems) or to writable permission (on Windows systems) 
3. Set the files into 'conf' and 'TMP' folders to chmod 777 (on *nix systems) or to writable permission (on Windows systems) 
4. Go to the page htttp://[name-of-your-host]/whoisup/admin.php 
5. Login with the default key: 'whoisup' 
6. Compile the fields and change the secret key 
7. Enable the core.php script in background. You have two ways to do it: 
  * Call the core.php script using the php command line with administrative/root privileges; for instance: 
    php \var\www\html\whoisup\core.php [your-secret-key]
  * Call the core.php using a browser (Explorer, Chrome, Firefox, ...); for instance open the page
    http://[name-of-your-host]/whoisup/core.php?secret=[your-key]
    This is the worst method, because the webserver must run with administrative/root privileges. 
8. To see the host status, go to the page http://[name-of-your-host]/whoisup/ 


Syntax format 
* The 'EmailToField' list must follow this syntax, for instance: 
hide@address.com
hide@address.com
hide@address.com

* The IP address list must follow this format: [host-ip] # [host-name] 
For instance:
192.168.1.1 # my-route
8.8.8.8 # google-dns
123.123.123.123 # test-host


Remember: 
* If you stop the core.php script, you don't receive any alarms (mail or syslog message) and the index page (http://[name-of-your-host]/whoisup/) is not updated! 
* The index page (http://[name-of-your-host]/whoisup/) is only used to see the host status. It is not needed open the index page to receive alarms. 


Licence: This program is free software and it is released under the GPLv2 


Author: Fabio Semperboni
Return current item: WhoisUP