diff options
author | Andrew Geissler <geissonator@yahoo.com> | 2018-12-11 09:54:18 -0600 |
---|---|---|
committer | Gunnar Mills <gmills@us.ibm.com> | 2019-02-16 18:06:29 +0000 |
commit | 84c1704be9e9e4882a0cae127b6921ae1c85b7f5 (patch) | |
tree | f08ce0ae431908a14352ae251ff5655f53bf7b33 | |
parent | aee2ea85dfce6b13d2dbe233144bc0aea9dfa8fe (diff) | |
download | openbmc-docs-84c1704be9e9e4882a0cae127b6921ae1c85b7f5.tar.gz openbmc-docs-84c1704be9e9e4882a0cae127b6921ae1c85b7f5.zip |
Add in host watchdog section
The host watchdog function has a lot of moving parts
so wanted to get them all down in one spot
Change-Id: Ie2f20ab9e1459ee8e21c2397a87bb14bbecf5783
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>
-rw-r--r-- | host-management.md | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/host-management.md b/host-management.md index dc28e4c..88b9eee 100644 --- a/host-management.md +++ b/host-management.md @@ -249,3 +249,44 @@ can be called as follows: ``` Implementation: https://github.com/openbmc/openpower-pnor-code-mgmt + +Host Watchdog +------------- + +The host watchdog service is responsible for ensuring the host starts and boots +within a reasonable time. On host start, the watchdog is started and it is +expected that the host will ping the watchdog via the inband interface +periodically as it boots. If the host fails to ping the watchdog within the +timeout then the host watchdog will start a systemd target to go to the quiesce +target. System settings will then determine the recovery behavior from that +state, for example, attempting to reboot the system. + +The host watchdog utilizes the generic [phosphor-watchdog][1] repository. The +host watchdog service provides 2 files as configuration options into +phosphor-watchdog: + + /lib/systemd/system/phosphor-watchdog@poweron.service.d/poweron.conf + /etc/default/obmc/watchdog/poweron + +`poweron.conf` contains the "Conflicts" relationships to ensure the watchdog +service is stopped at the correct times. `poweron` contains the required +information for phosphor-watchdog (more information on these can be found in the +[phosphor-watchdog][1] repository). + +The 2 service files involved with the host watchdog are: + + phosphor-watchdog@poweron.service + obmc-enable-host-watchdog@0.service + +`phosphor-watchdog@poweron` starts the host watchdog service and +`obmc-enable-host-watchdog` starts the watchdog timer. Both are run as a part +of the `obmc-host-startmin@.target`. Service dependencies ensure the service is +started before the enable is called. + +The default watchdog timeout can be found within the [dbus interface +specification][2] (Interval property). + +The host controls the watchdog timeout and enable/disable once it starts. + +[1]: https://github.com/openbmc/phosphor-watchdog +[2]: https://github.com/openbmc/phosphor-dbus-interfaces/blob/master/xyz/openbmc_project/State/Watchdog.interface.yaml |