Scroll to navigation

HEALTH-CHECKER(8) health-checker HEALTH-CHECKER(8)

NAME

health-checker, health-checker.service - Checks that all important services of a system did come up correctly after an update and reboot.

SYNOPSIS

/usr/sbin/health-checker

/usr/sbin/health-checker --version

health-checker.service

DESCRIPTION

health-checker checks if the system is coming up correctly during boot up. In case of an error, the remediation action depends on what happened before. If this is the first boot after a transactional update, an automatic rollback to the last known working snapshot is executed. If the snapshot was already rebooted successfully before, a reboot is tried. If this does not help, some sevices are shutdown and an admin has to repair the system.

If the boot was successful, the current snapshot is marked as known to be working.

Plugins are used for performing the tests and new plugins can be written. They are stored in the /usr/libexec/health-checker or /usr/local/libexec/health-checker (individual user plugins) directory and are executed either with the option check or stop. If called with "check", the plugin should verify that the service works and return 0, else 1. If one plugin returns "1", health-check will evaluate what to do. If neither a rollback or reboot is usefull, all plugins will be called with the "stop" option. In this case, the plugins should shutdown the services are far as possible and usefull.

TELEMETRY

If telem-record-gen(1) is installed telemetry events are created additional to logging with syslog(3).

SEE ALSO

transactional-update(8)

AUTHOR

Thorsten Kukuk <kukuk@suse.de>

01/11/2024 health-checker