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  -  DNSCHECK-DISPATCHER (1)

.ds Aq ’

NAME

dnscheck-dispatcher - daemon program to run tests from a database queue

    SYNOPSIS



    dnscheck-dispatcher [--debug]



    DESCRIPTION

This daemon puts itself into the background (unless the --debug flag is given) and repeatedly queries the table queue in the configured database for domains to test. When it gets one, it spawns a new process to run the tests. If there are no domains to check, or if the configured maximum number of active child processes has been reached, it sleeps 0.25 seconds and then tries again. It keeps doing this until it is terminated by a SIGTERM. At that point, it will wait until all children have died and cleanups been performed before it removes its PID file and then exits.

    OPTIONS

--debug Prevents the daemon from going into the background and duplicates log information to standard output (it still goes to syslog as well).

CONTENTS

CONFIGURATION

dnscheck-dispatcher shares configuration files with the DNSCheck perl modules. Or, to be more precise, it creates such an object and then queries its configuration object for its configuration information. It also uses the DNSCheck object to get its database connection.

There are two keys in the configuration YAML files that are of interest for the dispatcher. The first one is syslog. It has the subkeys ident, which specifies the name the daemon will use when talking to syslogd, and facility, which specifies the syslog facility to use.

The second one is daemon. It has the subkeys pidfile, errorlog, maxchild and savelevel. They specify, in order, the file where the daemon will write its PID after it has detached, the file it will redirect its standard error to, the maximum number of concurrent child processes it may have and the minumum log level to save to the database. Make sure to set the pathnames to values where the user the daemon is running under has write permission, since it will terminated if they are specified but can’t be written to. Additionally, running with a maxchild value of n means that at least n+1 simultaneous connections to the database will be opened. Make sure that the database can actually handle that, or everything will die with more or less understandable error messages.

If everything works as intended nothing should ever be written to the errorlog. All normal log outout goes to syslog (and, with the debug flag, standard output).

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


perl v5.20.3 DNSCHECK-DISPATCHER (1) 2016-04-03

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