1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/machineset-troubleshooting-azure-ultra-disk.adoc
2025-12-15 16:13:14 +00:00

94 lines
3.5 KiB
Plaintext

// Module included in the following assemblies:
//
// * machine_management/creating_machinesets/creating-machineset-azure.adoc
// * storage/persistent_storage/persistent-storage-azure.adoc
// * storage/persistent_storage/persistent-storage-csi-azure.adoc
// * machine_management/control_plane_machine_management/cpmso_provider_configurations/cpmso-config-options-azure.adoc
ifeval::["{context}" == "creating-machineset-azure"]
:mapi:
endif::[]
ifeval::["{context}" == "cpmso-supported-features-azure"]
:mapi:
endif::[]
ifeval::["{context}" == "persistent-storage-azure"]
:pvc:
endif::[]
ifeval::["{context}" == "persistent-storage-csi-azure"]
:pvc:
endif::[]
:_mod-docs-content-type: REFERENCE
[id="machineset-troubleshooting-azure-ultra-disk_{context}"]
= Troubleshooting resources for machine sets that enable ultra disks
Use the information in this section to understand and recover from issues you might encounter.
ifdef::pvc[]
[id="ts-pvc-mounting-ultra_{context}"]
== Unable to mount a persistent volume claim backed by an ultra disk
If there is an issue mounting a persistent volume claim backed by an ultra disk, the pod becomes stuck in the `ContainerCreating` state and an alert is triggered.
For example, if the `additionalCapabilities.ultraSSDEnabled` parameter is not set on the machine that backs the node that hosts the pod, the following error message appears:
[source,terminal]
----
StorageAccountType UltraSSD_LRS can be used only when additionalCapabilities.ultraSSDEnabled is set.
----
* To resolve this issue, describe the pod by running the following command:
+
[source,terminal]
----
$ oc -n <stuck_pod_namespace> describe pod <stuck_pod_name>
----
endif::pvc[]
ifdef::mapi[]
[id="ts-mapi-attach-misconfigure_{context}"]
== Incorrect ultra disk configuration
If an incorrect configuration of the `ultraSSDCapability` parameter is specified in the machine set, the machine provisioning fails.
For example, if the `ultraSSDCapability` parameter is set to `Disabled`, but an ultra disk is specified in the `dataDisks` parameter, the following error message appears:
[source,terminal]
----
StorageAccountType UltraSSD_LRS can be used only when additionalCapabilities.ultraSSDEnabled is set.
----
* To resolve this issue, verify that your machine set configuration is correct.
[id="ts-mapi-attach-unsupported_{context}"]
== Unsupported disk parameters
If a region, availability zone, or instance size that is not compatible with ultra disks is specified in the machine set, the machine provisioning fails. Check the logs for the following error message:
[source,terminal]
----
failed to create vm <machine_name>: failure sending request for machine <machine_name>: cannot create vm: compute.VirtualMachinesClient#CreateOrUpdate: Failure sending request: StatusCode=400 -- Original Error: Code="BadRequest" Message="Storage Account type 'UltraSSD_LRS' is not supported <more_information_about_why>."
----
* To resolve this issue, verify that you are using this feature in a supported environment and that your machine set configuration is correct.
[id="ts-mapi-delete_{context}"]
== Unable to delete disks
If the deletion of ultra disks as data disks is not working as expected, the machines are deleted and the data disks are orphaned. You must delete the orphaned disks manually if desired.
endif::mapi[]
ifeval::["{context}" == "creating-machineset-azure"]
:!mapi:
endif::[]
ifeval::["{context}" == "cpmso-supported-features-azure"]
:!mapi:
endif::[]
ifeval::["{context}" == "persistent-storage-azure"]
:!pvc:
endif::[]
ifeval::["{context}" == "persistent-storage-csi-azure"]
:!pvc:
endif::[]