QUICK START
-----------

This readme serves as a quick start, please use `man monit' for
documentation on the program.


Installation:
-------------

  -  ./configure
  -  make
  -  make install
  -  man monit

This will install monit and the man-file in /usr/local/bin and
/usr/local/man/man1 respectively. If you want another location than
/usr/local, run configure with the prefix options, like so:
./configure --prefix=<dir>

Notes:
------

- This directory contains an example monit control file, called monitrc.

- monit contains a small http server (see the man page for how to set
  this up). This server is useful for checking status and managing
  programs watched by monit and also to check monit itself.

  Besides providing status for the monit daemon, you can use the http
  server to test if monit is running. Here's a Perl "one-liner" you
  can use to test monit (for example from cron). You should change the
  host and portnumber to match your setup, and you will probably want
  another type of reporting.

  perl -MIO::Socket -e '
   $s= IO::Socket::INET->new(PeerAddr => localhost, PeerPort => 2812) 
   or die "monit is down\n";
   printf("monit is up\n");'

- monit use threads to provide HTTP support and for interprocess
  communication. You will need a system that support POSIX threads
  (pthread) to compile monit. Normally, this should not be a problem
  since most Unix systems comes with pthreads installed.

- monit will probably work on most Unix systems. However, monit is
  tested and known to compile and operate on; Linux, FreeBSD and
  Solaris.


License Notes:
--------------

This software product is licensed under the GNU General Public License
(GPL). This license gives you the freedom to use this product and have
access to the source code. You can modify this product as you see fit
and even use parts in your own software. If you choose to do so, you
also choose to accept that a modified product or software that use any
code from monit MUST also be licensed under the GNU General Public
License.

In plain words, you can NOT sell or distribute monit, a modified
version or any software product based on any parts of monit as a
closed source product. Likewise you cannot re-license this product and
derivates under another license other than GNU GPL.

See also the article, "Free Software Matters: Enforcing the GPL" by
Eben Moglen. http://emoglen.law.columbia.edu/publications/lu-13.html


Product Support:
----------------

If you have questions or comments about the software or documentation
please subscribe to the monit general mailing list:

   http://mail.freesoftware.fsf.org/mailman/listinfo/monit-general

You can also look in the mailing list archive for answers:

      http://mail.freesoftware.fsf.org/pipermail/monit-general/


          ---------------------------------------------
