Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)

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>

home | help