Bug 1656302

Summary: [docs] etcd backup/restore steps move api and controllers configurations wrongly
Product: OpenShift Container Platform Reporter: Kenjiro Nakayama <knakayam>
Component: DocumentationAssignee: Andrea Hoffer <ahoffer>
Status: CLOSED CURRENTRELEASE QA Contact: ge liu <geliu>
Severity: low Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 3.11.0CC: aos-bugs, dmoessne, geliu, jokerman, mmccomas, wsun
Target Milestone: ---   
Target Release: 3.11.z   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-08-11 00:27:35 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Kenjiro Nakayama 2018-12-05 08:05:49 UTC 
Document URL:

  https://docs.openshift.com/container-platform/3.11/admin_guide/assembly_restoring-cluster.html#restoring-etcd-v3-snapshot

Section Number and Name:

 "Restoring etcd v2 & v3 data"

Describe the issue:

The docs states:

  # mv /etc/origin/node/pods/* /etc/origin/node/pods-stopped/

However, this command broke api and controllers pods under /etc/origin/node/pods/.

Suggestions for improvement:

Should be mention:

  # mv /etc/origin/node/pods/etcd.yaml /etc/origin/node/pods-stopped/

also, it looks like there are no steps to restore the etcd.yaml
Comment 2 Andrea Hoffer 2020-07-28 19:40:03 UTC 
PR to fix the etcd backup procedure: https://github.com/openshift/openshift-docs/pull/23394
Preview: http://file.rdu.redhat.com/~ahoffer/2020/BZ-1835196-2/day_two_guide/environment_backup.html#etcd-data-backup_environment-backup (internal)

@Ge Liu can you please review?
Comment 3 Andrea Hoffer 2020-08-04 14:30:29 UTC 
QE approval received in the PR.

PR has been merged.
Comment 4 Andrea Hoffer 2020-08-11 00:27:35 UTC 
Updates are live: https://docs.openshift.com/container-platform/3.11/day_two_guide/environment_backup.html#etcd-data-backup_environment-backup