Bug 1332677

Summary: [Doc] Add warning to use of reweight-by-utilization
Product: Red Hat Ceph Storage Reporter: Neil Levine <nlevine>
Component: DocumentationAssignee: Aron Gunn <agunn>
Status: CLOSED CURRENTRELEASE QA Contact: ceph-qe-bugs <ceph-qe-bugs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 1.3.2CC: agunn, asriram, hnallurv, kdreyer, khartsoe, shmohan, vumrao
Target Milestone: rc   
Target Release: 2.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-05-16 11:25:00 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:

Description Neil Levine 2016-05-03 18:19:36 UTC
For the new backport feature of reweight-by-utilization, please add a warning that advises customers to seek advice before using the feature to ensure.

Comment 3 khartsoe@redhat.com 2016-05-10 16:06:54 UTC
I have enclosed the proposed warning below: please feel free to revise as needed:

Before issuing the ceph osd reweight-by-utilization command to reduce the weight of overused OSDs, seek guidance from appropriate technical support staff. In addition, confirm that weight changes do not negatively impact the system by first issuing the ceph osd test-reweight-by-utilization command to test the proposed weight changes. Make sure that the weight changes are implemented in small increments.


My thought is to add the warning to either (or both) of the following Admin Guide sections:

3.1.2. Checking Cluster Health (https://access.redhat.com/documentation/en/red-hat-ceph-storage/version-1.3/administration-guide/#checking_cluster_health)
3.1.8. Checking OSD Status (https://access.redhat.com/documentation/en/red-hat-ceph-storage/version-1.3/administration-guide/#checking_osd_status)

Comment 7 shylesh 2016-05-13 16:17:02 UTC
Doc looks good to me, it covers both the points mentioned in #comment5. Hence marking it as verified.

Comment 8 Anjana Suparna Sriram 2016-05-16 11:25:00 UTC
(In reply to shylesh from comment #7)
> Doc looks good to me, it covers both the points mentioned in #comment5.
> Hence marking it as verified.

Closing the bug as the guide has been republished: https://access.redhat.com/documentation/en/red-hat-ceph-storage/version-1.3/storage-strategies-guide/#set_an_osd_s_weight_by_utilization