Bug 1294995 - [Storage Guide] Snapper section needs some clarifications
Summary: [Storage Guide] Snapper section needs some clarifications
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: doc-Storage_Administration_Guide
Version: 7.2
Hardware: All
OS: Linux
high
medium
Target Milestone: rc
: ---
Assignee: Milan Navratil
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-12-31 15:26 UTC by Karl Hastings
Modified: 2022-03-13 13:59 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-11-14 10:56:09 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Karl Hastings 2015-12-31 15:26:28 UTC
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html-single/Storage_Administration_Guide/index.html#snapper-undochange

Section Number and Name: 
13.5. Reverse Changes in Between Snapshots

Describe the issue: 
"NOTE: PLACE HOLDER DIAGRAM"  Not what we want in the published document.

Also the warning in incomplete:
"Important
This will not revert the snapper volume back to its original state and does not provide data consistency. Any file modification that occurs outside of the specified range (for example, after snapshot 2) will remain unchanged after reverting back (for example, to the state of snapshot 1). For example, should the undochange be run to undo the creation of a user, any files owned by that user may still remain.
There is also no mechanism to ensure file consistency as a snapshot is made, so any inconsistencies that already exist can be transfered back to the snapshot when the undochange command is used. "

The upstream snapper documentation is pretty specific that you should *not* use snapper to try to "undochange" the root filesystem.  (i.e. "snapper -c root create --command "yum update"  followed later by a "snapper -c root undochange y..x" is likely to result in catastrophic failure...  i.e. is not supported).

Upstream snapper SuSe snapper has the "rollback" command (which we appear to not include) which handles this usecase.

This limitation needs to be very clear.

Finally, the snapper section is *very* heavy on btrfs examples which are not yet supported.  Should probably have all the examples use lvm since that is what is supported.

Suggestions for improvement: 
See above

Additional information:

Comment 22 Milan Navratil 2016-11-14 10:56:09 UTC
An updated version of the Red hat Enterprise Linux 7 Storage Administration Guide is now available on the Customer Portal:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html-single/Storage_Administration_Guide/index.html

(The update with the fix pointed out in comment 18 will be available soon.)


Note You need to log in before you can comment on or make changes to this bug.