documentation/docs/alpine-server-setup/post-install/update-protocol.md

Update protocol

ZFS opens up new methods to safely update the system. These methods are described in this section in combination with general practises to maintain ZFS filesystems.

Pre-update

To be able to rollback the system after a system update one may create a snapshot of the root filesystem.

# zfs snapshot rpool/root/alpine@previous

Tip:zfs list -t snapshot can be used to list snapshost and zfs destroy can be used to remove snapshots.

Update

Perform a system update.

# apk upgrade
# reboot

If the system does not behave accordingly after reboot, one may rollback to the previous snapshot.

# zfs rollback -r rpool/root/alpine@previous

Post-update

To maintain the performance of the SSDs in the system, perform a trim on the zfs-pool.

# zpool trim --secure --wait rpool

Some devices may not support the option --secure.

Thereafter, perform a scrub on the zfs-pool which checks and repairs the data in the pool.

# zpool scrub rpool

This may take a while, the progress can be checked with:

# zpool status rpool

A ZFS scrub only repairs if mirror or a zraid mode is set in the pool.