Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

SoftNAS software updates often include newer versions of ZFS, the powerful file system it utilizes. Since different ZFS versions may support different zpool formats, upgrading SoftNAS might require updating upgrading your existing ZFS pools as well using the command zpool upgrade <pool name>.

Even though SoftNAS can be able to upgrade pools automatically in the background, we require user intervention in this kind of operation as consent since it may result to incompatibilities with older SoftNAS systems with older ZFS versions which might be unwanted.

Note

Please read carefully the pros and cons of doing a zpool upgrade before deciding to proceed with such operation.

...

Pros and Cons of Doing a ZFS Pool Upgrade

...

Tip
  • Backup your Data: This is the most crucial step. Ensure you have a complete backup of your pool data before any upgrade attempt.

  • Check Compatibility: Research potential compatibility issues related to your specific hardware, operating system, and ZFS versions involved in the upgrade.

  • Review Features: Understand the new features and functionalities introduced in the upgrade and assess their value for your specific needs.

  • Test on Non-Critical Pool (Optional): If feasible, consider creating a test pool with similar characteristics and upgrading it first to identify any potential issues before upgrading your critical pool.

  • Check for Data Integrity: Before and/or after the upgrade, you can test for data integrity by running a pool scrub operation using commands zpool clear <pool name> && zpool scrub <pool name>.

By following these guidelines and considering the pros and cons, you can make an informed decision about upgrading your ZFS pool and minimize any potential risks involved.

...