Difference between pages "User:Duncan.britton" and "Package:Monit"

(Difference between pages)
 
(initial commit)
 
Line 1: Line 1:
{{Person
+
{{Ebuild
|Geoloc=35.611237, -82.540115
+
|Summary=a utility for monitoring and managing daemons or similar programs running on a Unix system.
|Location name=Asheville, NC, United States of America
+
|CatPkg=app-admin/monit
|Blogs=
+
|Maintainer=
|Full name=Duncan Glover Britton
+
|Email=duncan.britton@outlook.com
+
|Roles={{Role
+
|Role type=Contributor
+
|Role desc=Wiki
+
 
}}
 
}}
|Maintains=
+
[http://mmonit.com/monit/ Monit] is a utility for managing and monitoring processes, programs, files, directories and filesystems on a UNIX system.
 +
 
 +
== Installation ==
 +
=== Emerge ===
 +
To install {{Package|app-admin/monit}}:
 +
<console>###i##emerge monit</console>
 +
 
 +
== Configuration ==
 +
Config file of monit resides in <tt>/etc/monitrc</tt>. And there is a item to specify a config directory. Uncomment if needed.
 +
 
 +
{{File|name=/etc/monitrc|desc=config dir|body=
 +
## It is possible to include additional configuration parts from other files or
 +
## directories.
 +
#
 +
#  include /etc/monit.d/*
 +
#
 
}}
 
}}
 +
 +
=== Users ===
 +
Users added to the monit or users group will be able to manipulate monit through the web interface.
 +
 +
<console>###i##gpasswd -a $USER monit</console>
 +
<console>###i##gpasswd -a $USER users</console>
 +
 +
{{fancywarning|passwords can be streamed to monits web interface, disable it all together after it is setup}}
 +
 +
{{fancyimportant|for security purposes change this entry}}
 +
 +
{{file|name=/etc/monitrc|desc=|body=
 +
allow admin:monit}}
 +
 +
== Boot Services ==
 +
=== inittab ===
 +
{{fancynote|this is the preferred method to run monit}}
 +
{{file|name=/etc/inittab|desc=auto restart monit in case of failure|body=
 +
ca:12345:ctrlaltdel:/sbin/shutdown -r now
 +
 +
# Run monit in standard runlevels
 +
mo:2345:respawn:/usr/bin/monit -Ic /etc/monitrc
 +
 +
# Used by /etc/init.d/xdm to control DM startup.
 +
}}
 +
 +
to start monit immediately after changing inittab
 +
 +
<console>###i##telinit q</console>
 +
 +
=== OpenRC ===
 +
{{fancynote|prefer inittab method over rc services}}
 +
To start the service at boot.
 +
<console>###i##rc-update add monit default</console>
 +
To start the service immediately.
 +
<console>###i##/etc/init.d/monit start</console>
 +
 +
==== Monitoring Monit ====
 +
This hourly cron script will check to make sure monit has not crashed.  As this uses pgrep, make sure to not name it monit.
 +
 +
{{file|name=/etc/cron.hourly/moncheck|desc=|body=
 +
#!/bin/bash
 +
if ! pgrep monit >/dev/null;then
 +
rc-service monit restart
 +
fi
 +
}}
 +
 +
== Pidfile Check ==
 +
Monit relies upon pid files. For daemons that do not create a pidfile: a [http://mmonit.com/wiki/Monit/FAQ#pidfile work around] is needed.
 +
 +
== Examples ==
 +
=== Auto Restart Mysql ===
 +
{{file|name=/etc/monitrc|desc=auto restart mysql|body=
 +
check process mysql with pidfile /var/run/mysqld/mysqld.pid
 +
    start program = "/bin/bash -c 'rc-service mysql start'"
 +
    stop program  = "/bin/bash -c 'rc-service mysql stop'"
 +
}}
 +
 +
== Web Interface ==
 +
 +
Navigate to http://localhost:2812/ & login using your edited configuration line or admin / monit if you have not changed it yet.
 +
 +
[[Category:Monitoring]]
 +
{{EbuildFooter}}

Revision as of 04:44, June 27, 2014

app-admin/monit


Source Repository:Gentoo Portage Tree

Summary: a utility for monitoring and managing daemons or similar programs running on a Unix system.

Monit

Monit is a utility for managing and monitoring processes, programs, files, directories and filesystems on a UNIX system.

Installation

Emerge

To install Monit:

#emerge monit

Configuration

Config file of monit resides in /etc/monitrc. And there is a item to specify a config directory. Uncomment if needed.

/etc/monitrc: config dir
## It is possible to include additional configuration parts from other files or
## directories.
#
#  include /etc/monit.d/*
#

Users

Users added to the monit or users group will be able to manipulate monit through the web interface.

#gpasswd -a $USER monit
#gpasswd -a $USER users

Warning

passwords can be streamed to monits web interface, disable it all together after it is setup

Important

for security purposes change this entry

/etc/monitrc
allow admin:monit

Boot Services

inittab

Note

this is the preferred method to run monit

/etc/inittab: auto restart monit in case of failure
ca:12345:ctrlaltdel:/sbin/shutdown -r now

 # Run monit in standard runlevels
 mo:2345:respawn:/usr/bin/monit -Ic /etc/monitrc

# Used by /etc/init.d/xdm to control DM startup.

to start monit immediately after changing inittab

#telinit q

OpenRC

Note

prefer inittab method over rc services

To start the service at boot.

#rc-update add monit default

To start the service immediately.

#/etc/init.d/monit start

Monitoring Monit

This hourly cron script will check to make sure monit has not crashed. As this uses pgrep, make sure to not name it monit.

/etc/cron.hourly/moncheck
#!/bin/bash
if ! pgrep monit >/dev/null;then
rc-service monit restart
fi

Pidfile Check

Monit relies upon pid files. For daemons that do not create a pidfile: a work around is needed.

Examples

Auto Restart Mysql

/etc/monitrc: auto restart mysql
check process mysql with pidfile /var/run/mysqld/mysqld.pid
    start program = "/bin/bash -c 'rc-service mysql start'"
    stop program  = "/bin/bash -c 'rc-service mysql stop'"

Web Interface

Navigate to http://localhost:2812/ & login using your edited configuration line or admin / monit if you have not changed it yet.