Skip to main content

Watchcat

Watchcat - Network watchdog utility

"Watchcat is a ping-watchdog utility that allows you to set up rules for when a ping to a particular host fails."

The following modes of operation are available
- Ping Reboot: reboot the OpenWrt device if a ping to a specific host fails
- Restart Interface: restart a network interface if a ping to a host over that interface fails
- Periodic Reboot: reboot at a set period of time, such as every 24h.

Introduction

Watchcat is a ping-watchdog utility that allows you to set up rules for when a ping to a particular host fails.

The following modes of operation are available:

  • Ping Reboot : reboot the OpenWrt device if a ping to a specific host fails.
  • Restart Interface : restart a network interface if a ping to a host over that interface fails.
  • Periodic Reboot : reboot at a set period of time, such as every 24h.

Parameters

  1. mode - the mode this watchcat instance is in.

    image.png

    • Ping_reboot
    • Periodic_reboot
    • Restart_interface
    • Run_script

  2. Period - the way this parameter is used depends on the mode watchcat is in.

    image.png

    • Periodic Reboot : the interval of time at which to perform the reboot, such as every 24h
    • Ping Reboot : the longest interval of time without a successful ping before the rule is activated
    • Restart Interface : the longest interval of time without a successful ping before the rule is activated
      (restarts only the interface)
  3. Host to check - In Ping Reboot and Restart Interface modes, IP address or the host name to ping

  4. Check Interval - The time duration to ping the host

    image.png


    • every 10 seconds would be: 10 or 10s
    • every 5 minutes would be: 5m
    • every 1 hour would be: 1h
    • every week would be: 7d
  5. Ping Packet Size - The size of packet to use for pings.

    image.png


    • small - 1 byte
    • windows - 32 bytes
    • standard - 56 bytes
    • big - 248 bytes
    • huge - 1492 bytes
    • jumbo - 9000 bytes
  6. Force Reboot Delay - In Ping Reboot and Periodic Reboot modes, the amount of time to try a graceful reboot before a sysreq reboot is activated as a fail safe.

  7. Interface -  The interface to ping via, and also, in Restart Interface mode the one to restart. If unset, it will use the default route's interface

    image.png