From c7d35d31219f77e76e0fefc543e645003f9d454b Mon Sep 17 00:00:00 2001 From: Lisa Pettyjohn Date: Thu, 13 Jan 2022 13:31:08 -0500 Subject: [PATCH] OSDOCS-3158 - doc removal of upstream vSphere CSI driver --- ...nt-storage-csi-vsphere-install-issues.adoc | 34 +++++++++++++++++++ .../persistent-storage-csi-vsphere.adoc | 6 +++- 2 files changed, 39 insertions(+), 1 deletion(-) create mode 100644 modules/persistent-storage-csi-vsphere-install-issues.adoc diff --git a/modules/persistent-storage-csi-vsphere-install-issues.adoc b/modules/persistent-storage-csi-vsphere-install-issues.adoc new file mode 100644 index 0000000000..50f8e84a05 --- /dev/null +++ b/modules/persistent-storage-csi-vsphere-install-issues.adoc @@ -0,0 +1,34 @@ +// Module included in the following assemblies: +// +// persistent-storage-csi-vsphere.adoc +// + +[id="persistent-storage-csi-vsphere-install-issues_{context}"] += Removing an upstream vSphere CSI Operator Driver + +If you have installed a non-Red Hat vSphere Container Storage Interface (CSI) Operator Driver, and then try to update your cluster to {product-title} 4.11 or later, {product-title} may prevent the update. This occurs because {product-title} 4.10 has a built-in version of the vSphere CSI Operator Driver, and thus after upgrading to 4.10, your cluster may have updates to the next major versions, such as 4.11 of {product-title} disabled if there is a non-Red Hat provided vSphere CSI driver present in the cluster. (product-title} 4.10 clusters are still fully supported and upgrades to bug fix versions of 4.10 (4.10.z) are not blocked, but you must correct this state before updates to next major version of {product-title} can be enabled. + +To correct this issue and update the cluster, you need to uninstall the upstream vSphere CSI Operator Driver. Removing the upstream vSphere CSI driver does not require deletion of associated persistent volume (PV) objects, and no data loss should occur. + +[NOTE] +==== +These instructions may not be complete, so consult the vendor or community provider uninstall guide to ensure removal of the driver and components. +==== + +To uninstall the upstream vSphere CSI Operator Driver: + +. Delete the upstream vSphere CSI driver (VMware vSphere Container Storage Plug-in) Deployment and Daemonset objects. +. Delete the configmap and secret objects that were installed previously with the upstream vSphere CSI Operator Driver. +. Delete the upstream vSphereCSI driver `CSIDriver` object: ++ +[output, terminal] +---- +~ $ oc delete CSIDriver csi.vsphere.vmware.com +---- ++ +[output, terminal] +---- +csidriver.storage.k8s.io "csi.vsphere.vmware.com" deleted +---- + +After you have completed removal of upstream vSphere CSI driver, the {product-title} update automatically resumes. diff --git a/storage/container_storage_interface/persistent-storage-csi-vsphere.adoc b/storage/container_storage_interface/persistent-storage-csi-vsphere.adoc index a892c113f9..0a0f85d9ea 100644 --- a/storage/container_storage_interface/persistent-storage-csi-vsphere.adoc +++ b/storage/container_storage_interface/persistent-storage-csi-vsphere.adoc @@ -31,6 +31,10 @@ include::modules/persistent-storage-csi-about.adoc[leveloffset=+1] include::modules/persistent-storage-csi-vsphere-stor-policy.adoc[leveloffset=+1] -[role="_additional-resources"] +include::modules/persistent-storage-csi-vsphere-install-issues.adoc[leveloffset=+1] + +:FeatureName: vSphere +include::modules/persistent-storage-csi-tp-enable.adoc[leveloffset=+1] + == Additional resources * xref:../../storage/container_storage_interface/persistent-storage-csi.adoc#persistent-storage-csi[Configuring CSI volumes]