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

Bug 1533111

Summary: [Docs] Inaccurate CephPools parameter documentation
Product: Red Hat OpenStack Reporter: Gregory Charot <gcharot>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 12.0 (Pike)CC: dmacpher, gcharot, gfidente, jjoyce, jomurphy, srevivo
Target Milestone: ---Keywords: Documentation, Triaged, ZStream
Target Release: 12.0 (Pike)   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-02-26 05:51:16 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 Gregory Charot 2018-01-10 13:32:54 UTC
Description of problem:

Doc[1] mention non-existing options for CephPools parameter

parameter_defaults:
  CephPools:
      [{"name": POOL, "size": 5, "pg_num": 128, "pgp_num": 128}]

pgp_num and size are not processed by ceph-ansible, options are ignored so no impact.

Moreover i would suggest to provide a yaml syntax instead in order to be consistent with the rest of the doc + easier to read

parameter_defaults:
  CephPools:
    - name: POOL
      pg_num: 128

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

Version-Release number of selected component (if applicable):

12

How reproducible:

Always

Steps to Reproduce:
1.
2.
3.

Actual results:

parameter_defaults:
  CephPools:
      [{"name": POOL, "size": 5, "pg_num": 128, "pgp_num": 128}]


Expected results:


Additional info:

Below the ceph-ansible playbook that actually creates the pools as you can see no size & pgp_num options exist.

grep -A2 "create openstack pool" /usr/share/ceph-ansible/roles/ceph-mon/tasks/openstack_config.yml

- name: create openstack pool(s)
  command: "{{ docker_exec_cmd }} ceph --cluster {{ cluster }} osd pool create {{ item.name }} {{ item.pg_num }} {{ item.rule_name }}"
  with_items: "{{ openstack_pools | unique }}"

Comment 4 Dan Macpherson 2018-02-13 05:26:28 UTC
Hi Gregory,

This should be fixed now:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/#custom-ceph-pools

Was there anything else required for this BZ?

Comment 5 Gregory Charot 2018-02-13 09:54:29 UTC
Thanks Dan, looks good.

CephPools can also be used to create additional Ceph pools not only modifying the default ones. That can be interesting to mention.

Comment 6 Dan Macpherson 2018-02-26 05:51:16 UTC
Thanks, Greg. Added some extra content around additional pools:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/#custom-ceph-pools

Closing this BZ.