zpool-replace —
replace one device with another in ZFS storage
pool
| zpool |
replace
[-fsw]
[-o
property=value]
pool
device
[new-device] |
Replaces
device with
new-device. This is equivalent to attaching
new-device, waiting for it to resilver, and
then detaching
device. Any in progress scrub
will be cancelled.
The size of
new-device must be greater than or
equal to the minimum size of all the devices in a mirror or raidz
configuration.
new-device is required if the pool is not
redundant. If
new-device is not specified, it
defaults to
device. This form of replacement
is useful after an existing disk has failed and has been physically replaced.
In this case, the new disk may have the same
/dev
path as the old device, even though it is actually a different disk. ZFS
recognizes this.
- -f
- Forces use of new-device,
even if it appears to be in use. Not all devices can be overridden in this
manner.
-
-o
property=value
- Sets the given pool properties. See the
zpoolprops(7) manual page for a list of valid
properties that can be set. The only property supported at the moment is
ashift.
- -s
- The new-device is
reconstructed sequentially to restore redundancy as quickly as possible.
Checksums are not verified during sequential reconstruction so a scrub is
started when the resilver completes. Sequential reconstruction is not
supported for raidz configurations.
- -w
- Waits until the replacement has completed before
returning.
zpool-detach(8),
zpool-initialize(8),
zpool-online(8),
zpool-resilver(8)