| .TH WATCHDOG.CONF 5 "January 2005" | |
| .UC 4 | |
| .SH NAME | |
| watchdog.conf \- configuration file for the watchdog daemon | |
| .SH DESCRIPTION | |
| This file carries all configuration options for the Linux watchdog daemon. | |
| Each option has to be written on a line for itself. Comments start with '#'. | |
| Blanks are ignored except after the '=' sign. An empty text after the '=' | |
| sign disables the feature as long as that makes sense. | |
| .SH OPTIONS | |
| .TP | |
| interval = <interval> | |
| Set the interval between two writes to the watchdog device. The kernel | |
| drivers expects a write command every minute. Otherwise the system will be | |
| rebooted. Default value is 1 second. An interval of more than a minute can | |
| only be used with the \-f command-line option. | |
| .TP | |
| logtick = <logtick> | |
| If you enable verbose logging, a message is written into the syslog or a | |
| logfile. While this is nice, it is not necessary to get a message every | |
| 10 seconds which really fills up disk and needs CPU. logtick allows adjustment | |
| of the number of intervals skipped before a log message is written. If you | |
| use logtick = 60 and interval = 10, only every 10 minutes (600 seconds) a | |
| message is written. This may make the exact time of a crash harder to find but | |
| greatly reduces disk usage and administrator nerves if you're looking for a | |
| particular syslog entry in between of watchdog messages. | |
| .TP | |
| max-load-1 = <load1> | |
| Set the maximal allowed load average for a 1 minute span. Once this load | |
| average is reached the system is rebooted. Default value is 0. That means | |
| the load average check is disabled. Be careful not to this parameter too | |
| low. To set a value less then the predefined minimal value of 2, you have to | |
| use the \-f commandline option. | |
| .TP | |
| max-load-5 = <load5> | |
| Set the maximal allowed load average for a 5 minute span. Once this load | |
| average is reached the system is rebooted. Default value is 3/4*max-load-1. | |
| Be careful not to this parameter too low. To set a value less then the | |
| predefined minimal value of 2, you have to use the \-f commandline option. | |
| .TP | |
| max-load-15 = <load15> | |
| Set the maximal allowed load average for a 15 minute span. Once this load | |
| average is reached the system is rebooted. Default value is 1/2*max-load-1. | |
| Be careful not to this parameter too low. To set a value less then the | |
| predefined minimal value of 2, you have to use the \-f commandline option. | |
| .TP | |
| min-memory = <minpage> | |
| Set the minimal amount of virtual memory that has to stay free. Note that | |
| this is in pages. Default value is 0 pages which means this test is | |
| disabled. The page size is taken from the system include files. | |
| .TP | |
| max-temperature = <temp> | |
| Set the maximal allowed temperature. Once this temperature is reached the | |
| system is halted. Default value is 120. There is no unit conversion, so make | |
| sure you use the same unit as your hardware. Watchdog will issue warnings | |
| once the temperature increases 90%, 95% and 98% of this temperature. | |
| .TP | |
| watchdog-device = <device> | |
| Set the watchdog device name. Default is to disable keep alive support. | |
| .TP | |
| watchdog-timeout = <timeout> | |
| Set the watchdog device timeout during startup. If not set, the default is | |
| driver-dependent. | |
| .TP | |
| temperature-device = <temp-dev> | |
| Set the temperature device name. Default is to disable temperature checking. | |
| .TP | |
| file = <filename> | |
| Set file name for file mode. | |
| This option can be given as often as you like to check several files. | |
| .TP | |
| change = <mtime> | |
| Set the change interval time for file mode. This options | |
| always belongs to the active filename, that is when finding a 'change =' | |
| line watchdog assumes it belongs to the most recently read 'file =' line. | |
| They don't neccessarily have to follow each other directly. But you cannot | |
| specify a 'change =' before a 'file ='. | |
| The default is to only stat the file and don't look for changes. | |
| Using this feature to monitor changes in /var/log/messages might require some | |
| special syslog daemon configuration, e.g. rsyslog needs | |
| "$ActionWriteAllMarkMessages on" to be set to make sure the marks are written | |
| no matter what. | |
| .TP | |
| pidfile = <pidfilename> | |
| Set pidfile name for server test mode. | |
| This option can be given as often as you like to check several servers. | |
| .TP | |
| ping = <ip-addr> | |
| Set IP address for ping mode. | |
| This option can be used more than once to check different | |
| connections. | |
| .TP | |
| interface = <if-name> | |
| Set interface name for network mode. | |
| This option can be used more than once to check different | |
| interfaces. | |
| .TP | |
| test-binary = <testbin> | |
| Execute the given binary to do some user defined tests. | |
| .TP | |
| test-timeout = <timeout in seconds> | |
| User defined tests may only run for <timeout> seconds. Set to 0 for unlimited. | |
| .TP | |
| repair-binary = <repbin> | |
| Execute the given binary in case of a problem instead of shutting down the | |
| system. | |
| .TP | |
| repair-timeout = <timeout in seconds> | |
| repair command may only run for <timeout> seconds. Set to 0 for unlimited. | |
| .TP | |
| admin = <mail-address> | |
| Email address to send admin mail to. That is, who shall be notified that the | |
| machine is being halted or rebooted. Default is 'root'. If you want to disable | |
| notification via email just set admin to en empty string. | |
| .TP | |
| realtime = <yes|no> | |
| If set to yes watchdog will lock itself into memory so it is never swapped | |
| out. | |
| .TP | |
| priority = <schedule priority> | |
| Set the schedule priority for realtime mode. | |
| .TP | |
| test-directory = <test directory> | |
| Set the directory to run user test/repair scripts. Default is '/etc/watchdog.d' | |
| See the Test Directory section in watchdog(8) for more information. | |
| .TP | |
| log-dir = <log directory> | |
| Set the log directory to capture the standard output and standard error from | |
| repair-binary and test-binary execution. Default is '/var/log/watchdog'. | |
| .SH FILES | |
| .TP | |
| .I /etc/watchdog.conf | |
| The watchdog configuration file | |
| .TP | |
| .I /etc/watchdog.d | |
| A directory containing test-or-repair commands. See the Test Directory | |
| section in watchdog(8) for more information. | |
| .SH "SEE ALSO" | |
| .BR watchdog (8) |