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 1569673

Summary:	[DOCS] Creation of a Ceph Run book
Product:	[Red Hat Storage] Red Hat Ceph Storage	Reporter:	Mike Hackett <mhackett>
Component:	Documentation	Assignee:	Aron Gunn <agunn>
Status:	CLOSED CURRENTRELEASE	QA Contact:	subhash <vpoliset>
Severity:	low	Docs Contact:
Priority:	medium
Version:	3.0	CC:	agunn, asriram, hnallurv, kdreyer, mhackett, pbyregow, r.martinez, vumrao
Target Milestone:	rc
Target Release:	3.1
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:	2019-02-26 07:20:07 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:	1523244

Description Mike Hackett 2018-04-19 18:36:12 UTC

Description of problem:
Managing a Ceph cluster from a user standpoint can be a daunting task. Red Hat should have a centralized document that clearly identifies a common issue/failure and assists the user with steps to resolve the issue/failure.

The Administration Guide covers some of these details but could be clearer and more concise: 

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/3/html/administration_guide/

The Ceph Run Book (Consulting Document) can be used as an example framework to create a newe doc or update the existing Administration guide:

https://docs.google.com/document/d/1rjxvEJLQ5Vnw2NbAsVAhCiJS_uPgKTdQ0JvAPJMT4TQ/edit

I can review the Administration Guide thoroughly to validate what should be updated or modified to be more clear to the user.

Comment 9 subhash 2018-08-17 11:00:56 UTC

Hi Aron,

Here are the things need to be changed in the operations Guide.

1)raw_journal_devices parameter has been deprecated after 3.0 (update it with "dedicated_devices" according to rhceph3.0 docs)
>Section 1.4.2 (replace "raw_journal_devices with "dedicated_devices") at four places.


2)Section 1.4.3. ->Under IMPORTANT
"For more information on using the ceph-volume command, see the Red Hat Ceph Storage <link>Block Device Guide</link> "

Pointing to Block Device Guide but should be pointed to Admin guide

"For more information on using the ceph-volume command, see the Red Hat Ceph Storage <link>Administration Guide</link> "

as per this bz https://bugzilla.redhat.com/show_bug.cgi?id=1589154


3)Section 3.2.4. Step 4
> <move a bucket> hyperlink not exactly taking to that section in storage strategies guide

4)Section 1.6 Under
Additonal Resources
<link> Erasure Code Pools</link> not working 
Section 1.7
 <link>Placement Groups (PGs)</link> not working

5)Section 3.2.3.
Step 6 need to be deleted ( as calamari is not supported in rhceph3)

pls let me knw if you any concerns
thanks

Comment 12 Anjana Suparna Sriram 2018-08-20 16:37:58 UTC

*** Bug 1612328 has been marked as a duplicate of this bug. ***

Comment 20 subhash 2018-08-27 10:05:21 UTC

doc content looks good to me ,Moving to verified state.