Merge pull request #60760 from sabrinajess/CNV19775

CNV-19775: configuring the default CPU model

Author: apinnick

_topic_maps/_topic_map.yml

@@ -3680,6 +3680,8 @@ Topics:
       File: virt-specifying-nodes-for-vms
     - Name: Configuring certificate rotation
       File: virt-configuring-certificate-rotation
+    - Name: Configuring the default CPU model
+      File: virt-configuring-default-cpu-model
     - Name: UEFI mode for virtual machines
       File: virt-uefi-mode-for-vms
     - Name: Configuring PXE booting for virtual machines

modules/virt-configuring-default-cpu-model.adoc

@@ -0,0 +1,43 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/vm_networking/virt-configuring-default-cpu-model.adoc
+
+:_content-type: PROCEDURE
+[id="virt-configuring-default-cpu-model_{context}"]
+= Configuring the default CPU model
+
+Configure the `defaultCPUModel` by updating the `HyperConverged` custom resource (CR). You can change the `defaultCPUModel` while {VirtProductName} is running.
+
+[NOTE]
+====
+The `defaultCPUModel` is case sensitive.
+====
+
+.Prerequisites
+
+* Install the OpenShift CLI (oc).
+
+.Procedure
+
+. Open the `HyperConverged` CR by running the following command:
++
+[source,terminal]
+----
+$ oc edit hco -n openshift-cnv kubevirt-hyperconverged
+----
+
+. Add the `defaultCPUModel` field to the CR and set the value to the name of a CPU model that exists in the cluster:
+
++
+[source,yaml]
+----
+apiVersion: hco.kubevirt.io/v1beta1
+kind: HyperConverged
+metadata:
+ name: kubevirt-hyperconverged
+ namespace: openshift-cnv
+spec:
+  defaultCPUModel: "EPYC"
+----
+
+. Apply the YAML file to your cluster.

virt/virtual_machines/advanced_vm_management/virt-configuring-default-cpu-model.adoc

@@ -0,0 +1,20 @@
+:_content-type: ASSEMBLY
+[id="virt-configuring-default-cpu-model"]
+= Configuring the default CPU model
+include::_attributes/common-attributes.adoc[]
+:context: virt-configuring-default-cpu-model
+
+Use the `defaultCPUModel` setting in the `HyperConverged` custom resource (CR) to define a cluster-wide default CPU model.
+
+The virtual machine (VM) CPU model depends on the availability of CPU models within the VM and the cluster.
+
+* If the VM does not have a defined CPU model:
+** The `defaultCPUModel` is automatically set using the CPU model defined at the cluster-wide level.
+* If both the VM and the cluster have a defined CPU model:
+** The VM’s CPU model takes precedence.
+* If neither the VM nor the cluster have a defined CPU model:
+** The host-model is automatically set using the CPU model defined at the host level.
+
+toc::[]
+
+include::modules/virt-configuring-default-cpu-model.adoc[leveloffset=+1]