Skip to content

Commit 4a68c3e

Browse files
committed
Adding info to ts article
pams suggestion
1 parent 507f568 commit 4a68c3e

2 files changed

Lines changed: 17 additions & 9 deletions

File tree

131 KB
Loading

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

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
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
4+
ms.date: 10/07/2025
55
ms.author: mathoma
66
author: MashaMSFT
77
ms.reviewer: mathoma, v-sidong
@@ -21,7 +21,7 @@ _Applies to:_  SQL Server on Azure VMs
2121
2222
## Symptoms
2323

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

2626
- SQL Server on Azure VM deployments failing when using an Azure Marketplace image.
2727
- 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
3636

3737
:::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":::
3838

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+
3942
### SQL Server fails to come online after the VM is restarted
4043

4144
You might see this issue after following this sequence of events:
@@ -69,22 +72,27 @@ tempdb files could not be initialized.
6972

7073
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.
7174

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.
7376

7477
## Resolution
7578

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

7881
- 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).
7982
- 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.*
8183

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+
8492

8593
## Impacted VMs
8694

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:
8896

8997
|Intel Gen 10.2|AMD Gen 9.1|
9098
|-|-|
@@ -94,5 +102,5 @@ This issue occurs with VMs that are deployed with an uninitialized temporary dri
94102
|[Lsv3](/azure/virtual-machines/sizes/storage-optimized/lsv3-series#sizes-in-series) - All Azure VMs||
95103
|[Fxmdsv2](/azure/virtual-machines/sizes/compute-optimized/fxmdsv2-series#sizes-in-series)||
96104

97-
98-
105+
> [!NOTE]
106+
> 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)