Bug 1304954

Summary: [openshift-doc] Need documentation of adding new node by scale up playbooks
Product: OpenShift Container Platform Reporter: Kenjiro Nakayama <knakayam>
Component: DocumentationAssignee: Alex Dellapenta <adellape>
Status: CLOSED CURRENTRELEASE QA Contact: Vikram Goyal <vigoyal>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: low    
Version: 3.1.0CC: adellape, aos-bugs, dlbewley, ederevea, fredoche, jdetiber, jokerman, jswensso, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-07-15 17:22:20 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:

Description Kenjiro Nakayama 2016-02-05 04:25:29 UTC
Description of problem:
- From v3.1.x, playbook scaleup.yml has been released and we can use scale up playbook to add new node. It will not make any change to the existing node.

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

Document URL: 
- There are no existing doc.
- Maybe it is beeter to add it to this https://docs.openshift.com/enterprise/3.1/admin_guide/manage_nodes.html 


Additional info:
- There is a KCS https://access.redhat.com/solutions/2150381

Comment 3 Alex Dellapenta 2016-02-09 19:15:58 UTC
Working on this this week.

Comment 4 fred 2016-03-03 16:51:26 UTC
Hi Alex,

Thanks for working on that. I'm quite curious about the recommended/rigt way to use this scaleup script. Is this task of documenting it still on track or has it been postponed?

Thanks anyways

Comment 5 Alex Dellapenta 2016-03-03 16:56:56 UTC
(In reply to fred from comment #4)
> Hi Alex,
> 
> Thanks for working on that. I'm quite curious about the recommended/rigt way
> to use this scaleup script. Is this task of documenting it still on track or
> has it been postponed?
> 
> Thanks anyways

Sorry, it got waylaid since my last comment, but definitely still high on my list. I hope to have something within the week. Apologies for the delay.

Comment 6 Alex Dellapenta 2016-04-07 23:08:11 UTC
Sorry, finally getting back to this. See the description in the following PR for links to internal preview builds of what I've got so far:

https://github.com/openshift/openshift-docs/pull/1875

Comment 7 openshift-github-bot 2016-04-13 19:11:09 UTC
Commit pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/7ef3c8e5b70dceed8a3c6e5b5515b7ccf17c6fbc
Merge pull request #1875 from adellape/add_node

Bug 1304954: Updated steps for adding nodes

Comment 8 Alex Dellapenta 2016-04-13 19:13:55 UTC
PR tech/peer reviewed and merged. Pending release in the next OSE 3.1 docs update (next week).

Comment 9 Evgheni Dereveanchin 2016-04-14 15:30:18 UTC
I want to note that the scaleup playbook seems to run oc commands as the OpenShift user currently logged in. So we must inform users to log in as system:admin before running the playbook, otherwise it may fail at labeling nodes with error:

stderr: Error from server: User "myuser" cannot update nodes at the cluster scope

Comment 10 Evgheni Dereveanchin 2016-04-14 16:13:01 UTC
quick update - just tried to reproduce it with a non-default user with cluster admin rights and it worked. So probably just related to permissions, will re-test later with a limited user.

Comment 11 Evgheni Dereveanchin 2016-04-15 06:20:58 UTC
I logged bz#1327409 regarding this behavior. In general - if the user logged into oc does not have cluster-admin permissions, the playbook will fail.

Comment 12 dlbewley 2016-07-13 20:50:29 UTC
This doc* worked fine for v3.1 does it work on v3.2? 

I assume it will still work, but the doc is titled:

"How to add new Node in OpenShift v3.1"

* https://access.redhat.com/solutions/2150381

Comment 13 Alex Dellapenta 2016-07-15 17:22:20 UTC
(In reply to dlbewley from comment #12)
> This doc* worked fine for v3.1 does it work on v3.2? 
> 
> I assume it will still work, but the doc is titled:
> 
> "How to add new Node in OpenShift v3.1"
> 
> * https://access.redhat.com/solutions/2150381

The file path changed slightly in 3.2 (noted in step 2 of that KBase). The OSE 3.2 docs have steps for adding nodes for both the advanced and quick install paths:

https://docs.openshift.com/enterprise/3.2/install_config/install/advanced_install.html#adding-nodes-advanced

https://docs.openshift.com/enterprise/3.2/install_config/install/quick_install.html#quick-before-you-begin