Bug 1527660
| Summary: | [Docs] Document how to override containerized Ceph OSD memory and CPU usage | ||
|---|---|---|---|
| Product: | Red Hat OpenStack | Reporter: | John Fulton <johfulto> |
| Component: | documentation | Assignee: | Kim Nylander <knylande> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Dan Macpherson <dmacpher> |
| Severity: | unspecified | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | 12.0 (Pike) | CC: | bengland, dmacpher, gcharot, johfulto, jomurphy, knylande, shan, srevivo |
| Target Milestone: | --- | Keywords: | Documentation |
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | 12.0 | Doc Type: | If docs needed, set a value |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2018-01-31 15:13:50 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: | |||
I've introduced the comments I am requesting, and others, in the upstream document for review at: https://review.openstack.org/#/c/531214 I request the following update to this docbug:
"""
Each containerized OSD may be limited in GB of RAM and vCPUs through the `docker run` command's `--memory` and `--cpu-quota` options. To override these values use an example like the following which reserves 3 GB of RAM and 1 vCPUs per OSD:
parameter_defaults:
CephAnsibleExtraConfig:
ceph_osd_docker_memory_limit: 3g
ceph_osd_docker_cpu_limit: 1
To determine appropriate values for the above settings, see the Red Hat Ceph Storage Hardware Guide.
https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/2/html-single/red_hat_ceph_storage_hardware_guide/index#intel_hardware_guide
"""
|
The OSP12 documents should describe how to override containerized Ceph OSD memory and CPU usage. A proposal to do this is below. In the OSP12 Ceph document [1] would you please add a new section 5.3 "Reserving Memory and CPU resources for Ceph" with content like the following: """ By default each containerized OSD is limited to 1 GB of RAM and 1 vCPU. These values are based on the minimum recommendations [3] but may not be appropriate depending on hardware. These settings may be overridden using an example like the following which reserves 3 GB of RAM and 1 vCPUs per OSD: parameter_defaults: CephAnsibleExtraConfig: ceph_osd_docker_memory_limit: 3g ceph_osd_docker_cpu_limit: 1 To determine appropriate values for the above settings, see the Red Hat Ceph Storage Hardware Guide [4]. """ Please also update the HCI document for OSP12 [2] to have a section 4.3 "Reserving Memory and CPU resources for Ceph" which also contains the same content or links to new section described above. [1] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html/deploying_an_overcloud_with_containerized_red_hat_ceph/configuring_ceph_storage_cluster_settings [2] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html/hyper-converged_infrastructure_guide/resource-isolation#resource-isolation-cpu-ram [3] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/2/html/red_hat_ceph_storage_hardware_guide/minimum_recommendations [4] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/2/html-single/red_hat_ceph_storage_hardware_guide/index#intel_hardware_guide