Change Proposal Name
Snapshot and Rollback Tool
With the advent of thinly-provisioned LVM pools, it has become possible for us to implement full-system LVM snapshotting for recording rollback points. We are planning to support this for yum updates and eventually fedup upgrades going forwards. This change request notes the addition of new tools provided by the roller-derby project to present an interface and a CLI for managing and initiating rollbacks.
- Name: Stephen Gallagher
- Email: email@example.com
- Name: Colin Walters
- Email: firstname.lastname@example.org
- Release notes owner:
- Targeted release: Fedora 20
- Last updated: Sgallagh (talk) 12:31, 11 July 2013 (UTC)
- Tracker bug: <will be assigned by the Wrangler>
The roller-derby project will be providing a library and a CLI for creating, labeling and managing LVM snapshots for the whole-system. This means that if there are multiple separate partitions, a snapshot will be taken of each of them and will be tracked as part of a set. The yum plugin "yum-plugin-fs-snapshot" will be updated to consume this library and save the system state in a compatible format. The roller-derby CLI tool will provide an interactive and scriptable interface for manipulating these snapshots and determining when to remove older ones. It will also allow the tagging of snapshots as "known-good", to be skipped when automatically-trimming for space. The roller-derby project will likely provide a small daemon to keep track of the available space in the LVM pool to proactively clean up snapshots before the system runs out of space.
Additionally, the roller-derby CLI will save the snapshot of the current state before rolling back and will provide tools to allow mounting of that current state to recover changes that have occurred since the rollback point.
Benefit to Fedora
This will provide a major benefit to Fedora developers who tend to run the latest-and-greatest (such as on Rawhide). It will allow them to save the state of their system at a time where everything is working and experiment with newer features with the confidence that if things are seriously broken they will be able to restore to a working state. Additionally, this will be useful for anyone running Fedora as a server, as it provides them with a cleaner guarantee for returning to a working state after an update with regressions than 'yum history' is capable of accomplishing.
The scope of this project is the completion of the initial release of the roller-derby project and the inclusion of thinly-provisioned LVM as an option in the Anaconda installer (being tracked as a separate Change request; will update this page when that is filed).
- Proposal owners:
We need to complete the roller-derby project. Other than the Anaconda change referenced above, all dependencies are available in Fedora already.
- Other developers: N/A (not a System Wide Change)
- Release engineering: N/A (not a System Wide Change)
- Policies and guidelines: N/A (not a System Wide Change)
Users upgrading from previous Fedora releases will not be able to take advantage of this functionality unless they were previously running with an LVM thinly-provisioned filesystem. In such cases, this tool will simply not be usable and its presence on the system will not have any impact. This feature will apply to new installations that select the "Thinly-provisioned LVM" option for filesystem layout.
How To Test
Testing of the CLI:
- Use the CLI to create a snapshot.
- Use the CLI to view the list of available snapshots
- Use the CLI to revert to a previous snapshot
- Use the CLI to mount the reversion point for retrieval of data
Testing of the Yum plugin:
- Perform a yum upgrade with the plugin enabled.
- Follow the CLI guide to view and revert to this snapshot
If we have time to implement this part of the feature:
- Verify that if we fill up the disk, snapshots are removed from oldest to newest to free up space by the daemon
- Use the CLI to tag a snapshot as "known-good" and verify that it is not removed unless it is the last snapshot available when free space is required
N/A (not a System Wide Change)
Users will now have an additional tool to manage their filesystem state at a fundamental level. See the testing plan for a rough outline of how this experience will look.
Completion of the Anaconda option for thinly-provisioned LVM as a filesystem layout is necessary for this feature to be easily usable. Otherwise, this feature will only be usable by users following a custom kickstart to elect thinly-provisioned LVM explicitly.
- Contingency mechanism: (What to do? Who will do it?) N/A (not a System Wide Change)
- Contingency deadline: N/A (not a System Wide Change)
- Blocks release? N/A (not a System Wide Change), Yes/No
If this is not completed in time, it will have no impact on the system. The tool will simply not ship and be completed for Fedora 21 instead.
Documentation will be needed but has not yet been written. The upstream project is hosted at https://fedorahosted.org/roller-derby
Fedora now provides tools for saving and restoring the system state of systems using a yum plugin and the roller-derby CLI tool.