Skip to the content
Documentation

[WatchdogSettings]

No ratings yet

Available since Exponential 6.0.15 (in development, not in a release yet).

Summary

The group [WatchdogSettings] of settings/velocity.ini.

File

settings/velocity.ini; override it in settings/override/velocity.ini.append.php, in a siteaccess or in an extension.

Settings

Setting Default Description
Interval 45 exp:velocity watchdog: a safety net that starts the default engine again when it is down and nobody meant it to be (a restart whose caller was killed between the stop and the start, a crash, an out-of-memory kill). Off until `exp:velocity watchdog install` (root, systemd) writes <UnitName>.service and .timer and conf-available/<name>.conf in the configuration tree, enables that file (conf-enabled) and starts the timer. Values in the enabled file win over these. `exp:velocity conf disable watchdog` pauses it; `watchdog remove` takes it out; `watchdog status` and var/log/velocity-watchdog.log say what it did. It starts the engine only when no process of it runs, nobody stopped it (exp:velocity stop/kill leave stopped.json beside the pid file) and no restart is under way (restart-in-progress.json); it never touches a server that runs, whether it answers or not. Seconds between checks (15 to 3600).
RestartTimeout 300 Seconds a restart may take before its marker no longer holds the watchdog back (a marker whose process is gone never does). Also how long a held LockFile may keep a server that is down from being started.
Backoff 600 After three starts in a row that failed, seconds to wait before the next.
LockFile (empty) A lock file (flock) that, while held, means "something is deploying, wait": a deploy queue of the installation. Empty: none.
UnitName vc-watchdog The systemd unit's name; give each installation on a host its own.
UnitDir /etc/systemd/system Where the unit files are written.

See also

Generated example: velocity.ini [WatchdogSettings]

Added to the reference for Exponential 6.0.15: the 4.x reference had no page for this group. The descriptions are the comment lines of settings/velocity.ini.

Contributors

Comments

Add a comment

Comments are read by a moderator before they appear.