summaryrefslogtreecommitdiffstats
path: root/man/man4
diff options
context:
space:
mode:
authorSerapheim Dimitropoulos <[email protected]>2022-11-03 15:02:46 -0700
committerTony Hutter <[email protected]>2022-12-01 12:39:43 -0800
commit85537f77a3574f265c5e87c3ee4b1858317530ce (patch)
tree3103bf1a0d039f4eda281c2a28c294b9e9c876a5 /man/man4
parent5f53a444b3c1326f5b0af026763bb68e70a581ad (diff)
Expose zfs_vdev_open_timeout_ms as a tunable
Some of our customers have been occasionally hitting zfs import failures in Linux because udevd doesn't create the by-id symbolic links in time for zpool import to use them. The main issue is that the systemd-udev-settle.service that zfs-import-cache.service and other services depend on is racy. There is also an openzfs issue filed (see https://github.com/openzfs/zfs/issues/10891) outlining the problem and potential solutions. With the proper solutions being significant in terms of complexity and the priority of the issue being low for the time being, this patch exposes `zfs_vdev_open_timeout_ms` as a tunable so people that are experiencing this issue often can increase it as a workaround. Reviewed-by: Matthew Ahrens <[email protected]> Reviewed-by: Richard Yao <[email protected]> Reviewed-by: Alexander Motin <[email protected]> Reviewed-by: Don Brady <[email protected]> Reviewed-by: Brian Behlendorf <[email protected]> Signed-off-by: Serapheim Dimitropoulos <[email protected]> Closes #14133
Diffstat (limited to 'man/man4')
-rw-r--r--man/man4/zfs.47
1 files changed, 7 insertions, 0 deletions
diff --git a/man/man4/zfs.4 b/man/man4/zfs.4
index b317941bb..ed8914276 100644
--- a/man/man4/zfs.4
+++ b/man/man4/zfs.4
@@ -1222,6 +1222,13 @@ Ideally, this will be at least the sum of each queue's
.Sy max_active .
.No See Sx ZFS I/O SCHEDULER .
.
+.It Sy zfs_vdev_open_timeout_ms Ns = Ns Sy 1000 Pq uint
+Timeout value to wait before determining a device is missing
+during import.
+This is helpful for transient missing paths due
+to links being briefly removed and recreated in response to
+udev events.
+.
.It Sy zfs_vdev_rebuild_max_active Ns = Ns Sy 3 Pq int
Maximum sequential resilver I/O operations active to each device.
.No See Sx ZFS I/O SCHEDULER .