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

FreeBSD Manual Pages


home | help
ZPOOL-REPLACE(8)	  BSD System Manager's Manual	      ZPOOL-REPLACE(8)

     zpool-replace -- Replace one device with another in a ZFS storage pool

     zpool replace [-fsw] [-o property=value] pool device [new_device]

     zpool replace [-fsw] [-o property=value] pool device [new_device]
	     Replaces old_device with new_device.  This	is equivalent to at-
	     taching new_device, waiting for it	to resilver, and then detach-
	     ing old_device.  Any in progress scrub will be cancelled.

	     The size of new_device must be greater than or equal to the mini-
	     mum 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 old_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 ac-
	     tually 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	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
		     verfied during sequential reconstruction so a scrub is
		     started when the resilver completes.  Sequential recon-
		     struction is not supported	for raidz configurations.

	     -w	     Waits until the replacement has completed before return-

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

BSD				 May 15, 2020				   BSD


Want to link to this manual page? Use this URL:

home | help