Difference between pages "User:Duncan.britton" and "Package:Monit"
Threesixes (talk | contribs) (initial commit) |
|||
Line 1: | Line 1: | ||
{{ | {{Ebuild | ||
| | |Summary=a utility for monitoring and managing daemons or similar programs running on a Unix system. | ||
| | |CatPkg=app-admin/monit | ||
|Maintainer= | |||
| | |||
}} | }} | ||
| | [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
Monit
We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.
Monit is a utility for managing and monitoring processes, programs, files, directories and filesystems on a UNIX system.
Installation
Emerge
To install app-admin/monit:
root #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.
root #gpasswd -a $USER monit
root #gpasswd -a $USER users
passwords can be streamed to monits web interface, disable it all together after it is setup
for security purposes change this entry
/etc/monitrc
allow admin:monit
Boot Services
inittab
this is the preferred method to run monit
/etc/inittab
- auto restart monit in case of failureca: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
root #telinit q
OpenRC
prefer inittab method over rc services
To start the service at boot.
root #rc-update add monit default
To start the service immediately.
root #/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 mysqlcheck 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.