Changes

1. Find out watchdog kernel module name for your platform, possibly using using google== List of tested devices ==*For all Compulab Intel productsThe guide was tested on a systems with the specs listed below, it but should be named - '''"iTCO_wdt"'''easily adaptable

2 Device: fitlet2 CPU: Intel(R) Atom(TM) Processor E3950 BIOS: 05/14/2018 American Megatrends Inc. Verify it can be loaded successfully information on the device appears in dmesg outputFLT2.0.40.01.00 OS: Linux Mint 19 Tara Kernel: 4.15.0-23-generic Kernel module: iTCO_wdt

'''$ dmesg | tail''':output Device:IPC2 iTCO_wdt CPU: Intel TCO WatchDog Timer Driver v1(R) Core(TM) i5-4300U BIOS: 05/30/2017 Compulab Ltd. IPC2_3.330.115 iTCO_wdt OS: Found a Intel PCH TCO device (Version=4, TCOBASE=0x0400)Linux Mint 19 Tara iTCO_wdt Kernel: initialized4.15. heartbeat=60 sec (nowayout=0)-23-generic Kernel module: iTCO_wdt

3 Device: IPC3 CPU: Intel(R) Core(TM) i5-7200U BIOS: 08/09/2018 American Megatrends Inc. Install watchdog program, it should run in the background automatically on each system start5.12_IPC3K.PRD.0.25.7 OS:'''$ sudo apt install watchdog'''Linux Mint 19 Tara Kernel: 4.15.0-23-generic Kernel module: wdat_wdt<br>

4== Notes ==*'''fitlet1''': kernel module i2c_piix4 should be blacklisted** Expand the below guide<div class="toccolours mw-collapsible mw-collapsed" overflow:auto;">Add the following lines to the /etc/modprobe. d/blacklist.conf # fitlet1: sp5100_tco conflicts with i2c_piix4 for I/O address 0x0cd6 blacklist i2c_piix4Then, unload i2c_piix4 and update initramfs $ sudo modprobe -r i2c_piix4 $ sudo update-initramfs -u</div>*'''IPC2-Haswell''': iTCO Watchdog does not reset ACPI Watchdog timer** Expand the below guide<div class="toccolours mw-collapsible mw-collapsed" overflow:auto;">* if the iTCO BIOS does not reset the ACPI Watchdog timer, you may need to disable the BIOS configuration from Linux BIOS --> South bridge --> Watchdog Get super-user permissions: $ su Password:   $ apt install ioport* '''Note:''' On Ubuntu versions below 18.04, ioport should be installed manually from: https://packages.ubuntu.com/bionic/ioport  And then run the following command: $ outl 0x1854 0x2000 To read it for validation please run (also as super-user): $ printf "0x%x\n" $(inl 0x1854) 0x2000 To run this command automatically on each boot add it to file named /etc/rc.local.If you do not have such file, create it.  #!/bin/sh -e # # rc.local # # This script is executed at the end of each multiuser runlevel. # Make sure that the script will "exit 0" on success or any other # value on error. # # In order to enable or disable this script just change the execution # bits. # # By default this script does nothing. outl 0x1854 0x2000 exit 0 Make it executable  $ sudo chmod +x /etc/rc.local</div>*'''IPC3''': kernel module wdat_wdt does not produce debug messages, dmesg output will be empty<br> == Usage example == * The following usage example represented on fitlet2 with kernel module iTCO_wdt** For fitlet1 use kernel module sp5100_tco** For IPC3 use kernel module wdat_wdt<br>* Verify it can be loaded successfully and information about the device appears in dmesg output $ sudo modprobe iTCO_wdt $ dmesg | grep -i iTCO [ 34.741071] iTCO_vendor_support: vendor-support=0 [ 34.742749] iTCO_wdt: Intel TCO WatchDog Timer Driver v1.11 [ 34.742824] iTCO_wdt: Found a Apollo Lake SoC TCO device (Version=5, TCOBASE=0x0460) [ 34.742993] iTCO_wdt: initialized. heartbeat=30 sec (nowayout=0) * Install watchdog program, it should run in the background automatically on each system start $ sudo apt install watchdog * Modify the following configuration files: /etc/default/watchdog change: watchdog_module="none" to: watchdog_module="iTCO_wdt"  /etc/watchdog.conf uncomment line: watchdog-device = /dev/watchdog * NOTE: bugfix required for Linux Mint 18.3 /lib/systemd/system/watchdog.service add "WantedBy=default.target" line under [Install] header, as per below:

:'''/etc/watchdog.conf''' [Install] uncomment line: watchdog-device WantedBy= /dev/watchdogdefault.target

 * Try watchdog service and ensure it is running correctly $ sudo systemctl start watchdog $ sudo systemctl status watchdog ● watchdog.service - watchdog daemon Loaded:'''loaded (/etclib/defaultsystemd/system/watchdog'''.service; enabled; vendor preset: enabled) change Active: watchdog_module="none"active (running) since Tue 2018-04-17 03:30:58 EDT; 3min 3s ago to Main PID: watchdog_module="iTCO_wdt"1143 (watchdog) CGroup: /system.slice/watchdog.service └─1143 /usr/sbin/watchdog

Apr 17 03:'''/lib/30:58 denis-fitlet2 watchdog[1143]: int=1s realtime=yes sync=no soft=no mla=0 mem=0 Apr 17 03:30:58 denis-fitlet2 systemd/system/[1]: Started watchdogdaemon.service''' Apr 17 03:30:add "WantedBy=default.target" line under 58 denis-fitlet2 watchdog[Install1143] header, as per below:ping: no machine to check Apr 17 03:30:58 denis-fitlet2 watchdog[1143]: file: no file to check Apr 17 03:30:58 denis-fitlet2 watchdog[Install1143] WantedBy=default.target: pidfile: no server process to check Apr 17 03:30:58 denis-fitlet2 watchdog[1143]: interface: no interface to check* NOTE Apr 17 03: this a bugfix that required for LinuxMint18.3.30:58 denis-fitlet2 watchdog[1143]: temperature: no sensors to check 5. RebootApr 17 03:30:58 denis-fitlet2 watchdog[1143]: test=none(0) repair=none(0) alive=/dev/watchdog heartbeat=none to=root no_act=no force=no Apr 17 03:30:58 denis-fitlet2 watchdog[1143]: watchdog now set to 60 seconds6. Verify the the driver is loaded automatically Apr 17 03:30:58 denis-fitlet2 watchdog[1143]: hardware watchdog identity:iTCO_wdt

:'''* Enable autostart of the watchdog service $ dmesg | grep wdt'''sudo systemctl enable watchdog Synchronizing state of watchdog.service with SysV init with /lib/systemd/systemd-sysv-install... Executing /lib/systemd/systemd-sysv-install enable watchdog * Reboot

7. * Verify the the driver was loaded automatically $ dmesg | grep -i iTCO * Simulate kernel panic (as root user): $ su Password: $ echo 1 > /proc/sys/kernel/sysrq $ echo c > /proc/sysrq-trigger

*As a result, the watchdog mechanism should reboot the system within 60 30 seconds.