Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1547534

Summary: [Docs] Documentation is missing CephAnsibleExtraConfig parameters in Overcloud with Containerized Red Hat Ceph
Product: Red Hat OpenStack Reporter: John Fulton <johfulto>
Component: documentationAssignee: ndeevy <ndeevy>
Status: CLOSED DUPLICATE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: high    
Version: 15.0 (Stein)CC: cminkema, dcadzow, jliberma, jomurphy, ndeevy, srevivo
Target Milestone: ---   
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: 2019-03-28 12:47:18 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 2018-02-21 14:02:01 UTC 
The "Deploying an Overcloud with Containerized Red Hat Ceph" document [1] makes no mention of the CephAnsibleExtraConfig parameter. This is a very useful parameter that any deployment of the type covered in this document should use to correct defaults that may not fit an environment.

At minimum, it should say something along the lines of: Set ceph-ansible parameters with CephAnsibleExtraConfig. This parameters can be used to change any of the defaults found in ceph-ansible/group_vars [2].

The HCI document [3] uses this parameter to override default container memory and CPU settings. It's important the same be done for non-HCI deployments. Please provide an example and then link to the Ceph container guide documentation [4]. 

Also, please mention that users have to put all the CephAnsibleExtraConfig key/values in a single file, as per BZ 1547517. 


[1] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/

[2] https://github.com/ceph/ceph-ansible/tree/master/group_vars

[3] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html-single/hyper-converged_infrastructure_guide/#resource-isolation-ceph-backfill

[4] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/3/html-single/container_guide/#setting-dedicated-resources-for-colocated-daemons
Comment 1 John Fulton 2018-02-21 14:18:38 UTC 
(In reply to John Fulton from comment #0)
> Please provide an example and then link to the Ceph container
> guide documentation [4]. 

Here's an example that OSP12 users could start with my default:

parameter_defaults:
  CephAnsibleExtraConfig:
    ceph_osd_docker_memory_limit: 3g
    ceph_osd_docker_cpu_limit: 1
    ceph_mds_docker_memory_limit: 4g
    ceph_mds_docker_cpu_limit: 1

> [4]
> https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/3/html-
> single/container_guide/#setting-dedicated-resources-for-colocated-daemons
Comment 5 John Fulton 2019-03-28 12:47:18 UTC 
The example suggested in this bug to include coverage of CephAnsibleExtraConfig is not as good as the example suggested in doc bug 1690086.

(also providing an example of memory_limit is something we should avoid as per doc bug 1668941)

*** This bug has been marked as a duplicate of bug 1690086 ***