Bug 2064834

Summary: [RFE] Block device guide - document Transparent Image Clones - --rbd-default-clone-format
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: Vasishta <vashastr>
Component: DocumentationAssignee: Ranjini M N <rmandyam>
Documentation sub component: Block Device Guide QA Contact: Preethi <pnataraj>
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: high    
Priority: unspecified CC: pnataraj, rmandyam, vereddy
Version: 4.3Keywords: FutureFeature
Target Milestone: ---   
Target Release: 4.3z1   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2022-08-23 06:39:39 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 2065732    
Bug Blocks:    

Description Vasishta 2022-03-16 17:19:59 UTC 
Describe the issue:
Transparent Image Clones (clone v2) feature has been added into 4.x which needs to be documented.

Chapter/Section Number and Title:
Existing chapters with title - 
5.11. Protecting a block device snapshot
5.12. Cloning a block device snapshot

Can be modified

Product Version:
4x

Environment Details:
NA

Any other versions of this document that also needs this update:
5x

Additional information:
Comment 2 Vasishta 2022-03-18 15:37:05 UTC 
1) information on --rbd-default-clone-format is that if user has not set set-require-min-compat-client to greater than or equal to mimic, user can use `--rbd-default-clone-format 2` with rbd clone command to create clone of version 2
but using --rbd-default-clone-format per image basis is not recommended - Ref - https://bugzilla.redhat.com/show_bug.cgi?id=2065592#c1

2) in protecting snapshot section, we need to mention that snapshot need not to be protected to be able to create clone as clone v2 is doesn't need snapshot to be protected.

3) We need to mention that is set-require-min-compat-client is greater than or equal to mimic, by default clone v2 would be created.
but clients older than mimic won't be able to access those RBD images.