Bug 1311657 - [Docs] "Configuring Ceph with Custom Config Settings"
Summary: [Docs] "Configuring Ceph with Custom Config Settings"
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 8.0 (Liberty)
Hardware: All
OS: Linux
high
high
Target Milestone: ---
: 9.0 (Mitaka)
Assignee: Dan Macpherson
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
: 1319328 (view as bug list)
Depends On:
Blocks: 1261979 1335593
TreeView+ depends on / blocked
 
Reported: 2016-02-24 17:00 UTC by Alan Bishop
Modified: 2017-03-13 15:37 UTC (History)
21 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Add support for configuring more Ceph parameters
Clone Of:
Environment:
Last Closed: 2017-03-13 13:55:37 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Alan Bishop 2016-02-24 17:00:49 UTC
Description of problem:

The TripleO heat templates for Ceph only support a limited number of parameters for inclusion in the ceph.conf file. The following parameters need to be supported in order to properly manage and tune the Ceph cluster:

  max open files
  osd op threads
  osd mkfs options
  osd mount options
  filestore max sync interval
  filestore xattr use omap

Ideally, the heat template syntax would support adding any parameter to the ceph.conf file. That way the heat template itself wouldn't need to change, but additional entries could be added to the ceph.conf file by adding the data to the ceph.yaml hieradata file.

Expected results:

Additional parameters can be added to ceph.conf

Comment 2 Mike Burns 2016-04-07 21:11:06 UTC
This bug did not make the OSP 8.0 release.  It is being deferred to OSP 10.

Comment 4 Giulio Fidente 2016-04-29 21:11:33 UTC
It should be possible to provide arbitary config params for ceph by passing the following via environment file:

parameter_defaults:
  ExtraConfig:
    ceph_classes:
      - ceph::confg
    ceph::config:
      DEFAULT/my_ceph_parameter:
        value: my_value
      DEFAULT/another_parameter:
        value: another_value

which should result in ceph.conf being populated with something like:

[DEFAULT]
my_ceph_parameter: my_value
another_parameter: another_value

Comment 5 Alan Bishop 2016-05-10 17:21:31 UTC
This isn't working for me. Here is what I added to an environment file that is part of our solution:

parameter_defaults:
  ExtraConfig:
    ceph_classes:
      - ceph::conf
    ceph::conf:
      global/max_open_files:
        value: 131072

Note: Deployments failed until I determined the proper ceph_classes name is "ceph::conf" (not "ceph::confg" or "ceph::config").

The overcloud deployment succeeds, but no additional entry appears in ceph.conf. The hiera data appears to be correct:

[heat-admin@overcloud-cephstorage-0 ~]$ sudo hiera ceph_classes
["ceph::conf"]
[heat-admin@overcloud-cephstorage-0 ~]$ sudo hiera ceph::conf
{"global/max_open_files"=>{"value"=>131072}}

I expected to find a "max_open_files" entry in the [global] section of ceph.conf, but there isn't one.

Comment 6 Giulio Fidente 2016-05-20 04:43:22 UTC
hi Alan, please excuse me but the syntax I suggested in comment #4 is indeed wrong; if I remember correctly we wrote it down together during a session at the summit but I didn't test it. My bad.

The correct syntax is:

parameter_defaults:
  ExtraConfig:
    ceph_classes:
      - ceph::conf
    ceph::conf::args:
      DEFAULT/my_ceph_parameter:
        value: my_value
      DEFAULT/another_parameter:
        value: another_value

which in your use case ( comment #6 ) would become:

parameter_defaults:
  ExtraConfig:
    ceph_classes:
      - ceph::conf
    ceph::conf:args:
      global/max_open_files:
        value: 131072

I tested it this time and it works as intended.

As a side note, with OSP8 templates we also don't need to pass ::conf as an additional class (in ceph_classes) because it's included by default so one could remove:

    ceph_classes:
      - ceph::conf

Comment 7 Giulio Fidente 2016-05-20 05:49:49 UTC
(In reply to Alan Bishop from comment #5)
> This isn't working for me. Here is what I added to an environment file that
> is part of our solution:
> 
> parameter_defaults:
>   ExtraConfig:
>     ceph_classes:
>       - ceph::conf
>     ceph::conf:
>       global/max_open_files:
>         value: 131072

this should be:

parameter_defaults:
  ExtraConfig:
    ceph_classes:
      - ceph::conf
    ceph::conf::args:
      global/max_open_files:
        value: 131072

Comment 8 Alan Bishop 2016-05-24 14:13:17 UTC
Giulio, I confirmed the corrected syntax you provided works as you describe. Thanks!

On one hand, this RFE is not needed because the capability already exists. On the other hand, I have not seen any documentation that explains how to use the capability.

I recommend adding a write-up to an appropriate section in the Red Hat OpenStack Platform Partner Integration guide (https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/partner-integration/partner-integration).

Comment 9 Giulio Fidente 2016-05-31 16:10:15 UTC
Alan, I am adding some docs in tripleo.org to document this feature [1].

Do you think we can move the BZ to docs and do something similar with the official RH OSP documentation?

1. https://review.openstack.org/#/c/323464/

Comment 10 Alan Bishop 2016-05-31 17:39:42 UTC
That sounds like a good idea to me.

Comment 12 Karl Hastings 2016-07-15 00:22:46 UTC
Since the feature exists, and this is now a docs bug, I'm changing the flags back to rhos-9.0? to match the Target Release "9.0 (Mitaka)"

Comment 13 Sean Cohen 2016-08-16 16:56:57 UTC
*** Bug 1319328 has been marked as a duplicate of this bug. ***

Comment 14 Dan Macpherson 2017-03-03 05:12:45 UTC
It looks like this BZ fell through the cracks.

There's a page for this content here:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/9/html/red_hat_ceph_storage_for_the_overcloud/creation#Configuring_Ceph_Storage_Cluster_Settings

Same content appears on OSP10 and OSP11 branches.

@Giulio, is there anything further we need for this content?

Comment 15 Giulio Fidente 2017-03-13 13:29:33 UTC
thanks Dan, I think the example in the link you posted is fine, Alan do you think it is sufficient? Maybe we can close this as CURRENTRELEASE?

Comment 16 Alan Bishop 2017-03-13 13:55:37 UTC
I reviewed the documentation at the link Dan provided, and feel it does a very good job of explaining things. I agree this BZ can be closed.

Comment 17 Dan Macpherson 2017-03-13 15:37:16 UTC
Thanks, guys!


Note You need to log in before you can comment on or make changes to this bug.