Bug 1389517

Summary: [DOCS] cluster backup/restore docs include unnecessary steps
Product: OpenShift Container Platform Reporter: Luke Meyer <lmeyer>
Component: DocumentationAssignee: Ashley Hardin <ahardin>
Status: CLOSED CURRENTRELEASE QA Contact: Anping Li <anli>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 3.2.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
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: 2017-01-24 17:54:07 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 Luke Meyer 2016-10-27 18:58:39 UTC 
Document URL: 
https://docs.openshift.org/latest/admin_guide/backup_restore.html#cluster-backup

Section Number and Name: 
https://docs.openshift.org/latest/admin_guide/backup_restore.html#cluster-backup
https://docs.openshift.org/latest/admin_guide/backup_restore.html#cluster-restore

Describe the issue: 
https://docs.openshift.org/latest/admin_guide/backup_restore.html#cluster-backup includes instructions for API object backup both via etcd backup and with `oc export`. I haven't run through all this but I think `oc export` and `oc create` are just going to give the user a big fat list of errors and not accomplish anything, because the etcd backup/restore has already covered everything in the API and `oc export all` only does a small subset of API objects anyway.

Suggestions for improvement: 
In short, I think backup step 4 and restore step 5 are completely unnecessary here and can be removed.
Comment 1 Ashley Hardin 2016-12-01 20:05:50 UTC 
Work in progress:
https://github.com/openshift/openshift-docs/pull/3310
Comment 2 Anping Li 2016-12-08 03:26:58 UTC 
I agree with Luke Meyer. Move to verified.
Comment 3 openshift-github-bot 2016-12-08 16:35:06 UTC 
Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/fa486bc507966bf2f8e5c06ebd1f9ea5952dc85e
Bug 1389517, removed unnecessary steps from cluster backup and restore procedures

https://github.com/openshift/openshift-docs/commit/2152a80c3f5c654c3d4f1ad225e5c9eb69afa2d1
Merge pull request #3310 from ahardin-rh/backup-restore-updates

Bug 1389517, removed unnecessary steps from cluster backup/restore procedures
Comment 4 Ashley Hardin 2017-01-24 17:54:07 UTC 
Content is published: 
https://access.redhat.com/documentation/en/openshift-container-platform/3.4/paged/cluster-administration/chapter-30-backup-and-restore

https://access.redhat.com/documentation/en/openshift-container-platform/3.4/single/developer-guide/#export-as-template