You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/sql/azure-sql/sql-deployment-fails-drive-not-ready.md
+17-9Lines changed: 17 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: SQL VM Fails to Deploy or SQL Server Instance Can't Come Online
3
3
description: Addresses a failure when you deploy a SQL Server on Azure VM image in Azure Marketplace or when a manually installed SQL Server instance fails to come online after an Azure VM is restarted or deallocated.
4
-
ms.date: 04/16/2025
4
+
ms.date: 10/07/2025
5
5
ms.author: mathoma
6
6
author: MashaMSFT
7
7
ms.reviewer: mathoma, v-sidong
@@ -21,7 +21,7 @@ _Applies to:_ SQL Server on Azure VMs
21
21
22
22
## Symptoms
23
23
24
-
If you encounter this issue, you're likely to see:
24
+
If you encounter this issue, you likely see:
25
25
26
26
- SQL Server on Azure VM deployments failing when using an Azure Marketplace image.
27
27
- SQL Server failing to come online after an Azure VM is restarted for manually installed instances of SQL Server.
@@ -36,6 +36,9 @@ For example, if you're deploying an image from the Azure portal, you might see t
36
36
37
37
:::image type="content" source="media/sql-deployment-fails-drive-not-ready/sql-deployment-error.png" alt-text="Screenshot of the deployment error in the Azure portal." lightbox="media/sql-deployment-fails-drive-not-ready/sql-deployment-error.png":::
38
38
39
+
> [!WARNING]
40
+
> When this failure happens, the Azure VM deployment succeeds, but the SQL Server installation fails. You must delete the VM to avoid incurring charges. Redeploy the VM using one of the methods described in the [Resolution](#resolution) or [Workarounds](#workaround) sections.
41
+
39
42
### SQL Server fails to come online after the VM is restarted
40
43
41
44
You might see this issue after following this sequence of events:
@@ -69,22 +72,27 @@ tempdb files could not be initialized.
69
72
70
73
Some of the newest Azure VM sizes present a RAW local SSD volume for ephemeral storage configured with the Non-Volatile Memory Express (NVMe) interface. This configuration results in failures because SQL Server attempts to place the `tempdb` database on the ephemeral storage and fails as the local SSD volume isn't available. Additionally, the ephemeral storage shows as RAW after the machine is deallocated.
71
74
72
-
The RAW local SSD volume causes the SQL VM deployment to fail, and prevents manually installed SQL Server instances from coming online after the VM is restarted. In both cases, SQL Server is trying to initialize the `tempdb` database on the ephemeral storage, which isn't available. The deployment fails because SQL Server is installed during the deployment of the Azure VM, and the ephemeral storage isn't available. Likewise, manually installed instances of SQL Server fail to come online after the VM is restarted because the ephemeral storage isn't available when SQL Server tries to create the `tempdb` database.
75
+
The RAW local SSD volume causes the SQL VM deployment to fail, and prevents manually installed SQL Server instances from coming online after the VM is restarted. In both cases, SQL Server tries to initialize the `tempdb` database on the ephemeral storage, which isn't available. The deployment fails because SQL Server is installed during the deployment of the Azure VM, and the ephemeral storage isn't available. Likewise, manually installed instances of SQL Server fail to come online after the VM is restarted because the ephemeral storage isn't available when SQL Server tries to create the `tempdb` database.
73
76
74
77
## Resolution
75
78
76
79
This issue occurs because of the selected Azure VM size. To solve the issue, use one of the following methods:
77
80
78
81
- If possible, use another VM SKU, such as those listed in the [VM size best practices](/azure/azure-sql/virtual-machines/windows/performance-guidelines-best-practices-vm-size#checklist).
79
82
- If you want to use a particular VM that is on the [impacted VMs](#impacted-vms) list, use a machine without the lowercase `d` in the name, which places `tempdb` on the same storage as the SQL Server data files. For example, use the `FXmsv2` VM size instead of `FXmdsv2`. The latter has uninitialized ephemeral storage, as indicated by `d` in the name.
80
-
- If you can't use another VM SKU without a RAW local SSD, deploy the VM using a Windows Server-only image, [format and initialize the temporary NVMe drive](/azure/virtual-machines/enable-nvme-temp-faqs#how-can-i-format-and-initialize-temp-nvme-disks-in-windows-when-i-create-a-vm-), and then manually install SQL Server. *You must reinitialize the disk before starting SQL Server every time the VM is restarted or deallocated.*
81
83
82
-
> [!NOTE]
83
-
> Make sure the VM isn't configured using a [sector size greater than 4 KB](sql-installation-fails-sector-size-error-azure-vm.md#resolution) before installing SQL Server.
84
+
## Workaround
85
+
86
+
If you can't use another VM SKU without a RAW local SSD, consider the following workarounds:
87
+
- Deploy the VM using a Windows Server-only image, [format and initialize the temporary NVMe drive](/azure/virtual-machines/enable-nvme-temp-faqs#how-can-i-format-and-initialize-temp-nvme-disks-in-windows-when-i-create-a-vm-), and then manually install SQL Server. **_If you choose to put `tempdb` on the local SSD, you must reinitialize the disk before starting SQL Server every time the VM is restarted or deallocated._**
88
+
- Deploy the SQL Server VM image, but configure `tempdb` to use a different drive than the ephemeral storage during the deployment. For example, you can configure `tempdb` to use the `C:`, or remote storage drive. You can do this on the **SQL Server settings** page in the Azure portal when [deploying the SQL Server VM image](https://portal.azure.com/#view/HubsExtension/ServiceMenuBlade/~/SqlVirtualMachine/extension/SqlAzureExtension/menuId/AzureSqlHub/itemId/SqlVirtualMachine). Under **Storage configuration**, select **Change configuration** to open the **Configure storage** pane. Expand **tempdb storage** and *any option other than `Use local SSD drive`*:
89
+
90
+
:::image type="content" source="media/sql-deployment-fails-drive-not-ready/change-tempdb-location.png" alt-text="Screenshot of the tempdb storage configuration in the Azure portal when deploying a SQL VM image." lightbox="media/sql-deployment-fails-drive-not-ready/change-tempdb-location.png":::
91
+
84
92
85
93
## Impacted VMs
86
94
87
-
This issue occurs with VMs that are deployed with an uninitialized temporary drive, such as the following VM sizes:
95
+
This issue occurs with VMs that deploy an uninitialized temporary drive, such as the following VM sizes:
88
96
89
97
|Intel Gen 10.2|AMD Gen 9.1|
90
98
|-|-|
@@ -94,5 +102,5 @@ This issue occurs with VMs that are deployed with an uninitialized temporary dri
94
102
|[Lsv3](/azure/virtual-machines/sizes/storage-optimized/lsv3-series#sizes-in-series) - All Azure VMs||
> Make sure the VM isn't configured using a [sector size greater than 4 KB](sql-installation-fails-sector-size-error-azure-vm.md#resolution) before installing SQL Server.
0 commit comments