ZPOOL-REPLACE(8)

📦
version 2.4.4 · 7 versions
, in alpine 3.23, alpine 3.24, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💖 NAME 💖

zpool-replace — swap one device out for another in a ZFS storage pool. bestie, it's a glow-up for your vdev ✨

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

okay so picture this: you take device, and you replace it with new-device. that's it, that's the vibe. 💅

it's literally equivalent to attaching new-device, waiting for it to resilver, and then detaching device. and heads up — any in progress scrub will be canceled. gone. not invited to the afterparty. 😭

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. no shrinking, we don't do that here 🫶

new-device is required if the pool is not redundant. if you don't specify new-device, it just defaults to device. and that form of replacement is genuinely so 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. main character energy fr fr 👑

✨ the flags ✨

  • -f — Forces use of new-device, even if it appears to be in use. ngl, not all devices can be overridden in this manner — so don't count on it for everything 🙈
  • -o property=value — Sets the given pool properties. see the zpoolprops(7) manual page for a list of valid properties that can be set. and the only property supported at the moment is ashift. that's the whole menu bestie 🍓
  • -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. not a single one. 💀
  • -w — Waits until the replacement has completed before returning. she's patient, she's committed, she stays till the job is done 🎀

💜 SEE ALSO 💜

go read them, they're all iconic in their own way iykyk 🌈

this page came from OpenZFS, dated July 11, 2022 — mwah, slay, no notes 💖✨

📦 where this page comes from