Skip to content

Commit a4b5158

Browse files
Merge pull request #323 from machadovilaca/update-DeprecatedMachineType
Update docs/runbooks/DeprecatedMachineType.md
2 parents af07962 + c5b001c commit a4b5158

File tree

1 file changed

+19
-20
lines changed

1 file changed

+19
-20
lines changed

docs/runbooks/DeprecatedMachineType.md

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,50 @@
11
# DeprecatedMachineType
22

33
## Meaning
4-
This alert fires when one or more Virtual Machines (VMs)
5-
are using machine types that have been marked as deprecated (no
6-
longer supported).
4+
This alert triggers when one or more Virtual Machines (VMs) are using machine
5+
types that have been marked as no longer supported.
76

87
## Impact
98

109
**Running VMs**
11-
- Continue running but are using a deprecated machine type.
12-
- Newer nodes may not support this type, so the next live migration may
13-
fail or get stuck.
10+
- Continue running but are using an unsupported machine type.
11+
- Newer nodes might not support the machine type, so the next live migration may
12+
fail or become unresponsive.
1413
- This can block node maintenance and disrupt high availability.
1514

1615
**Stopped VMs**
1716
- No immediate issue while stopped.
18-
- When restarted, they may fail to schedule or get stuck if newer nodes
19-
no longer support the deprecated machine type.
20-
- This can prevent workloads from coming back online after maintenance
17+
- When restarted, they might fail to schedule or become unresponsive if newer
18+
nodes no longer support the machine type.
19+
- This might prevent workloads from coming back online after maintenance
2120
or cluster upgrades.
2221

2322

2423
## Diagnosis
25-
The alert detects VMs using deprecated machine types.
24+
The alert detects VMs using unsupported machine types.
2625

27-
**Identify affected VMs**
28-
Use the alert description to locate VM names, namespaces, and nodes (if running).
26+
**Identify affected VMs**
27+
Use the alert description to locate VM names, namespaces, and nodes (if running).
2928

30-
**Root Cause:**
29+
**Root Cause:**
3130
The VM's `spec.template.spec.domain.machine.type` field is set to a type
32-
that has been marked as deprecated. This can happen due to:
31+
that has been marked as unsupported. This can happen due to:
3332

34-
- VMs created before a machine type deprecation.
33+
- VMs created before the removal of support for a machine type.
3534
- VM templates not updated after cluster upgrades.
3635
- Manual VM creation using old machine type references.
3736

3837
## Mitigation
39-
Update affected VMs to use a supported machine type. You can:
38+
Update affected VMs to use a supported machine type. You can do one of the
39+
following:
4040

4141
- Edit VM definitions individually by modifying the
4242
`spec.template.spec.domain.machine.type` field.
43-
- Or, for a smoother and cleaner update of multiple VMs, use the
43+
- For a smoother and cleaner update of multiple VMs, use the
4444
`kubevirt-api-lifecycle-automation` tool to transition all deprecated VMs
4545
in one operation. This ensures consistent, automated migration and reduces
46-
manual errors or downtime during cluster upgrades. See the documentation
47-
for details: [Updating multiple VMs](https://docs.redhat.com/en/documentation/openshift_container_platform/4.18/html/virtualization/managing-vms#virt-updating-multiple-vms_virt-edit-vms)
48-
46+
manual errors or downtime during cluster upgrades. For details, see [Updating multiple
47+
VMs](https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/virtualization/managing-vms#virt-updating-multiple-vms_virt-edit-vms).
4948

5049
**Important:** Plan and apply these updates before performing cluster
5150
upgrades to avoid VM restart failures or compatibility issues.

0 commit comments

Comments
 (0)