Bug 1731410

Summary:	We should be mentioning that RGW creates 6 additional pools in the Ceph cluster
Product:	Red Hat OpenStack	Reporter:	Giulio Fidente <gfidente>
Component:	documentation	Assignee:	Laura Marsh <lmarsh>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	unspecified	Docs Contact:
Priority:	medium
Version:	13.0 (Queens)	CC:	ccopello, dcadzow, lmarsh, mburns
Target Milestone:	---	Keywords:	Documentation, FutureFeature, NoDocsQEReview, 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:
Clones:	1821844 (view as bug list)		Environment:
Last Closed:	2020-04-07 19:26:14 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:	1821844, 1821845, 1821901

Description Giulio Fidente 2019-07-19 11:04:25 UTC

We should be mentioning in the doc that when opting for the deployment of RGW 3 additional pools (needed by RGW) will be created hence the CephPoolDefaultPgNum parameter must be set appropriately.

We have a few references in the doc pointing to how the default pg_num for the ceph pools should be calculated and customized [1]

Ceph allows for a default of 250 pgs per OSD; we should mention in [2] that when opting for the deployment of RGW, 3 more pools will be created hence the default pools pg_num must be calculated accordingly. The default pg_num for all new pools can be set using the heat parameter "CephPoolDefaultPgNum".

Maybe it is worth mentioning this in [3] as well (the sample config yaml)

1. https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/index#custom-ceph-pools
2. https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/index#ceph-rgw
3. https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/index#envfile-createceph

Comment 5 Giulio Fidente 2019-12-06 17:53:05 UTC

Note that, as explained in [1], RGW will create 6 more pools, not just 3 more as initially described in the BZ report. When deployed by OSP Director, the pool names (which follow the RGW zone name) will be:

    .rgw.root
    default.rgw.control
    default.rgw.meta
    default.rgw.log
    default.rgw.buckets.index
    default.rgw.buckets.data

1. https://docs.ceph.com/docs/master/radosgw/pools/#pool-namespaces