diff --git a/man/rpm-ostree.xml b/man/rpm-ostree.xml index 67dd71bf..38bee4fd 100644 --- a/man/rpm-ostree.xml +++ b/man/rpm-ostree.xml @@ -656,12 +656,58 @@ Boston, MA 02111-1307, USA. This command offers access to experimental features; command line stability is not guaranteed. The available subcommands will be listed by invoking rpm-ostree ex. For example, there is - rpm-ostree ex livefs which is an experimental + rpm-ostree ex apply-live which is an experimental interface for applying changes to the booted deployment. + + + ex apply-live + + + + Experimental feature; subject to change. + + + + Given a target OSTree commit (defaults to the pending deployment), create a transient + overlayfs filesystem for /usr, and synchronize + the changes to the booted filesystem tree. + + + + to reset the filesystem tree to the booted commit. + + + + may be used to target an arbitrary OSTree commit. This is an advanced feature, exposed mainly for testing. + + + + Install postgresql live + + $ rpm-ostree install postgresql-server +$ rpm-ostree ex apply-live +$ systemctl start postgresql # Some setup required + + + + + Currently, this just synchronizes the filesystem; no systemd units are restarted + for example. + + + + A major implicit benefit of the overlayfs approach is that + if something goes wrong in the middle of a apply-live operation, + a system reboot will implicitly remove the overlay, restoring the system to + the pristine deployment state. + + + + ex initramfs-etc