Merge pull request #60965 from apinnick/CNV-28046-update-runbooks

CNV- 28046: Update runbooks

Author: apinnick

modules/virt-runbook-kubevirtdeprecatedapisrequested.adoc

@@ -12,7 +12,7 @@
 [id="meaning-kubevirtdeprecatedapisrequested"]
 == Meaning
 
-This alert fires when a deprecated  {VirtProductName} API is used.
+This alert fires when a deprecated `KubeVirt` API is used.
 
 [discrete]
 [id="impact-kubevirtdeprecatedapisrequested"]

modules/virt-runbook-kubevirtnoavailablenodestorunvms.adoc

@@ -0,0 +1,81 @@
+// Do not edit this module. It is generated with a script.
+// Do not reuse this module. The anchor IDs do not contain a context statement.
+// Module included in the following assemblies:
+//
+// * virt/support/virt-runbooks.adoc
+
+:_content-type: REFERENCE
+[id="virt-runbook-KubeVirtNoAvailableNodesToRunVMs"]
+= KubeVirtNoAvailableNodesToRunVMs
+
+[discrete]
+[id="meaning-kubevirtnoavailablenodestorunvms"]
+== Meaning
+
+This alert fires when the node CPUs in the cluster do not support virtualization
+or the virtualization extensions are not enabled.
+
+[discrete]
+[id="impact-kubevirtnoavailablenodestorunvms"]
+== Impact
+
+The nodes must support virtualization and the virtualization features must be
+enabled in the BIOS to run virtual machines (VMs).
+
+[discrete]
+[id="diagnosis-kubevirtnoavailablenodestorunvms"]
+== Diagnosis
+
+* Check the nodes for hardware virtualization support:
++
+[source,terminal]
+----
+$ oc get nodes -o json|jq '.items[]|{"name": .metadata.name, "kvm": .status.allocatable["devices.kubevirt.io/kvm"]}'
+----
++
+.Example output
++
+[source,text]
+----
+{
+  "name": "shift-vwpsz-master-0",
+  "kvm": null
+}
+{
+  "name": "shift-vwpsz-master-1",
+  "kvm": null
+}
+{
+  "name": "shift-vwpsz-master-2",
+  "kvm": null
+}
+{
+  "name": "shift-vwpsz-worker-8bxkp",
+  "kvm": "1k"
+}
+{
+  "name": "shift-vwpsz-worker-ctgmc",
+  "kvm": "1k"
+}
+{
+  "name": "shift-vwpsz-worker-gl5zl",
+  "kvm": "1k"
+}
+----
++
+Nodes with `"kvm": null` or `"kvm": 0` do not support virtualization extensions.
++
+Nodes with `"kvm": "1k"` do support virtualization extensions.
+
+[discrete]
+[id="mitigation-kubevirtnoavailablenodestorunvms"]
+== Mitigation
+
+Ensure that hardware and CPU virtualization extensions are enabled on all nodes
+and that the nodes are correctly labeled.
+
+See link:https://access.redhat.com/solutions/5106121[{VirtProductName} reports no nodes are available, cannot start VMs]
+for details.
+
+If you cannot resolve the issue, log in to the
+link:https://access.redhat.com[Customer Portal] and open a support case.

virt/support/virt-runbooks.adoc

@@ -45,6 +45,8 @@ include::modules/virt-runbook-kubevirthyperconvergedclusteroperatorinstallationn
 
 include::modules/virt-runbook-kubevirthyperconvergedclusteroperatorusmodification.adoc[leveloffset=+1]
 
+include::modules/virt-runbook-kubevirtnoavailablenodestorunvms.adoc[leveloffset=+1]
+
 include::modules/virt-runbook-kubevirtvmhighmemoryusage.adoc[leveloffset=+1]
 
 include::modules/virt-runbook-kubevirtvmiexcessivemigrations.adoc[leveloffset=+1]