|
|
Line 1: |
Line 1: |
| {{Ebuild | | {{Person |
| |Summary=a utility for monitoring and managing daemons or similar programs running on a Unix system. | | |Geoloc=47.78129, 7.34687 |
| |CatPkg=app-admin/monit | | |Location name=Illzach |
| |Maintainer= | | |Blogs= |
| }} | | }} |
| [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}}
| |