FreeBSD Manual Pages
ZPOOL-REPLACE(8) System Manager's Manual ZPOOL-REPLACE(8) NAME zpool-replace -- replace one device with another in ZFS storage pool SYNOPSIS zpool replace [-fsw] [-o property=value] pool device [new-device] DESCRIPTION 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 canceled. 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 sequen- tial reconstruction so a scrub is started when the resilver com- pletes. Sequential reconstruction is not supported for raidz con- figurations. -w Waits until the replacement has completed before returning. SEE ALSO zpool-detach(8), zpool-initialize(8), zpool-online(8), zpool-resilver(8) FreeBSD ports 15.quarterly July 11, 2022 ZPOOL-REPLACE(8)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zpool-replace&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>
