Bug 1666681 - Operations Guide 1.2.3.3. Replacing a Node - missing steps how to add node to OCP
Summary: Operations Guide 1.2.3.3. Replacing a Node - missing steps how to add node to...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Container_Native_Storage_with_OpenShift
Version: ocs-3.11
Hardware: Unspecified
OS: Linux
unspecified
medium
Target Milestone: ---
: OCS 3.11.z Batch Update 2
Assignee: Chandrakanth Pai
QA Contact: RamaKasturi
URL: https://access.redhat.com/documentati...
Whiteboard:
Depends On:
Blocks: 1672844
TreeView+ depends on / blocked
 
Reported: 2019-01-16 11:08 UTC by Patric Uebele
Modified: 2022-03-13 16:46 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-04-01 06:08:15 UTC
Embargoed:


Attachments (Terms of Use)
PDF version of the OCS 3.11 Operations Guide (6.94 MB, application/pdf)
2019-03-18 03:28 UTC, Chandrakanth Pai
no flags Details
PDF version of the OCS 3.10 Operations Guide (7.17 MB, application/pdf)
2019-03-19 01:43 UTC, Chandrakanth Pai
no flags Details
PDF version of the OCS 3.10 Operations Guide (7.07 MB, application/pdf)
2019-03-21 05:13 UTC, Chandrakanth Pai
no flags Details
PDF version of the OCS 3.11 Operations Guide (3.32 MB, application/pdf)
2019-03-21 05:14 UTC, Chandrakanth Pai
no flags Details
From stage 3.10 docs (186.97 KB, image/png)
2019-03-21 13:42 UTC, RamaKasturi
no flags Details
screenshot from stage 3.11 docs (187.19 KB, image/png)
2019-03-21 13:43 UTC, RamaKasturi
no flags Details
screenshot from 3.10 docs pdf (241.62 KB, image/png)
2019-03-21 13:44 UTC, RamaKasturi
no flags Details

Description Patric Uebele 2019-01-16 11:08:55 UTC
User-Agent:       Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36
Build Identifier: 

Section "1.2.3.3. Replacing a Node" of the Operations Guide is not mentioning the necessary steps how to add the replacement node to OpenShift before adding it to the Gluster cluster in case it's a converged deployment.

Suggestion: After step 1 (Locate the node...), add the statement below:

For a converged deployment, scale up the OCP cluster to add the replcament node. For more information see, https://access.redhat.com/documentation/en-us/openshift_container_platform/3.11/html-single/configuring_clusters/#adding-cluster-hosts_adding-hosts-to-cluster
Note: If the replacment node is already part of OCP cluster then skip this step and proceed with Step 3.

Reproducible: Always

Comment 3 amansan 2019-01-24 09:26:46 UTC
The customer needs an answer to this questions

The customer wants an answer these questions

1- How the ansible hosts file should look like? (Inventory file)
2- Which playbook to run to scale the gluster node?
3- Any pre or post scale playbooks or steps?

Perhaps these can help you to clarify what it´s necessary to add.

Regards

Comment 9 Chandrakanth Pai 2019-03-18 03:28:57 UTC
Created attachment 1545107 [details]
PDF version of the OCS 3.11 Operations Guide

Comment 10 RamaKasturi 2019-03-18 05:13:21 UTC
Hello chandrakanth,

   Has this fix been ported to 3.10 docs ? If yes, can you please provide the link for the same ? 

Thanks
kasturi

Comment 11 RamaKasturi 2019-03-18 18:59:06 UTC
Changes looks good to me in 3.11 guides. Waiting to be verified in 3.10 guides, keeping it ON_QA until then.

Comment 12 Chandrakanth Pai 2019-03-19 01:07:20 UTC
(In reply to RamaKasturi from comment #11)
> Changes looks good to me in 3.11 guides. Waiting to be verified in 3.10
> guides, keeping it ON_QA until then.

Link to verify the content in 3.10 - https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.10/html-single/operations_guide/#Deleting_Node

Attached the PDF as well

Comment 13 Chandrakanth Pai 2019-03-19 01:43:14 UTC
Created attachment 1545473 [details]
PDF version of the OCS 3.10 Operations Guide

Comment 14 RamaKasturi 2019-03-19 07:36:51 UTC
Hello patric,

  AFAIU, Even if the node is part of OCP cluster, i still see that we need to add the node via heketi-cli to make it part of OCS cluster . 


May be the note should be something like 

scale up the OCP cluster to add the replacement node. For more detail how to add a node, refer to the steps in section "1.1.2.1.  Adding a Node to OCP Cluster" Note: If the replacement node is already part of OCP cluster then skip this step and proceed with Step 2.

Please confirm.

Thanks
kasturi

Comment 15 RamaKasturi 2019-03-19 07:38:20 UTC
Moving the bug to assigned state based on comment 14.

Comment 16 Patric Uebele 2019-03-19 17:21:37 UTC
(In reply to RamaKasturi from comment #14)
> Hello patric,
> 
>   AFAIU, Even if the node is part of OCP cluster, i still see that we need
> to add the node via heketi-cli to make it part of OCS cluster . 
> 
> 
> May be the note should be something like 
> 
> scale up the OCP cluster to add the replacement node. For more detail how to
> add a node, refer to the steps in section "1.1.2.1.  Adding a Node to OCP
> Cluster" Note: If the replacement node is already part of OCP cluster then
> skip this step and proceed with Step 2.
> 
> Please confirm.
> 
> Thanks
> kasturi

That's good. I confirm.

Comment 18 RamaKasturi 2019-03-20 12:23:34 UTC
Hello chandrakanth,

    I do not see the changes present in the links provided at Comment 17 for some reason even after logging in. It would be good if pdf's are attached so that we can verify the same there.

Thanks
kasturi

Comment 20 Chandrakanth Pai 2019-03-21 05:13:40 UTC
Created attachment 1546304 [details]
PDF version of the OCS 3.10 Operations Guide

Comment 21 Chandrakanth Pai 2019-03-21 05:14:22 UTC
Created attachment 1546305 [details]
PDF version of the OCS 3.11 Operations Guide

Comment 22 RamaKasturi 2019-03-21 13:42:15 UTC
Hello chandrakanth,

   I tried verifying both in link and pdf but i still do not see the changes to be present so moving this to verified state. I am attaching the screenshot from pdf & from links for your reference. Please let me know if i am looking at a wrong place. By the way i am logged into the portal


Thanks
kasturi

Comment 23 RamaKasturi 2019-03-21 13:42:56 UTC
Created attachment 1546503 [details]
From stage 3.10 docs

Comment 24 RamaKasturi 2019-03-21 13:43:33 UTC
Created attachment 1546504 [details]
screenshot from stage 3.11 docs

Comment 25 RamaKasturi 2019-03-21 13:44:13 UTC
Created attachment 1546505 [details]
screenshot from 3.10 docs pdf

Comment 27 RamaKasturi 2019-03-22 12:26:59 UTC
Verified in the links present at Comment 26 and i see that changes are present in both the docs 3.10 and 3.11.

Moving the bug to verified state


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