2021-08-10 11:25:40 +00:00
|
|
|
diff --git a/watchdog.8 b/watchdog.8
|
|
|
|
index 9b7c6e7..052b1e1 100644
|
|
|
|
--- a/watchdog.8
|
|
|
|
+++ b/watchdog.8
|
|
|
|
@@ -216,6 +216,7 @@ by
|
2018-02-13 08:47:12 +00:00
|
|
|
.BR watchdog .
|
2013-11-07 14:00:09 +00:00
|
|
|
So you can for instance restart the server from your
|
|
|
|
.IR repair-binary .
|
|
|
|
+See the Systemd section below for additinal information.
|
|
|
|
.PP
|
2018-02-13 08:47:12 +00:00
|
|
|
.B watchdog
|
2013-11-07 14:00:09 +00:00
|
|
|
will try periodically to fork itself to see whether the process
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -242,6 +243,8 @@ a given interface for traffic. If no traffic arrives the network is
|
2018-02-13 08:47:12 +00:00
|
|
|
considered unreachable causing a soft reboot or action from the
|
2013-11-07 10:40:33 +00:00
|
|
|
repair binary.
|
|
|
|
.PP
|
2013-11-07 14:00:09 +00:00
|
|
|
+To start the watchdog when network is available see the Systemd section below.
|
2013-11-07 10:40:33 +00:00
|
|
|
+.PP
|
2018-02-13 08:47:12 +00:00
|
|
|
.B watchdog
|
|
|
|
can run an external command for user-defined tests. A return code not equal 0
|
|
|
|
means an error occurred and watchdog should react. If the external command is
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -348,6 +351,9 @@ Child process did not return in time.
|
2018-02-13 08:47:12 +00:00
|
|
|
246
|
|
|
|
Free for personal watchdog-specific use (was \-10 as an unsigned 8\-bit
|
|
|
|
number).
|
2013-11-07 10:40:33 +00:00
|
|
|
+.PP
|
|
|
|
+With enforcing SELinux policy please use the /usr/libexec/watchdog/scripts/
|
|
|
|
+for your test-binary configuration.
|
2018-02-13 08:47:12 +00:00
|
|
|
.TP
|
|
|
|
245
|
|
|
|
Reserved for an unknown result, for example a slow background test that is
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -375,6 +381,9 @@ repair-maximum
|
2018-02-13 08:47:12 +00:00
|
|
|
controls the number of successive repair attempts that report 0 (i.e. success) but
|
|
|
|
fail to clear the tested fault. If this is exceeded then a reboot takes place. If set
|
|
|
|
to zero then a reboot can always be blocked by the repair program reporting success.
|
2013-11-07 10:40:33 +00:00
|
|
|
+.PP
|
|
|
|
+With enforcing SELinux policy please use the /usr/libexec/watchdog/scripts/
|
|
|
|
+for your repair-binary configuration.
|
|
|
|
.SH "TEST DIRECTORY"
|
2018-02-13 08:47:12 +00:00
|
|
|
Executables placed in the test directory are discovered by watchdog on
|
2013-11-07 10:40:33 +00:00
|
|
|
startup and are automatically executed. They are bounded time-wise by
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -413,6 +422,27 @@ As for the repair binary, the configuration parameter
|
2018-02-13 08:47:12 +00:00
|
|
|
repair-maximum
|
|
|
|
also controls the number of successive repair attempts that report success
|
|
|
|
(return 0) but fail to clear the fault.
|
2013-11-07 14:00:09 +00:00
|
|
|
+.SH SYSTEMD
|
|
|
|
+To start watchdog after the network is available:
|
|
|
|
+.PP
|
|
|
|
+.br
|
|
|
|
+systemctl disable watchdog
|
|
|
|
+.br
|
|
|
|
+systemctl enable NetworkManager-wait-online
|
|
|
|
+.br
|
|
|
|
+systemctl enable watchdog-ping
|
|
|
|
+.PP
|
|
|
|
+
|
|
|
|
+When using custom service pid check with custom service
|
|
|
|
+systemd unit file please be aware the "Requires="
|
|
|
|
+does dependent service deactivation.
|
|
|
|
+Using "Before=watchdog.service" or "Before=watchdog-ping.service"
|
|
|
|
+in the custom service unit file may be the desired operation instead.
|
|
|
|
+See systemd.unit documentation for more details.
|
|
|
|
+
|
2013-11-07 10:40:33 +00:00
|
|
|
+.SH SELINUX
|
2013-11-07 13:41:52 +00:00
|
|
|
+The directories /etc/watchdog.d/ and /usr/libexec/watchdog/scripts/ are
|
|
|
|
+recognized locations for custom executables.
|
2013-11-07 10:40:33 +00:00
|
|
|
.SH BUGS
|
|
|
|
None known so far.
|
|
|
|
.SH AUTHORS
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -431,4 +461,4 @@ The watchdog device.
|
2018-02-13 08:47:12 +00:00
|
|
|
The pid file of the running
|
2013-11-07 14:00:09 +00:00
|
|
|
.BR watchdog .
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
-.BR watchdog.conf (5)
|
|
|
|
+.BR watchdog.conf (5), systemd.unit (5)
|
2021-08-10 11:25:40 +00:00
|
|
|
diff --git a/watchdog.conf b/watchdog.conf
|
|
|
|
index 207da3e..7dd3cb3 100644
|
|
|
|
--- a/watchdog.conf
|
|
|
|
+++ b/watchdog.conf
|
|
|
|
@@ -75,7 +75,9 @@ priority = 1
|
|
|
|
# If you have a custom binary/script to handle errors then uncomment
|
|
|
|
# this line and provide the path. For 'v1' test binary files they also
|
|
|
|
# handle error cases.
|
|
|
|
-
|
2018-02-13 08:47:12 +00:00
|
|
|
+# With enforcing SELinux policy please use the /usr/libexec/watchdog/scripts/
|
2021-08-10 11:25:40 +00:00
|
|
|
+
|
2018-02-13 08:47:12 +00:00
|
|
|
+# or /etc/watchdog.d/ for your test-binary and repair-binary configuration.
|
|
|
|
#repair-binary = /usr/sbin/repair
|
|
|
|
#repair-timeout = 60
|
2021-08-10 11:25:40 +00:00
|
|
|
|
|
|
|
@@ -175,6 +177,13 @@ priority = 1
|
|
|
|
#temperature-sensor =
|
|
|
|
#max-temperature = 90
|
2018-02-13 08:47:12 +00:00
|
|
|
|
|
|
|
+# When using custom service pid check with custom service
|
|
|
|
+# systemd unit file please be aware the "Requires="
|
|
|
|
+# does dependent service deactivation.
|
|
|
|
+# Using "Before=watchdog.service" or "Before=watchdog-ping.service"
|
|
|
|
+# in the custom service unit file may be the desired operation instead.
|
|
|
|
+# See man 5 systemd.unit for more details.
|
|
|
|
+#
|
2021-08-10 11:25:40 +00:00
|
|
|
# Check for a running process/daemon by its PID file. For example,
|
|
|
|
# check if rsyslogd is still running by enabling the following line:
|
|
|
|
|
|
|
|
diff --git a/watchdog.conf.5 b/watchdog.conf.5
|
|
|
|
index edf7c8b..72c3bc2 100644
|
|
|
|
--- a/watchdog.conf.5
|
|
|
|
+++ b/watchdog.conf.5
|
|
|
|
@@ -130,6 +130,7 @@ pidfile = <pidfilename>
|
|
|
|
Set pidfile name for daemon test mode.
|
|
|
|
This option can be given as often as you like to check several daemons, assuming
|
|
|
|
they write their post-forking PID to the specified files.
|
2013-11-07 14:00:09 +00:00
|
|
|
+See the Systemd section in watchdog (8) for more information.
|
|
|
|
.TP
|
|
|
|
ping = <ip-addr>
|
2018-02-13 08:47:12 +00:00
|
|
|
Set IPv4 address for ping mode.
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -147,6 +148,8 @@ aliased IP interfaces.
|
2013-11-07 10:40:33 +00:00
|
|
|
.TP
|
|
|
|
test-binary = <testbin>
|
|
|
|
Execute the given binary to do some user defined tests.
|
|
|
|
+With enforcing SELinux policy please use the /usr/libexec/watchdog/scripts/
|
|
|
|
+for your test-binary configuration.
|
|
|
|
.TP
|
|
|
|
test-timeout = <timeout in seconds>
|
|
|
|
User defined tests may only run for <timeout> seconds. Set to 0 for unlimited.
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -154,6 +157,8 @@ User defined tests may only run for <timeout> seconds. Set to 0 for unlimited.
|
2013-11-07 10:40:33 +00:00
|
|
|
repair-binary = <repbin>
|
|
|
|
Execute the given binary in case of a problem instead of shutting down the
|
|
|
|
system.
|
|
|
|
+With enforcing SELinux policy please use the /usr/libexec/watchdog/scripts/
|
|
|
|
+for your repair-binary configuration.
|
|
|
|
.TP
|
|
|
|
repair-timeout = <timeout in seconds>
|
2018-02-13 08:47:12 +00:00
|
|
|
repair command may only run for <timeout> seconds. Set to 0 for 'unlimited', but
|
2021-08-10 11:25:40 +00:00
|
|
|
@@ -188,6 +193,7 @@ Set the schedule priority for realtime mode passed to sched_setscheduler().
|
2013-11-07 13:41:52 +00:00
|
|
|
.TP
|
|
|
|
test-directory = <test directory>
|
|
|
|
Set the directory to run user test/repair scripts. Default is '/etc/watchdog.d'
|
|
|
|
+The /etc/watchdog.d/ is recognized by SELinux policy.
|
|
|
|
See the Test Directory section in watchdog(8) for more information.
|
|
|
|
.TP
|
|
|
|
log-dir = <log directory>
|