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


Manual Reference Pages  -  WATCHMEN (1)

.ds Aq ’

NAME



 watchmen - watch daemons and restart



CONTENTS

SYNOPSIS



 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



AVAILABILITY

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

REQUIREMENTS

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



DESCRIPTION

<B>watchmenB> 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



EXAMPLES



 #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



INSTALL



 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 roots  crontab -e
 *    *       *       *       *       /usr/local/bin/watchmen



CONFIGURE



 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"



TODO



 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



COPYRIGHT

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/>.

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


perl v5.20.3 WATCHMEN (1) 2016-04-03

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