Bug 1744543

Summary:	[DOCS] Master/etcd backup and restore documentation is confusing and needs cleaning up
Product:	OpenShift Container Platform	Reporter:	Vikram Goyal <vigoyal>
Component:	Documentation	Assignee:	Andrew Taylor <antaylor>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ge liu <geliu>
Severity:	high	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	high
Version:	3.11.0	CC:	akrastin, antaylor, aos-bugs, clichybi, dmoessne, geliu, jialiu, jokerman, knakayam, ksuzumur, mfuruta, mmccomas, pdwyer, sburke, vigoyal, wsun
Target Milestone:	---
Target Release:	3.11.z
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:	1656397	Environment:
Last Closed:	2020-03-12 19:04:42 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:	1656397
Bug Blocks:

Comment 4 Sean Burke 2020-01-17 16:53:33 UTC

Hi Andrew, was just wondering if there's been any progress on this as the customer was asking during a recent call.

He feels he took the time to review and provide feedback and we've done nothing with it....

Cheers

Sean

Comment 6 Andrew Taylor 2020-02-27 21:10:24 UTC

Hi Sean, 

After discussing etcd v2 procedures with my Content Strategist, we deteremined that removing the etcd v2 steps is the right course of action at this time, as well. I have created a pull request reflecting all of these changes: 

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


Ge Liu, please take a look.

Comment 7 Andrew Taylor 2020-03-02 20:40:41 UTC

Sean,

Please let me know if you approve these changes. 

Thanks,
Andrew

Comment 8 Sean Burke 2020-03-05 10:27:43 UTC

Hi Andrew,

looks good. Only query is Step 10 - After the first instance is running, you can add the remaining peers back into the cluster.

Can a link be put in pointing to the documentation to complete that step? : https://docs.openshift.com/container-platform/3.11/admin_guide/assembly_restore-etcd-quorum.html#adding-etcd-after-restoring_restore-etcd-quorum

Apart from that, looks great, appreciate you working on it

Cheers

Sean

Comment 9 Andrew Taylor 2020-03-05 14:59:28 UTC

Hi Sean,

Because of the way our documentation is assembled and distributed to various sites, I cannot put a link in the steps without risking build issues between docs.openshift.com or the customer portal. The best I can do is just add step 10 that says "Add remaining peers back into the cluster". Is that satisfactory?

Thanks,
Andrew

Comment 11 Sean Burke 2020-03-10 09:48:24 UTC

Hi Andrew,

Acknowledge the linked documentation issue and this is satisfactory

Cheers

Sean

Comment 12 Andrew Taylor 2020-03-10 13:03:42 UTC

Merging- setting release pending.

Comment 13 Andrew Taylor 2020-03-12 19:04:42 UTC

These changes are now live. Setting this bug to closed/current release.