[enterprise-4.4] CP of PR#24043

installing/installing_vsphere/installing-restricted-networks-vsphere.adoc

@@ -80,6 +80,8 @@ include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
 
 include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3]
 
+For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere].
+
 include::modules/installation-complete-user-infra.adoc[leveloffset=+1]
 
 

installing/installing_vsphere/installing-vsphere-network-customizations.adoc

@@ -71,6 +71,8 @@ include::modules/registry-removed.adoc[leveloffset=+2]
 
 include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
 
+For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere].
+
 include::modules/installation-complete-user-infra.adoc[leveloffset=+1]
 
 

installing/installing_vsphere/installing-vsphere.adoc

@@ -73,6 +73,10 @@ include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
 
 include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3]
 
+include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3]
+
+For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere].
+
 include::modules/installation-complete-user-infra.adoc[leveloffset=+1]
 
 

modules/installation-registry-storage-block-recreate-rollout.adoc

@@ -0,0 +1,23 @@
+// Module included in the following assemblies:
+//
+// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
+// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
+// * installing/installing_vsphere/installing-vsphere.adoc
+// * registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc
+
+[id="installation-registry-storage-block-recreate-rollout_{context}"]
+= Configuring block registry storage for VMware vSphere
+
+To allow the image registry to use block storage types such as vSphere Virtual Machine Disk (VMDK) during upgrades as a cluster administrator, you can use the `Recreate` rollout strategy.
+
+.Procedure
+
+. To set the image registry storage as a block storage type, patch the registry so that it uses the `Recreate` rollout strategy and runs with only `1` replica:
++
+----
+$ oc patch config.imageregistry.operator.openshift.io/cluster --type=merge -p '{"spec":{"rolloutStrategy":"Recreate","replicas":1}}'
+----
++
+. Provision the PV for the block storage device, and create a PVC for that volume. The requested block volume uses the ReadWriteOnce (RWO) access mode.
++
+. Edit the registry configuration so that it references the correct PVC.

registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc

@@ -14,6 +14,10 @@ include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+1]
 
 include::modules/installation-registry-storage-non-production.adoc[leveloffset=+1]
 
+include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+1]
+
+For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere].
+
 [id="configuring-registry-storage-vsphere-addtl-resources"]
 == Additional resources