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 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 use-
       ful 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  de-
       vice,  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	redun-
	       dancy  as quickly as possible.  Checksums are not verified dur-
	       ing 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.

SEE ALSO
       zpool-detach(8),		 zpool-initialize(8),	      zpool-online(8),
       zpool-resilver(8)

FreeBSD	13.2			 May 29, 2021		      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+14.0-RELEASE+and+Ports>

home | help