GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
WATCHMEN(1) User Contributed Perl Documentation WATCHMEN(1)

 watchmen - watch daemons and restart

 watchmen [--configkey=configvalue] [-svcname__svckey=svcvalue] [command[=param]] ...
 where command:
 check[=svc] stop[=svc] restart[=svc] keep[=svc] list avail help
 where svc can be name of service or name of group. if group - all services in this group will be affected

The latest version of watchmen is available from http://code.google.com/p/watchmen/

to use all features , install the following:

 * DBI and DBD::mysql or DBD::Pg or DBD::PgPP
 * LWP::UserAgent and URI::URL
 * Email::Send for mail reports

  sudo portinstall databases/p5-DBD-mysql databases/p5-DBD-Pg www/p5-libwww mail/p5-Email-Send

watchmen check availability of your services and [re]start them if any problems detected.

 * process in ps 
 * tcp or udp socket
 * correct http answer
 * database query execution
 * memory and processes in limit, and reaching maximum of any (numeric) ps columns:  SL  RE PAGEIN   VSZ   RSS   LIM TSIZ %CPU %MEM
 * any custom check

 #check and restart default services
 watchmen

 #list of enabled services
 watchmen list

 #list of available services
 watchmen avail

 #list of available groups
 watchmen group

 #full log
 watchmen --log_all

 #reatart apache if more than 5 httpd proc, dont check sshd, load custom config
 watchmen -apache__max_proc=5 -sshd__enable=0 --config=/path/to/my/config

 #check only 2 services with log
 watchmen check=named check=mysql --log_all 

 #stop all EXCEPT sshd
 watchmen stop

 #stop all services with bluetooth group 
 watchmen stop=bluetooth

 #stop all services in /etc/rc.d
 watchmen stop=system

 #stop all services in /usr/local/etc/rc.d
 watchmen stop=local

 #check services every 5 seconds without exit
 watchmen keep --sleep=5

 #same, only for mysqld
 watchmen keep=mysqld --sleep=5

 recommended libs: LWP, URI
 freebsd: cd /usr/ports/www/p5-libwww && make install clean
 or 
 perl -MCPAN -e "install LWP, URI"


 cp watchmen /usr/local/bin/ ; cp watchmen.conf.dist /usr/local/etc/watchmen.conf
 edit /usr/local/etc/watchmen.conf

 run watchmen twice. second run must be quiet (all ok) if not - edit config

 add to crontab:
 echo "*       *       *       *       *       root    /usr/local/bin/watchmen" >> /etc/crontab
 or line via root's  crontab -e
 *    *       *       *       *       /usr/local/bin/watchmen

 by default some of default services enabled

 read [and edit] watchmen.conf

 you can configure services from /etc/rc.conf[.local] file[s]:
 for config string  $svc{service}{key} = 'value'; write to rc.conf:
 service_key="value"
 example:
 apache22_http="81" 
 #or define new service, with one of correct keys: process tcp udp http https :
 nginx_enable="YES"
 nginx_process="nginx"
 nginx_http="8001"
 nginx_http_check="<html"
 nginx_group="web"

 self pid & check
 /tmp/socketfile check
 various handlers
 rsync --daemon
 more default ports [tested!]
 ?.pid usage?
 identify by process desc (sendmail)
 keep: step by step skip fail checks (http->tcp->proc)
 group once for samba

watchmen Copyright (C) 2008-2010 Oleg Alexeenkov proler@gmail.com

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

2022-04-09 perl v5.32.1

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.