 
                       M/Monit version 2.x
 
 Introduction
 ------------
 
 M/Monit is a system for automatic management and monitoring of
 Information Technology Systems. M/Monit can monitor and manage
 distributed computer systems, conduct automatic maintenance and
 repair and execute meaningful causal actions in error situations.
 
 M/Monit expand upon Monit's capabilities to provide monitoring
 and management of all Monit enabled hosts from one easy to use
 web-interface.
 
 
 System requirements
 -------------------
 
 * M/Monit requires Monit as an agent. A Monit agent send status
   periodically and events immediately to M/Monit which collects
   the information in its database. The Monit agent software must
   be version 5.0.3 or later and installed on all hosts M/Monit
   should monitor. Download Monit from http://mmonit.com/monit/
 
 * Supported Platforms
 
   See: http://mmonit.com/wiki/MMonit/SupportedPlatforms
 
 * Memory and Disk space
  
   A minimum of 8 megabytes RAM are required and around 20 MB of
   free disk space. You may need more RAM depending on how many
   processor threads the M/Monit server is started with and the
   number of Sessions that are used.
 
 * Accurate time keeping
  
   M/Monit use the time of day for reporting and monitoring and
   it is recommended to investigate if your system clock has the
   correct time and maybe set some time synchronization facility
   on your system.
 
 * Random Device
  
   A random device is needed for creating universal unique and
   cryptographically strong HTTP (and SSL) Session identifiers
   and the Server will complain and exit if it cannot find
   /dev/random or /dev/urandom on the system.
 
 * M/Monit depends only on the C-libraries installed on all POSIX
   systems.
 
 
 Installation
 ------------
 
 M/Monit comes pre-configured and should run right out of the
 box. Simply unpack the M/Monit tar file into a location so that
 the distribution resides in its own directory.
 
 M/Monit utilize Monit as an agent and Monit should be installed
 on all hosts you want M/Monit to manage and monitor.


 Getting started
 ---------------

 1) Watch the M/Monit screen-cast at http://mmonit.com/screencast/
    The user manual can be found at http://mmonit.com/documentation/

 2) Start M/Monit: <mmonit-home>/bin/mmonit start 
    Point your browser to http://localhost:8080/ and login as user admin
    with password swordfish. Make sure that javascript is turned on and
    that your browser accept cookies.

 3) How to make Monit post events and automatically register itself with
    M/Monit. Put the following into your Monit control file, .monitrc:

     set eventqueue basedir /var/monit slots 1000
     # Specify the URL for posting events to M/Monit. The auth. part of
     # the URL, that is, monit:monit, specify a username and password
     # registered in M/Monit. If you change the password for the monit
     # user in M/Monit it must be changed here as well.
     set mmonit http://monit:monit@<M/Monit-host>:8080/collector
     set httpd port 2812 and use address <monit-host>
         allow localhost
         allow <M/Monit-host>
         allow username:password

    where <M/Monit-host> and <monit-host> is the host name or IP-address
    of the host running respectively M/Monit and Monit. For extra
    security you can also configure Monit to use SSL. See also the M/Monit
    manual at http://mmonit.com/documentation/ for more information.
 
 See also the manual at http://mmonit.com/documentation/mmonit_manual.pdf
 
 
 Database note
 -------------
 
 The Database Connection Pool library (libzdb) used by M/Monit is built
 with support for the following database systems: SQLite version 3.x,
 MySQL version 5.x - 5.1.30 and PostgreSQL version 8.x.

 If you want to use M/Monit with another database than the default
 SQLite see this wiki article http://mmonit.com/wiki/MMonit/Setup
 
 If your database version is not supported, you can download and build
 the Connection Pool library from source and replace lib/libzdb.x with
 your own version. See http://mmonit.com/wiki/ and the manual for
 details.


 Reporting a bug
 ---------------
 
 If you believe you have found a bug, please use this bug report form,
 https://mmonit.fogbugz.com/default.asp?pg=pgPublicEdit
 
 
 Contact information
 -------------------
 
 The M/Monit software is a product of Tildeslash Ltd. a Company
 registered in Norway and in United Kingdom.
 
 For further information about this Software, please use the following
 contact information.
 
 E-mail:
   mmonit@tildeslash.com
 
 Telefax:
   All inquiries: +47 22 71 29 99
 
 Internet:
   http://www.tildeslash.com/
   
 
 Acknowledgments
 ---------------
 
 This product includes software developed by the OpenSSL Project for 
 use in the OpenSSL Toolkit (http://www.openssl.org/)
 
 This product includes and use libevent developed by Niels Provos et.
 al. (http://www.monkey.org/~provos/libevent/)
 
 This product use parts of the CII software library developed by
 David R. Hanson. (http://www.cs.princeton.edu/software/cii/)
 
 This product includes Clearsilver, developed by Brandon Long.
 (http://www.clearsilver.net/)
 
 This product includes SQLite developed by D. Richard Hipp et. al.
 (http://www.sqlite.org/)
 
 This product includes The Yahoo! User Interface Library (YUI), 
 developed by Yahoo! Inc. (http://developer.yahoo.com/yui/)

 This product includes libzdb, a Database Library developed by
 Tildeslash. (http://www.tildeslash.com/libzdb/)

 This product includes Zild App Server created by Tildeslash. The
 design and architecture of Zild was inspired by the Tomcat Servlet
 Container by the Apache Software Foundation (http://www.apache.org/)
