diff --git a/docs/locking.html.in b/docs/locking.html.in index 0d039dabc3..6d7b5174a4 100644 --- a/docs/locking.html.in +++ b/docs/locking.html.in @@ -208,5 +208,29 @@ </pool> +
+ In case sanlock loses access to disk locks for some reason, it will
+ kill all domains that lost their locks. This default behavior may
+ be changed using
+ on_lockfailure
+ element in domain XML. When this element is present, sanlock
+ will call sanlock_helper
(provided by libvirt) with
+ the specified action. This helper binary will connect to libvirtd
+ and thus it may need to authenticate if libvirtd was configured to
+ require that on the read-write UNIX socket. To provide the
+ appropriate credentials to sanlock_helper, a
+ client authentication
+ file needs to contain something like the following:
+
+[auth-libvirt-localhost] +credentials=sanlock + +[credentials-sanlock] +authname=login +password=password +