Bug 1879181 - "openshift-install destroy cluster" is not documented
Summary: "openshift-install destroy cluster" is not documented
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 4.6
Hardware: Unspecified
OS: Unspecified
Target Milestone: ---
: 4.7.0
Assignee: Lisa Pettyjohn
QA Contact: Xiaoli Tian
Vikram Goyal
Depends On:
TreeView+ depends on / blocked
Reported: 2020-09-15 15:50 UTC by Jan Safranek
Modified: 2021-10-17 07:51 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Last Closed: 2021-10-17 07:51:37 UTC
Target Upstream Version:

Attachments (Terms of Use)

Description Jan Safranek 2020-09-15 15:50:09 UTC
Describe the issue: 

Command "openshift-install destroy cluster" is not documented at all.

The command has quite important consequence: it destroys all volumes provisioned in the cluster*. While nobody will miss a VM or a network after destroying a cluster, users should be warned in our docs that volumes are destroyed too. They should back up their precious data before running the command.

*) On some cloud platforms, we can't destroy the volumes (it's technically not possible to distinguish volumes that were provisioned for the cluster from other volumes). Again, users should know that they are expected to find and delete the volumes by themselves. Current platforms where we can't delete volumes are:

- bare metal
- oVirt
- vSphere
- Any storage provided by 3rd party storage backend that is not part of the cloud platform (various storage appliances, Openshift Container Storage, ...)

Comment 1 Jan Safranek 2020-09-15 15:50:52 UTC
While it would be nice to backport such documentation to all supported releases, it does not block 4.6

Comment 3 Gal Zaidman 2021-10-17 07:51:37 UTC
Closing this since it is an old issue that is not handled.
I personally don't think it should be documented since it expects a path to an directory containing the metadata.json file which is created on the installation, usually, the openshift user will not save this file for later usage and I think it will cause more confusion for users then benefit.

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