Bug 1389517 - [DOCS] cluster backup/restore docs include unnecessary steps
Summary: [DOCS] cluster backup/restore docs include unnecessary steps
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.2.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ---
: ---
Assignee: Ashley Hardin
QA Contact: Anping Li
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-10-27 18:58 UTC by Luke Meyer
Modified: 2017-01-24 17:54 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-01-24 17:54:07 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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


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