Bug 1325409 - [DOCS] Reserve Resources documentation is unclear
Summary: [DOCS] Reserve Resources documentation is unclear
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ---
: ---
Assignee: Thien-Thi Nguyen
QA Contact: Wenjing Zheng
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-04-08 18:22 UTC by Eric Jones
Modified: 2019-10-10 11:49 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-06-23 15:48:37 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Eric Jones 2016-04-08 18:22:41 UTC
Document URL: 
https://docs.openshift.com/enterprise/3.1/admin_guide/overcommit.html#reserving-resources-for-system-processes 

Section Number and Name: 
Reserving Resources for System Processes

Describe the issue: 
The documentation on how to implement this is very vague (how do I get the pod deployed), does not indicate if the pod will be a container on the node that is only visible by docker or if it will be a proper OSE pod, and it does not indicate what to start (service or reboot the whole node).

Suggestions for improvement: 
Clarify all of these points, and indicate what to look for if the pod is not starting.

Comment 1 Jan Chaloupka 2016-04-12 16:22:10 UTC
Have been playing with ose and trying to create the resource-reserver pod as is written in the documentation. I have not been able to have the pod created. I have dropped the yaml file under /etc/origin/node directory, restarted atomic-openshift-node.service service (many times). Nothing.

Of course, running 'oc create -f resource-reserver.yaml' will create the pod.

Maybe additional configuration of the node is required to have the running daemon read all yaml file with object specification and create them.

Comment 2 Jan Chaloupka 2016-04-12 16:54:38 UTC
Ok, node-config.yaml has to be updated. Adding:

kubeletArguments:
  config:
    - "/etc/origin/node"

will read yaml files from /etc/origin/node. Once configure, resource-reserver pod is created as well.

Comment 3 Jan Chaloupka 2016-04-12 17:04:22 UTC
Running 'oc delete resource-reserver-pod-id` will not delete the pod. If an operator wish to delete the pod, node-config.yaml has to be updated again. To e.g.

kubeletArguments:
  config:
    - ""

Or the resource-reserver.yaml has to be removed from /etc/origin/node.

Comment 4 Jan Chaloupka 2016-04-13 10:20:27 UTC
Upstream PR [1].

[1] https://github.com/openshift/openshift-docs/pull/1892


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