From 39719edea12c31a0eeff07ab4fdb8a7014b652a6 Mon Sep 17 00:00:00 2001 From: Chinmayi Chandrasekar Date: Thu, 11 Nov 2021 16:25:00 +0530 Subject: [PATCH] BZ1873575: added a section called reinstalling the OCP cluster --- installing/installing-troubleshooting.adoc | 5 ++++ modules/restarting-installation.adoc | 29 ++++++++++++++++++++++ 2 files changed, 34 insertions(+) create mode 100644 modules/restarting-installation.adoc diff --git a/installing/installing-troubleshooting.adoc b/installing/installing-troubleshooting.adoc index 1cff629b2a..28d7eebe53 100644 --- a/installing/installing-troubleshooting.adoc +++ b/installing/installing-troubleshooting.adoc @@ -19,3 +19,8 @@ include::modules/manually-gathering-logs-with-ssh.adoc[leveloffset=+1] include::modules/manually-gathering-logs-without-ssh.adoc[leveloffset=+1] include::modules/installation-getting-debug-information.adoc[leveloffset=+1] + +include::modules/restarting-installation.adoc[leveloffset=+1] + +.Additional resources +* xref:../installing/index.adoc#ocp-installation-overview[Installing an {product-title} cluster] diff --git a/modules/restarting-installation.adoc b/modules/restarting-installation.adoc new file mode 100644 index 0000000000..f20195c31b --- /dev/null +++ b/modules/restarting-installation.adoc @@ -0,0 +1,29 @@ +// Module included in the following assemblies: +// +// installing/installing-troubleshooting.adoc + +[id="restarting-installation_{context}"] += Reinstalling the {product-title} cluster + +If you are unable to debug and resolve issues in the failed {product-title} installation, consider installing a new {product-title} cluster. Before starting the installation process again, you must complete thorough cleanup. +For a user-provisioned infrastructure (UPI) installation, you must manually destroy the cluster and delete all associated resources. The following procedure is for an installer-provisioned infrastructure (IPI) installation. + +.Procedure + +. Destroy the cluster and remove all the resources associated with the cluster, including the hidden installer state files in the installation directory: ++ +[source, terminal] +---- +$ ./openshift-install destroy cluster --dir= <1> +---- +<1> `installation_directory` is the directory you specified when you ran `./openshift-install create cluster`. This directory contains the {product-title} +definition files that the installation program creates. + +. Before reinstalling the cluster, delete the installation directory: ++ +[source, terminal] +---- +$ rm -rf +---- + +. Follow the procedure for installing a new {product-title} cluster.