Bug 1304954 - [openshift-doc] Need documentation of adding new node by scale up playbooks
Summary: [openshift-doc] Need documentation of adding new node by scale up playbooks
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
low
medium
Target Milestone: ---
: ---
Assignee: Alex Dellapenta
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-02-05 04:25 UTC by Kenjiro Nakayama
Modified: 2019-10-10 11:06 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-07-15 17:22:20 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Knowledge Base (Solution) 2150381 0 None None None 2016-04-14 15:33:55 UTC

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


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