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
- Any storage provided by 3rd party storage backend that is not part of the cloud platform (various storage appliances, Openshift Container Storage, ...)
While it would be nice to backport such documentation to all supported releases, it does not block 4.6
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.