Bug 1744543 - [DOCS] Master/etcd backup and restore documentation is confusing and needs cleaning up
Summary: [DOCS] Master/etcd backup and restore documentation is confusing and needs cl...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.11.0
Hardware: x86_64
OS: Linux
high
high
Target Milestone: ---
: 3.11.z
Assignee: Andrew Taylor
QA Contact: ge liu
Vikram Goyal
URL:
Whiteboard:
Depends On: 1656397
Blocks:
TreeView+ depends on / blocked
 
Reported: 2019-08-22 11:52 UTC by Vikram Goyal
Modified: 2023-09-07 20:26 UTC (History)
16 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of: 1656397
Environment:
Last Closed: 2020-03-12 19:04:42 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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.


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