The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Difference between revisions of "ZFS Update"
| Line 1: | Line 1: | ||
Newer versions of ZFS introduce bug fixes, support for newer kernels, and in some instances, introduce new storage pool features. | Newer versions of ZFS introduce bug fixes, support for newer kernels, and in some instances, introduce new storage pool features. | ||
| Line 9: | Line 8: | ||
===Funtoo installed on ZFS=== | ===Funtoo installed on ZFS=== | ||
After updating ZFS packages the '''initramfs''' responsible for importing and mounting root (/) should also be '''updated prior to rebooting'''. By having an initramfs with the same ZFS executables ({{c|zpool}}, {{c|zfs}}) as found in {{f|/sbin}} | After updating ZFS packages the '''initramfs''' responsible for importing and mounting root (/) should also be '''updated prior to rebooting'''. By having an initramfs with the same ZFS executables ({{c|zpool}}, {{c|zfs}}) as found in {{f|/sbin}} the likelihood of a boot failure is reduced. | ||
Do note that updating initramfs may also require the updating of bootloader or UEFI configuration as well. | Do note that updating initramfs may also require the updating of bootloader or UEFI configuration as well. | ||
====...with GRUB==== | ====...with GRUB==== | ||
GRUB can support {{f|/boot}} residing within a ZFS storage pool (together with root {{f|/}}). There is an official installation guide for this configuration: [[ZFS Install Guide]]. | |||
Old versions of GRUB may not be able to re-import your root pool if the new features have been enabled. To reduce the likelihood of boot failure, GRUB should also be updated together with initramfs before enabling new storage pool features. | |||
After updating ZFS | Updating from old versions of ZFS (0.6.3 or older) introduces new storage pool features. After updating ZFS, a review of the pool status will indicate if new features are available. | ||
{{console|body= | {{console|body= | ||
| Line 39: | Line 38: | ||
}} | }} | ||
''' | '''The recommended steps to take are:''' | ||
# For now, ignore the option to upgrade the storage pool {{C|rpool}}. | # For now, ignore the option to upgrade the storage pool {{C|rpool}}. | ||
# Update your initramfs to include the latest ZFS binary executables. | # Update your initramfs to include the latest ZFS binary executables. | ||
# | # If possible upgrade {{Package|sys-boot/grub}} to the latest version (2.0.2). Follow [[Install]] for GRUB installation instructions, '''including''' {{c|grub-install}}. | ||
# Confirm that your system reboots successfully. (Mounting the root pool) | # Confirm that your system reboots successfully. (Mounting the root pool) | ||
# (Optional) Upgrade your storage pool to enable new features. | |||
====Updating (root) Storage Pool Features==== | ====Updating (root) Storage Pool Features==== | ||
Without specifying a pool name the command {{c|zpool upgrade}} will indicate pools available for upgrade. | |||
{{console|body= | {{console|body= | ||
###i## zpool upgrade | ###i## zpool upgrade | ||
| Line 77: | Line 75: | ||
}} | }} | ||
After successfully updating initramfs and rebooting, only one command is required to enable all new features on your root pool - {{c|rpool}}. | |||
{{console|body= | {{console|body= | ||
###i## zpool upgrade rpool | ###i## zpool upgrade rpool | ||
| Line 93: | Line 92: | ||
filesystem_limits | filesystem_limits | ||
large_blocks | large_blocks | ||
}} | }} | ||
Revision as of 14:07, October 15, 2016
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. Special attention should be given when updating ZFS with Funtoo Linux installed onto ZFS: i.e. root (/) resides in a storage pool. Important additional steps are often 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.
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
After updating ZFS packages the initramfs responsible for importing and mounting root (/) should also be updated prior to rebooting. By having an initramfs with the same ZFS executables (zpool, zfs) as found in /sbin the likelihood of a boot failure is reduced.
Do note that updating initramfs may also require the updating of bootloader or UEFI configuration as well.
...with GRUB
GRUB can support /boot residing within a ZFS storage pool (together with root /). There is an official installation guide for this configuration: ZFS Install Guide.
Old versions of GRUB may not be able to re-import your root pool if the new features have been enabled. To reduce the likelihood of boot failure, GRUB should also be updated together with initramfs before enabling new storage pool features.
Updating from old versions of ZFS (0.6.3 or older) introduces new storage pool features. After updating ZFS, a review of the pool status will indicate if new features are available.
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
The recommended steps to take are:
- For now, ignore the option to upgrade the storage pool
rpool. - Update your initramfs to include the latest ZFS binary executables.
- If possible upgrade No results to the latest version (2.0.2). Follow Install for GRUB installation instructions, including
grub-install. - Confirm that your system reboots successfully. (Mounting the root pool)
- (Optional) Upgrade your storage pool to enable new features.
Updating (root) Storage Pool Features
Without specifying a pool name the command zpool upgrade will indicate pools available for upgrade.
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
After successfully updating initramfs and rebooting, only one command is required to enable all new features on your root pool - rpool.
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