Bug 1802304

Summary:	[docs] document pre-deployment validations for Ceph
Product:	Red Hat OpenStack	Reporter:	John Fulton <johfulto>
Component:	documentation	Assignee:	Laura Marsh <lmarsh>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	13.0 (Queens)	CC:	lmarsh, nweinber
Target Milestone:	z2	Keywords:	ZStream
Target Release:	---
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:	2020-10-29 19:43:15 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 John Fulton 2020-02-12 20:43:55 UTC

We need to document how OSP13 users can use the new validations introduced in bz1760567 and bz1777336. 

Please write a new "book" describing how to use the pre-deployment ceph validations (sample copy to follow) and add it to the following docs.

1. It could be a new chapter of things you do after you've deployed your undercloud but before you deploy your overcloud

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/deploying_an_overcloud_with_containerized_red_hat_ceph/index

2. It could be a prereq for external ceph since external ceph requires the right ceph-ansible too. 

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/integrating_an_overcloud_with_an_existing_red_hat_ceph_cluster/index

3. It could be a new assumption added to HCI doc:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/hyper-converged_infrastructure_guide/introduction#intro-assumptions

Comment 1 John Fulton 2020-02-12 20:50:40 UTC

The undercloud contains ansible-based validations which should be run before deploying the overcloud to identify potential problems. These validations can help you avoid debugging overcloud deployment failures by looking for common problems before they happen. 

To ensure that the correction version of ceph-ansible is installed run the following:

 ansible-playbook -i /usr/bin/tripleo-ansible-inventory /usr/share/openstack-tripleo-validations/validations/ceph-ansible-installed.yaml