Bug 1368486

Summary:	Incorrect instructions to integrate an existing ceph cluster
Product:	Red Hat OpenStack	Reporter:	Ruchika K <rkharwar>
Component:	documentation	Assignee:	Don Domingo <ddomingo>
Status:	CLOSED NOTABUG	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	unspecified	Docs Contact:	Don Domingo <ddomingo>
Priority:	unspecified
Version:	1.0 (Essex)	CC:	dcadzow, kdreyer, rkharwar, srevivo
Target Milestone:	ga	Keywords:	Documentation
Target Release:	10.0 (Newton)	Flags:	ddomingo: needinfo? (rkharwar)
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-05-31 06:53:58 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 Ruchika K 2016-08-19 14:32:49 UTC

Description of problem:
The documentation is extremely misleading

https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/paged/red-hat-ceph-storage-for-the-overcloud/chapter-3-integrating-an-existing-ceph-storage-cluster-in-an-overcloudly 

Section 3.4/3/5 speaks of introspecting control and compute nodes.
- This is not necessary at all especially on a ceph admin node
- If the guide speaks to deploying openstack the steps are very incomplete. 
- The title says integrate a ceph cluster to openstack (Maybe these details should be reviewed with the focus of integrating a ceph cluster with an existing openstack deployment)

Our customers do get confused, please help
Version-Release number of selected component (if applicable):
Current 

How reproducible:
100%

Steps to Reproduce:
1.NA
2.NA
3.NA

Actual results:


Expected results:


Additional info:

Comment 3 Ruchika K 2016-08-19 21:38:04 UTC

Case referred to in the customer portal comment #86 has the details truly necessary to integrate an existing ceph cluster.
Please make it easier to follow along.

Comment 4 Ruchika K 2016-08-22 16:58:41 UTC

Customer verified the steps work as well.

Comment 6 Derek 2016-08-22 17:22:24 UTC

The book is part of the OpenStack suite - bug changed to OpenStack so the OSP doc team can deal with it.

Comment 7 Derek 2016-09-16 17:16:46 UTC

Can't access Case referred to in the customer portal comment #86 in comment #3.  Contacted Ruchika for help.