Bug 2054524

Summary:	[Doc] Limitation needs to be mentioned in 4.3.7 cloning subvolumes from snapshots
Product:	[Red Hat Storage] Red Hat Ceph Storage	Reporter:	Kotresh HR <khiremat>
Component:	Documentation	Assignee:	Rivka Pollack <rpollack>
Documentation sub component:	File System Guide	QA Contact:	julpark
Status:	CLOSED CURRENTRELEASE	Docs Contact:	Akash Raj <akraj>
Severity:	medium
Priority:	unspecified	CC:	akraj, amk, asriram, hyelloji, julpark, muagarwa, rmandyam, rpollack, vereddy
Version:	5.1
Target Milestone:	---
Target Release:	5.3z4
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	2131717 (view as bug list)		Environment:
Last Closed:	2023-07-20 04:25:49 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:
Bug Blocks:	2131717

Description Kotresh HR 2022-02-15 07:01:48 UTC

Describe the issue:

The cephfs snapshot clones are not suitable for large subvolume snapshots with small files. Please check the upstream doc [1] which mentions "Due to this bulk copy nature, cloning is currently inefficient for very huge data sets."
This should be mentioned in downstream as limitation as customers are unknowingly trying clones on large subvolume snapshots and expecting to be fast. 

[1] https://docs.ceph.com/en/latest/cephfs/fs-volumes/#cloning-snapshots

Describe the task you were trying to accomplish:

Suggestions for improvement:

Document URL:
https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html/file_system_guide/management-of-ceph-file-system-volumes-subvolume-groups-and-subvolumes#cloning-subvolumes-from-snapshots_fs

Chapter/Section Number and Title:
4.3.7. Cloning subvolumes from snapshots

Product Version:


Environment Details:
The customers usually doesn't use cloning directly. They usually use it behind the scenes when restoring PVC from snapshot in Openshit Container Storage.

Any other versions of this document that also needs this update:
Probably needs a mention in Openshift container Storage doc as well.

Additional information:

Comment 1 RHEL Program Management 2022-02-15 07:01:53 UTC

Please specify the severity of this bug. Severity is defined here:
https://bugzilla.redhat.com/page.cgi?id=fields.html#bug_severity.

Comment 5 Madhu Rajanna 2022-10-03 12:43:55 UTC

Adding NI on Mudit to help on this one.

Comment 6 Mudit Agarwal 2022-10-03 12:52:29 UTC

I have opened a doc bug in ODF for this, we can decide there. Thanks for the heads up Kotresh/Madhu.

Comment 12 Amarnath 2023-06-07 16:58:05 UTC

Hi Rivka Pollack,

It is relevant and should be added for 6.0 and 6.1 documentation sets as well.


Regards,
Amarnath