Bug 1930877

Summary: RFE: Add content on resizing CephFS
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: John Brier <jbrier>
Component: DocumentationAssignee: Anjana Suparna Sriram <asriram>
Documentation sub component: File System Guide QA Contact: Amarnath <amk>
Status: NEW --- Docs Contact:
Severity: medium    
Priority: unspecified CC: asriram, hyelloji, kdreyer, linuxkidd
Version: 4.1Keywords: FutureFeature
Target Milestone: ---   
Target Release: Backlog   
Hardware: x86_64   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 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:

Description John Brier 2021-02-19 16:58:41 UTC
Describe the issue:

For Bug 1766164, we added a bullet point in the features list about the ability to resize a CephFS:

"The Ceph File System size is only bound by the capacity of the OSDs servicing its data pool. To increase the capacity, add more OSDs to the CephFS data pool. To decrease the capacity, use either client quotas or pool quotas."

This covers a lot of territory and ideally we should have content that covers the different ways to decrease CephFS (pool quotas, client quotas on directories for max files and max usage (setfattr/getfattr), user quotas?).

Increasing the size of a CephFS requires adding OSDs to the CepFS data pool but we also need to cover increasing pg_count and/or using autoscaler.

Describe the task you were trying to accomplish:

Resize CephFS.

Suggestions for improvement:

Add an assembly on resizing CephFS and include various modules to cover that, concept module maybe, various procedure modules.

Document URL:

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html-single/file_system_guide/

Chapter/Section Number and Title:

Perhaps add it here:

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html-single/file_system_guide/index?lb_target=production#ceph-file-system-administration

Product Version:

Environment Details:

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

Additional information: