ZPOOL-UPGRADE(8)

✨ zpool-upgrade — managing version + feature flags of ZFS storage pools ✨

okay bestie, welcome to zpool-upgrade(8), from the System Manager's Manual section 8 💖 this is literally the glow-up page for your pools.

---

🌸 SYNOPSIS 🌸

zpool upgrade
zpool upgrade -v
zpool upgrade [-V version] -a|pool…

---

💅 DESCRIPTION 💅

🫶 zpool upgrade

Shows you the pools that don't have all the supported features turned on, plus the pools that were formatted with a legacy ZFS version number. No cap, those pools are still usable — but some features may just not be available to you. sad! 😭

If you wanna enable everything on everything, use zpool upgrade -a (and yes, it's subject to the -o compatibility property, we'll get there).

🦋 zpool upgrade -v

Shows you all the legacy ZFS versions that this version of ZFS supports. And if you want the tea on which features this version of ZFS supports, go read zpool-features(7). 📖

👑 zpool upgrade [-V version] -a|pool…

Enables all supported features on the pool(s) you name. main character energy fr fr.

So here's the situation: if your pool has compatibility feature sets specified via the -o compatibility property, then only the features that show up in ALL of the requested compatibility sets get enabled. And if that property is set to legacy? Then no upgrade happens at all. periodt, nothing, zero, nada. 🚫

⚠️ and this is the big one: once you do this, the pool will no longer be accessible on systems that don't support feature flags. gone. not invited to the group chat anymore. 😭

For the details on compatibility with systems that do support feature flags but don't support all the features enabled on your pool, check zpool-features(7).

• -a — Enables all supported features on all pools (from the specified compatibility sets, if there are any).
• -V version — Upgrade to the specified legacy version. If you use this, no features will be enabled on the pool. And it can only be used to increase the version number, up to the last supported legacy version number. no going backwards bestie 💀

---

🌈 EXAMPLES 🌈

⭐ Example 1: Upgrading All ZFS Storage Pools to the Current Version

This command right here upgrades all ZFS Storage pools to the current version of the software:

# zpool upgrade -a
This system is currently running ZFS version 2.

look at her go 🎀

---

🔥 SEE ALSO 🔥

zpool-features(7), zpoolconcepts(7), zpoolprops(7), zpool-history(8)

---

k that's the whole page bestie 💜 this one's from OpenZFS, dated July 11, 2022 — go forth and upgrade responsibly, mwah 🫶✨