Newer versions of ZFS introduce bug fixes, support for newer kernels, and in some instances, introduce new storage pool features.
Portage will update these packages in the normal fashion through
emerge --update @world. Important additional steps will be required for Funtoo Linux installed on a ZFS storage pool.
* The ZFS ebuilds are
As best practice, it is strongly recommended that all users backup their data on a regular basis - irrespective of the file system being used. This could be particularly important should something go wrong while modifying or updating a live file system.
Funtoo installed on ZFS
work in progress
GRUB vs UEFI vs static kernels
(Optional) Update GRUB?
review installed GRUB > recommend to update first if old version (new sys-boot/grub has better zfs support)
Identify existing ZFS version
If upgrading from ZFS 0.6.4.2 or newer
- Merge new zfs
- Update initramfs
If upgrading from ZFS 0.6.3.x or older
- as above
- warning about features
- zpool status, zpool upgrade rpool
root # zpool status pool: rpool state: ONLINE status: Some supported features are not enabled on the pool. The pool can still be used, but some features are unavailable. action: Enable all features using 'zpool upgrade'. Once this is done, the pool may no longer be accessible by software that does not support the features. See zpool-features(5) for details. scan: none requested config: NAME STATE READ WRITE CKSUM rpool ONLINE 0 0 0 ata-Samsung_SSD_840_EVO_120GB_123456789ABCDEF ONLINE 0 0 0 errors: No known data errors
root # zpool upgrade This system supports ZFS pool feature flags. All pools are formatted using feature flags. Some supported features are not enabled on the following pools. Once a feature is enabled the pool may become incompatible with software that does not support the feature. See zpool-features(5) for details. POOL FEATURE --------------- rpool async_destroy empty_bpobj lz4_compress spacemap_histogram enabled_txg hole_birth extensible_dataset embedded_data bookmarks filesystem_limits large_blocks
root # zpool upgrade rpool This system supports ZFS pool feature flags. Enabled the following features on 'rpool': async_destroy empty_bpobj lz4_compress spacemap_histogram enabled_txg hole_birth extensible_dataset embedded_data bookmarks filesystem_limits large_blocks