Bug 1666681

Summary: Operations Guide 1.2.3.3. Replacing a Node - missing steps how to add node to OCP
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Patric Uebele <puebele>
Component: doc-Container_Native_Storage_with_OpenShiftAssignee: Chandrakanth Pai <chpai>
Status: CLOSED CURRENTRELEASE QA Contact: RamaKasturi <knarra>
Severity: medium Docs Contact:
Priority: unspecified    
Version: ocs-3.11CC: amanzane, asriram, chpai, knarra, pdwyer, puebele, rhs-bugs, sankarshan, storage-doc
Target Milestone: ---Keywords: ZStream
Target Release: OCS 3.11.z Batch Update 2   
Hardware: Unspecified   
OS: Linux   
URL: https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html/operations_guide/ch01s02#Deleting_Node
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-04-01 06:08:15 UTC Type: ---
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: 1672844    
Attachments:
Description Flags
PDF version of the OCS 3.11 Operations Guide
none
PDF version of the OCS 3.10 Operations Guide
none
PDF version of the OCS 3.10 Operations Guide
none
PDF version of the OCS 3.11 Operations Guide
none
From stage 3.10 docs
none
screenshot from stage 3.11 docs
none
screenshot from 3.10 docs pdf none

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