Bug 1395332

Summary: Update the docs on how to integrate an external Ceph cluster
Product: Red Hat OpenStack Reporter: Giulio Fidente <gfidente>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 10.0 (Newton)CC: dmacpher, gfidente, srevivo
Target Milestone: ---Keywords: Documentation
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: 2017-01-17 16:22:17 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 Giulio Fidente 2016-11-15 17:02:08 UTC 
The documentation on how to integrate an external Ceph cluster with the Overcloud [1] should be updated as follows:


a) in section 3.1 we should create more pools, because more services can use Ceph now, specifically: "backups" for cinder-backup and "metrics" for gnocchi-metricsd


b) in section 3.1 the capabilities given to the user must be updated to allow it to use the additional pools:

ceph auth add client.openstack mon 'allow r' osd 'allow class-read object_prefix rbd_children, allow rwx pool=volumes, allow rwx pool=vms, allow rwx pool=images', allow rwx pool=backups, allow rwx pool=metrics


c) in section 3.6 the resource name and implementation file changed as we now use 'roles'

OS::TripleO::CephClusterConfig::SoftwareConfig: /usr/share/openstack-tripleo-heat-templates/puppet/extraconfig/ceph/ceph-external-config.yaml

becomes instead:
  OS::TripleO::Services::CephExternal: /usr/share/openstack-tripleo-heat-templates/puppet/services/ceph-external.yaml


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