Merge pull request #71799 from xenolinux/document-matrix

OSDOCS#9701: Add considerations and upgrading scenarios for HCP

Author: jldohmann

hosted_control_planes/index.adoc

@@ -17,9 +17,10 @@ include::modules/hosted-control-planes-overview.adoc[leveloffset=+1]
 
 include::modules/hosted-control-planes-concepts-personas.adoc[leveloffset=+1]
 include::modules/hosted-control-planes-version-support.adoc[leveloffset=+1]
+include::modules/hosted-control-planes-support-matrix.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
 * xref:../scalability_and_performance/using-node-tuning-operator.adoc#node-tuning-hosted-cluster_node-tuning-operator[Configuring node tuning in a hosted cluster]
-* xref:../scalability_and_performance/using-node-tuning-operator.adoc#advanced-node-tuning-hosted-cluster_node-tuning-operator[Advanced node tuning for hosted clusters by setting kernel boot parameters]
+* xref:../scalability_and_performance/using-node-tuning-operator.adoc#advanced-node-tuning-hosted-cluster_node-tuning-operator[Advanced node tuning for hosted clusters by setting kernel boot parameters]

modules/hosted-control-planes-support-matrix.adoc

@@ -0,0 +1,29 @@
+// Module included in the following assemblies:
+//
+// * hosted-control-planes/index.adoc
+
+
+:_mod-docs-content-type: CONCEPT
+[id="hosted-control-planes-upgrading-scenarios_{context}"]
+= Upgrading scenarios for hosted control planes
+
+Consider the following information before you upgrade:
+
+* You use bare metal as a management cluster platform.
+
+* You use Agent or KubeVirt as a Hosted cluster platform.
+
+[NOTE]
+====
+The management cluster is based on the installer-provisioned infrastructure (IPI).
+====
+
+Review the following scenarios:
+
+* While running your management cluster on {product-title} 4.14, you can upgrade the multicluster engine (MCE) version from 2.4 to 2.5. Then, you can upgrade your hosted cluster and node pools from {product-title} 4.14 to {product-title} 4.15.
+
+* If you want to upgrade management cluster, MCE, hosted cluster, and node pools to their latest versions:
+
+** Upgrade your management cluster from {product-title} 4.14 to {product-title} 4.15
+** Upgrade the MCE version from 2.4 to 2.5
+** Upgrade your hosted cluster and node pools from {product-title} 4.14 to {product-title} 4.15