Merge pull request #59382 from bscott-rh/OCPBUGS-5852-update

bscott-rh · web-flow · commit 047e3c277037 · 2023-05-03T12:46:13.000-04:00
OCPBUGS#5852 updating minimum storage requirements
diff --git a/installing/installing_azure/installing-azure-account.adoc b/installing/installing_azure/installing-azure-account.adoc
@@ -20,6 +20,11 @@ in the Azure documentation.
 
 include::modules/installation-azure-limits.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+
 include::modules/installation-azure-network-config.adoc[leveloffset=+1]
 
 include::modules/installation-azure-increasing-limits.adoc[leveloffset=+1]
diff --git a/installing/installing_azure/installing-azure-user-infra.adoc b/installing/installing_azure/installing-azure-user-infra.adoc
@@ -43,6 +43,12 @@ All Azure resources that are available through public endpoints are subject to r
 ====
 
 include::modules/installation-azure-limits.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+
 include::modules/installation-azure-network-config.adoc[leveloffset=+2]
 
 You can view Azure's DNS solution by visiting this xref:installation-azure-create-dns-zones_{context}[example for creating DNS zones].
diff --git a/installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc b/installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc
@@ -15,6 +15,11 @@ All Azure resources that are available through public endpoints are subject to r
 
 include::modules/installation-azure-limits.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+
 include::modules/installation-azure-stack-hub-network-config.adoc[leveloffset=+1]
 
 include::modules/installation-azure-stack-hub-permissions.adoc[leveloffset=+1]
diff --git a/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc b/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.adoc
@@ -42,6 +42,12 @@ All Azure Stack Hub resources that are available through public endpoints are su
 ====
 
 include::modules/installation-azure-limits.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].
+
 include::modules/installation-azure-stack-hub-network-config.adoc[leveloffset=+2]
 
 You can view Azure's DNS solution by visiting this xref:installation-azure-create-dns-zones_{context}[example for creating DNS zones].
diff --git a/modules/installation-azure-limits.adoc b/modules/installation-azure-limits.adoc
@@ -106,9 +106,7 @@ ifndef::ash[]
 |OS Disk
 |7
 |
-|VM OS disk must be able to sustain a tested and recommended minimum throughput of 5000 IOPS / 200MBps for control plane machines. This throughput can be provided by having a minimum of 1 TiB Premium SSD (P30). In {cp}, disk performance is directly dependent on SSD disk sizes, so to achieve the throughput supported by `Standard_D8s_v3`, or other similar machine types available, and the target of 5000 IOPS, at least a P30 disk is required.
-
-Host caching must be set to `ReadOnly` for low read latency and high read IOPS and throughput. The reads performed from the cache, which is present either in the VM memory or in the local SSD disk, are much faster than the reads from the data disk, which is in the blob storage.
+|Each cluster machine must have a minimum of 100 GB of storage and 300 IOPS. While these are the minimum supported values, faster storage is recommended for production clusters and clusters with intensive workloads. For more information about optimizing storage for performance, see the page titled "Optimizing storage" in the "Scalability and performance" section.
 endif::ash[]
 
 |VNet
diff --git a/modules/optimizing-storage-azure.adoc b/modules/optimizing-storage-azure.adoc
@@ -0,0 +1,16 @@
+// Module included in the following assembly:
+//
+// * ../scalability_and_performance/optimizing-storage.adoc
+
+:_content-type: REFERENCE
+
+[id="optimizing-storage-azure_{context}"]
+= Optimizing storage performance for Microsoft Azure
+
+{product-title} and Kubernetes are sensitive to disk performance, and faster storage is recommended, particularly for etcd on the control plane nodes. 
+
+For production Azure clusters and clusters with intensive workloads, the virtual machine operating system disk for control plane machines should be able to sustain a tested and recommended minimum throughput of 5000 IOPS / 200MBps. 
+This throughput can be provided by having a minimum of 1 TiB Premium SSD (P30). 
+In Azure and Azure Stack Hub, disk performance is directly dependent on SSD disk sizes. To achieve the throughput supported by a `Standard_D8s_v3` virtual machine, or other similar machine types, and the target of 5000 IOPS, at least a P30 disk is required.
+
+Host caching must be set to `ReadOnly` for low latency and high IOPS and throughput when reading data. Reading data from the cache, which is present either in the VM memory or in the local SSD disk, is much faster than reading from the disk, which is in the blob storage.
diff --git a/scalability_and_performance/optimizing-storage.adoc b/scalability_and_performance/optimizing-storage.adoc
@@ -30,6 +30,8 @@ include::modules/recommended-configurable-storage-technology.adoc[leveloffset=+1
 
 include::modules/data-storage-management.adoc[leveloffset=+1]
 
+include::modules/optimizing-storage-azure.adoc[leveloffset=+1]
+
 [role="_additional-resources"]
 [id="admission-plug-ins-additional-resources"]
 == Additional resources
