Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
This project is now read‑only. Starting Monday, February 2, please use https://ibm-ceph.atlassian.net/ for all bug tracking management.

Bug 2059828

Summary: [cee/sd][doc] Need to improve the steps to change the bluestore_min_alloc_size configuration parameter in RHCS 5 administration guide
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: Kritik Sachdeva <ksachdev>
Component: DocumentationAssignee: ceph-docs <ceph-docs>
Documentation sub component: Administration Guide QA Contact: Pawan <pdhiran>
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: medium    
Priority: unspecified CC: asriram, hyelloji, pdhiran, vereddy
Version: 5.0   
Target Milestone: ---   
Target Release: 5.3   
Hardware: x86_64   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-01-19 15:33:22 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:

Description Kritik Sachdeva 2022-03-02 07:02:32 UTC 
Describe the issue:
In the section 8.5 of the Administration guide for tuning the bluestore using bluestore_min_alloc_size parameter, the steps shared in the procedure are confusing.

Under the Prerequisites of the above section, it is mentioned that to change the parameter value we need to redeploy the existing OSDs, and for new OSDs set the new value for the configuration parameter.

However, in the procedure section step-2, it is mentioned to restart the OSD only and it create confusion because in RHCS 4, it is more verbosely explained the steps for the existing OSDs that need to re-deploy and for the new OSDs that will be added in the cluster.

Reference doc of RHCS 4: https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html/administration_guide/osd-bluestore#tuning-ceph-bluestore-for-small-writes_admin


Suggestions for improvement:

- Add the steps verbosely for existing OSDs and new OSDs to tune the bluestore_min_alloc_size configuration parameter

Document URL: https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/administration_guide/index#tuning-ceph-bluestore-using-bluestore-min-alloc-size-parameter_admin

Chapter/Section Number and Title: (Chapter) Chapter 8. BlueStore and (Section) 8.5. Tuning Ceph BlueStore using bluestore_min_alloc_size parameter
Product Version:

Environment Details: RHCS 5.x