ZFS Update

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 sys-fs/zfs, sys-fs/zfs-kmod and sys-kernel/spl.

   Important

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

   Warning

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

Details...

If upgrading from ZFS 0.6.4.2 or newer

Normal upgrade

• Merge new zfs
• Update initramfs
• grub-mkconfig
• reboot

If upgrading from ZFS 0.6.3.x or older

Details...

• 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