/**********************************************************************
*                      PSI - PHP Simple Informer                      *
*                              Version 0.1                            *
*                   By Pablo Godel - pablo@godel.com.ar               *
*                    http://www.godel.com.ar/psi                      *
*                                                                     *
*          This is code is distributed under the GPL license          *
**********************************************************************/

README
------

PSI - PHP Simple Informer is a very simple network services monitoring 
application written in PHP. It can be run as a command line application 
(PHP compiled as cgi is required) or as a web php file.

Although is very simple, it does its function very well. Is very easy to 
configure with a single file and a couple of simple lines.

I don't know if this is going to be useful for anybody, but it's for me. I 
have been testing several applications, and all of them are more complex 
that what I need or they don't perform so simple tasks.

FEATURES
--------
- Very simple installation and configuration: one single config file and done.
- Multiple hosts configuration
- Multiple contacts configuration
- Alerts are send by email or with a executed command.

DOWNLOAD
--------
http://www.godel.com.ar/psi/psi-0.1.tar.gz

INSTALLATION
------------
- Unpack the file psi-0.1.tgz in your desired final location:
$ gunzip -c psi-0.1.tar.gz | tar xf -
$ cd psi

- Configure psi.conf (Read the info and examples inside the file)
$ vi psi.conf

- And run psi.php (php compiled as a cgi and placed in /usr/local/bin/php is 
required)
$ ./psi.php

- Place it in crontab to run it periodically.

FAQ
---
1) What is PSI - PHP Simple Informer ?
It's a very simple and basic network services monitoring application. It can 
check tcp ports for the moment.

2) Why is written in PHP ?
Because it's a great scripting language and I love it! Simple, fast to write 
and very powerful! 
More info at http://www.php.net

3) Why another network services monitoring program ?
Because all of the available applications are more complex that what I need or 
they don't perform so simple tasks. I don't know if this application is useful 
for anybody, but it is for me.

4) When I set to receive alters by emails, I never receive them.
Check that PHP is properly configured to use a mail delivery system (sendmail?)
 in the php.ini file. Test the following quick script to see if PHP sends 
 emails correctly:

< ?php 
	mail("me@domain.com", "Test", "Testing");
? >
And watch your email log files to see if the email is sent correctly.

5) Why this page sucks?
Because I don't have time to put it better.

BUGS
----
Probably not much because the program is so simple. But if found, report to 
pablo@godel.com.ar

TODO
----
If I get spare time, I will add more features like:
- Logging to a file or maybe a DB to have a history and be able to make 
  graphics.
- Create a webpage to check the status.
- Create a web-based administration interface.
- Any more ideas? 

CONTACT
-------
If you like this little application,  have ideas, comments or want to help, 
please contact me, I want to hear about you.

Pablo Godel 
pablo@godel.com.ar
http://www.godel.com.ar/psi/