From 2ced3cf0b2c5cc84885bd4c8c07878145a94c036 Mon Sep 17 00:00:00 2001 From: Brian Behlendorf Date: Mon, 17 Sep 2018 17:28:18 -0700 Subject: Clarify 'zpool remove' restrictions Update zpool(8) to clarify what type of vdevs may be safely removed and that the existence of any top-level raidz device which is part of the primary pool will prevent device removal. Reviewed by: Matthew Ahrens Signed-off-by: Tim Chase Signed-off-by: Brian Behlendorf Closes #7880 Closes #7893 --- man/man8/zpool.8 | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) (limited to 'man/man8') diff --git a/man/man8/zpool.8 b/man/man8/zpool.8 index 15333f567..542615991 100644 --- a/man/man8/zpool.8 +++ b/man/man8/zpool.8 @@ -1926,8 +1926,10 @@ result in partially resilvered devices unless a second scrub is performed. .Ar pool Ar device Ns ... .Xc Removes the specified device from the pool. -This command currently only supports removing hot spares, cache, log -devices and mirrored top-level vdevs (mirror of leaf devices); but not raidz. +This command supports removing hot spare, cache, log, and both mirrored and +non-redundant primary top-level vdevs, including dedup and special vdevs. +When the primary pool storage includes a top-level raidz vdev only hot spare, +cache, and log devices can be removed. .sp Removing a top-level vdev reduces the total amount of space in the storage pool. The specified device will be evacuated by copying all allocated space from it to @@ -1938,8 +1940,10 @@ command initiates the removal and returns, while the evacuation continues in the background. The removal progress can be monitored with .Nm zpool Cm status. -This feature must be enabled to be used, see -.Xr zpool-features 5 +The +.Sy device_removal +feature flag must be enabled to remove a top-level vdev, see +.Xr zpool-features 5 . .Pp A mirrored top-level device (log or data) can be removed by specifying the top-level mirror for the same. -- cgit v1.2.3