Skip to content

Commit 437705c

Browse files
authored
Merge pull request #9845 from MashaMSFT/2025_sqlvmfl2
Adding info to ts article
2 parents 9607279 + 29e14d4 commit 437705c

File tree

2 files changed

+29
-14
lines changed

2 files changed

+29
-14
lines changed
131 KB
Loading

support/sql/azure-sql/sql-deployment-fails-drive-not-ready.md

Lines changed: 29 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,8 @@
11
---
22
title: SQL VM Fails to Deploy or SQL Server Instance Can't Come Online
33
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
5-
ms.author: mathoma
6-
author: MashaMSFT
7-
ms.reviewer: mathoma, v-sidong
4+
ms.date: 10/07/2025
5+
ms.reviewer: mathoma, pamela, v-sidong, v-shaywood
86
ms.custom: sap:SQL Licensing, Installation and Patching
97
---
108
# SQL Server on Azure VM fails to deploy or SQL Server instance fails to come online
@@ -21,7 +19,7 @@ _Applies to:_  SQL Server on Azure VMs
2119
2220
## Symptoms
2321

24-
If you encounter this issue, you're likely to see:
22+
If you encounter this issue, you likely see:
2523

2624
- SQL Server on Azure VM deployments failing when using an Azure Marketplace image.
2725
- SQL Server failing to come online after an Azure VM is restarted for manually installed instances of SQL Server.
@@ -36,6 +34,9 @@ For example, if you're deploying an image from the Azure portal, you might see t
3634

3735
:::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":::
3836

37+
> [!WARNING]
38+
> 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.
39+
3940
### SQL Server fails to come online after the VM is restarted
4041

4142
You might see this issue after following this sequence of events:
@@ -69,22 +70,36 @@ tempdb files could not be initialized.
6970

7071
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.
7172

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.
73+
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.
7374

7475
## Resolution
7576

7677
This issue occurs because of the selected Azure VM size. To solve the issue, use one of the following methods:
7778

78-
- 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-
- 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.*
79+
- If possible, use another VM SKU, such as the SKUs listed in the [VM size best practices](/azure/azure-sql/virtual-machines/windows/performance-guidelines-best-practices-vm-size#checklist).
80+
- 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 uses uninitialized ephemeral storage, as indicated by `d` in the name.
8181

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.
82+
## Workaround
83+
84+
If you can't use another VM SKU without a RAW local SSD, consider the following workarounds:
85+
86+
- 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.
87+
88+
- **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.**
89+
90+
- 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:` drive or remote storage drive.
91+
92+
1. You can configure this setting 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).
93+
94+
1. Under **Storage configuration**, select **Change configuration** to open the **Configure storage** pane.
95+
96+
1. Expand **tempdb storage** and choose _any option other than_ `Use local SSD drive`:
97+
98+
:::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":::
8499

85100
## Impacted VMs
86101

87-
This issue occurs with VMs that are deployed with an uninitialized temporary drive, such as the following VM sizes:
102+
This issue occurs with VMs that deploy an uninitialized temporary drive, such as the following VM sizes:
88103

89104
|Intel Gen 10.2|AMD Gen 9.1|
90105
|-|-|
@@ -94,5 +109,5 @@ This issue occurs with VMs that are deployed with an uninitialized temporary dri
94109
|[Lsv3](/azure/virtual-machines/sizes/storage-optimized/lsv3-series#sizes-in-series) - All Azure VMs||
95110
|[Fxmdsv2](/azure/virtual-machines/sizes/compute-optimized/fxmdsv2-series#sizes-in-series)||
96111

97-
98-
112+
> [!NOTE]
113+
> 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

Comments
 (0)