Bug 1653448

Summary: [OSP13] [Docs] HCI guide contains confusing information on NovaReservedHostMemory parameter
Product: Red Hat OpenStack Reporter: Alberto Rivera Laporte <ariveral>
Component: documentationAssignee: Laura Marsh <lmarsh>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: medium    
Version: 13.0 (Queens)CC: ariveral, dcadzow, lmarsh, mburns
Target Milestone: zstreamKeywords: Triaged, ZStream
Target Release: 13.0 (Queens)   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: docs-accepted
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1744162 (view as bug list) Environment:
Last Closed: 2019-08-21 13:32:44 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:
Bug Depends On:    
Bug Blocks: 1744162, 1744168    

Description Alberto Rivera Laporte 2018-11-26 21:46:47 UTC 
Description of problem:



OSP13 HCI Documentation Guide Section 4.1.1[0] contains an explanation of the THT parameter definition for 'NovaReservedHostMemory' that appears confusing to a new user.


Current explanation:  

```
The NovaReservedHostMemory parameter sets how much RAM should be reserved for the Ceph OSD services and per-guest instance overhead on hyper-converged nodes.
```


Explanation according to the nova.conf[1]: 


```
#
# Amount of memory in MB to reserve for the host so that it is always available
# to host processes. The host resources usage is reported back to the scheduler
# continuously from nova-compute running on the compute node. To prevent the
# host
# memory from being considered as available, this option is used to reserve
# memory for the host.
```

The explanation in Red Hat OSP13 documentation appears to state that 'NovaReservedHostMemory' should also reserve memory used for guests/instances in hyperconverged nodes when the purpose of that parameter is to reserve memory for host processes so that memory it is not used for instances.


Let me know if request is unclear -- Thank you.





[0]
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html-single/hyper-converged_infrastructure_guide/#CO2-1


[1]
https://docs.openstack.org/nova/queens/configuration/sample-config.html