Update restore files.
[carnet-upgrade.git] / files / etc / monit / monitrc.restore
index ecd096d..4a5dacc 100644 (file)
@@ -5,43 +5,43 @@
 ## Comments begin with a '#' and extend through the end of the line. Keywords
 ## are case insensitive. All path's MUST BE FULLY QUALIFIED, starting with '/'.
 ##
-## Bellow is the example of some frequently used statements. For information
-## about the control file, a complete list of statements and options please 
-## have a look in the monit manual.
+## Below you will find examples of some frequently used statements. For 
+## information about the control file, a complete list of statements and 
+## options please have a look in the monit manual.
 ##
 ##
 ###############################################################################
 ## Global section
 ###############################################################################
 ##
-## Start monit in background (run as daemon) and check the services at 2-minute
-## intervals.
+## Start monit in the background (run as a daemon) and check services at 
+## 2-minute intervals.
 #
 # set daemon  120
 #
 #
 ## Set syslog logging with the 'daemon' facility. If the FACILITY option is
-## omited, monit will use 'user' facility by default. You can specify the
-## path to the file for monit native logging.
+## omitted, monit will use 'user' facility by default. If you want to log to 
+## a stand alone log file instead, specify the path to a log file
 #
-# set logfile syslog facility log_daemon 
+# set logfile syslog facility log_daemon                       
 #
 #
-## Set list of mailservers for alert delivery. Multiple servers may be 
-## specified using comma separator. By default monit uses port 25 - it is 
-## possible to override it with the PORT option.
+## Set the list of mail servers for alert delivery. Multiple servers may be 
+## specified using comma separator. By default monit uses port 25 - this
+## is possible to override with the PORT option.
 #
 # set mailserver mail.bar.baz,               # primary mailserver
 #                backup.bar.baz port 10025,  # backup mailserver on port 10025
 #                localhost                   # fallback relay
 #
 #
-## By default monit will drop the event alert, in the case that there is no
-## mailserver available. In the case that you want to keep the events for
-## later delivery retry, you can use the EVENTQUEUE statement. The base
-## directory where undelivered events will be stored is specified by the
-## BASEDIR option. You can limit the maximal queue size using the SLOTS
-## option (if omited then the queue is limited just by the backend filesystem).
+## By default monit will drop alert events if no mail servers are available. 
+## If you want to keep the alerts for a later delivery retry, you can use the 
+## EVENTQUEUE statement. The base directory where undelivered alerts will be 
+## stored is specified by the BASEDIR option. You can limit the maximal queue
+## size using the SLOTS option (if omitted, the queue is limited by space 
+## available in the back end filesystem).
 #
 # set eventqueue
 #     basedir /var/monit  # set the base directory where events will be stored
 ## monit                                     #
 ## --8<--
 ##
-## You can override the alert message format or its parts such as subject
+## You can override this message format or parts of it, such as subject
 ## or sender using the MAIL-FORMAT statement. Macros such as $DATE, etc.
-## are expanded on runtime. For example to override the sender:
+## are expanded at runtime. For example, to override the sender:
 #
 # set mail-format { from: monit@foo.bar }
 #
 #
-## You can set the alert recipients here, which will receive the alert for
-## each service. The event alerts may be restricted using the list.
+## You can set alert recipients here whom will receive alerts if/when a 
+## service defined in this file has errors. Alerts may be restricted on 
+## events by using a filter as in the second example below. 
 #
 # set alert sysadm@foo.bar                       # receive all alerts
 # set alert manager@foo.bar only on { timeout }  # receive just service-
 #                                                # timeout alert
 #
 #
-## Monit has an embedded webserver, which can be used to view the 
-## configuration, actual services parameters or manage the services using the 
-## web interface.
+## Monit has an embedded web server which can be used to view status of 
+## services monitored, the current configuration, actual services parameters
+## and manage services from a web interface.
 #
 # set httpd port 2812 and
 #     use address localhost  # only accept connection from localhost
@@ -94,9 +95,9 @@
 ## Services
 ###############################################################################
 ##
-## Check the general system resources such as load average, cpu and memory
-## usage. Each rule specifies the tested resource, the limit and the action
-## which will be performed in the case that the test failed.
+## Check general system resources such as load average, cpu and memory
+## usage. Each test specifies a resource, conditions and the action to be
+## performed should a test fail.
 #
 #  check system myhost.mydomain.tld
 #    if loadavg (1min) > 4 then alert
 #
 #    
 ## Check a file for existence, checksum, permissions, uid and gid. In addition
-## to the recipients in the global section, customized alert will be send to 
-## the additional recipient. The service may be grouped using the GROUP option.
+## to alert recipients in the global section, customized alert will be sent to 
+## additional recipients by specifying a local alert handler. The service may 
+## be grouped using the GROUP option.
 #    
 #  check file apache_bin with path /usr/local/apache/bin/httpd
 #    if failed checksum and 
 #    group server
 #
 #    
-## Check that a process is running, responding on the HTTP and HTTPS request, 
-## check its resource usage such as cpu and memory, number of childrens. 
-## In the case that the process is not running, monit will restart it by 
-## default. In the case that the service was restarted very often and the 
-## problem remains, it is possible to disable the monitoring using the
-## TIMEOUT statement. The service depends on another service (apache_bin) which
-## is defined in the monit control file as well.
+## Check that a process is running, in this case Apache, and that it respond
+## to HTTP and HTTPS requests. Check its resource usage such as cpu and memory,
+## and number of children. If the process is not running, monit will restart 
+## it by default. In case the service was restarted very often and the 
+## problem remains, it is possible to disable monitoring using the TIMEOUT
+## statement. This service depends on another service (apache_bin) which
+## is defined above.
 #    
 #  check process apache with pidfile /usr/local/apache/logs/httpd.pid
 #    start program = "/etc/init.d/httpd start"
 #    group server
 #    
 #    
-## Check the device permissions, uid, gid, space and inode usage. Other
-## services such as databases may depend on this resource and automatical
-## graceful stop may be cascaded to them before the filesystem will become
-## full and the data will be lost.
+## Check device permissions, uid, gid, space and inode usage. Other services,
+## such as databases, may depend on this resource and an automatically graceful
+## stop may be cascaded to them before the filesystem will become full and data
+## lost.
 #
 #  check device datafs with path /dev/sdb1
 #    start program  = "/bin/mount /data"
 #    group server
 #
 #
-## Check a file's timestamp: when it becomes older then 15 minutes, the 
-## file is not updated and something is wrong. In the case that the size 
-## of the file exceeded given limit, perform the script.
+## Check a file's timestamp. In this example, we test if a file is older 
+## than 15 minutes and assume something is wrong if its not updated. Also,
+## if the file size exceed a given limit, execute a script
 #
 #  check file database with path /data/mydatabase.db
 #    if failed permission 700 then alert
 #    if size > 100 MB then exec "/my/cleanup/script"
 #
 #
-## Check the directory permission, uid and gid.  An event is triggered
-## if the directory does not belong to the user with the  uid 0 and 
-## the gid 0.  In the addition the permissions have to match the octal 
-## description of 755 (see chmod(1)).
+## Check directory permission, uid and gid.  An event is triggered if the 
+## directory does not belong to the user with uid 0 and gid 0.  In addition, 
+## the permissions have to match the octal description of 755 (see chmod(1)).
 #
 #  check directory bin with path /bin
 #    if failed permission 755 then unmonitor
 #    if failed gid 0 then unmonitor
 #
 #
-## Check the remote host network services availability and the response
-## content.  One of three pings, a successfull connection to a port and 
-## application level network check is performed.
+## Check a remote host network services availability using a ping test and 
+## check response content from a web server. Up to three pings are sent and 
+## connection to a port and a application level network check is performed.
 #
 #  check host myserver with address 192.168.1.1
 #    if failed icmp type echo count 3 with timeout 3 seconds then alert
 ## Includes
 ###############################################################################
 ##
-## It is possible to include the configuration or its parts from other files or
+## It is possible to include additional configuration parts from other files or
 ## directories.
 #
 #  include /etc/monit.d/*