Skip to content

Commit 65cbebd

Browse files
authored
Merge pull request #83431 from ShawnJackson/sql-virtual-machines
edit pass: sql-virtual-machines
2 parents 6a3b462 + ca4293b commit 65cbebd

16 files changed

+495
-481
lines changed

articles/virtual-machines/windows/sql/virtual-machines-windows-ps-sql-keyvault.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ For a detailed walkthrough of provisioning, see [Provision a SQL Server virtual
5050

5151
[!INCLUDE [windows-virtual-machines-sql-use-new-management-blade](../../../../includes/windows-virtual-machines-sql-new-resource.md)]
5252

53-
For existing SQL Server virtual machines, open your [SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-sql-virtual-machine-resource) and select **Security** under **Settings**. Select **Enable** to enable Azure Key Vault integration.
53+
For existing SQL Server virtual machines, open your [SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-the-sql-virtual-machines-resource) and select **Security** under **Settings**. Select **Enable** to enable Azure Key Vault integration.
5454

5555
![SQL AKV Integration for existing VMs](./media/virtual-machines-windows-ps-sql-keyvault/azure-sql-rm-akv-existing-vms.png)
5656

articles/virtual-machines/windows/sql/virtual-machines-windows-sql-ahb.md

Lines changed: 57 additions & 50 deletions
Large diffs are not rendered by default.

articles/virtual-machines/windows/sql/virtual-machines-windows-sql-automated-backup-v2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ In the **SQL Server settings** tab, select **Enable** under **Automated backup**
133133

134134
[!INCLUDE [windows-virtual-machines-sql-use-new-management-blade](../../../../includes/windows-virtual-machines-sql-new-resource.md)]
135135

136-
For existing SQL Server virtual machines, navigate to the [SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-sql-virtual-machine-resource) and then select **Backups** to configure your automated backups.
136+
For existing SQL Server virtual machines, navigate to the [SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-the-sql-virtual-machines-resource) and then select **Backups** to configure your automated backups.
137137

138138
![SQL Automated Backup for existing VMs](./media/virtual-machines-windows-sql-automated-backup-v2/sql-server-configuration.png)
139139

articles/virtual-machines/windows/sql/virtual-machines-windows-sql-automated-backup.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ In the **SQL Server settings** tab, scroll down to **Automated backup** and sele
8181
[!INCLUDE [windows-virtual-machines-sql-use-new-management-blade](../../../../includes/windows-virtual-machines-sql-new-resource.md)]
8282

8383
For existing SQL Server virtual machines, navigate to the
84-
[SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-sql-virtual-machine-resource) and then select **Backups**.
84+
[SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-the-sql-virtual-machines-resource) and then select **Backups**.
8585

8686
![SQL Automated Backup for existing VMs](./media/virtual-machines-windows-sql-automated-backup/azure-sql-rm-autobackup-existing-vms.png)
8787

articles/virtual-machines/windows/sql/virtual-machines-windows-sql-automated-patching.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ For context, see the complete topic on [provisioning a SQL Server virtual machin
8585

8686
[!INCLUDE [windows-virtual-machines-sql-use-new-management-blade](../../../../includes/windows-virtual-machines-sql-new-resource.md)]
8787

88-
For existing SQL Server virtual machines, open your [SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-sql-virtual-machine-resource) and select **Patching** under **Settings**.
88+
For existing SQL Server virtual machines, open your [SQL virtual machines resource](virtual-machines-windows-sql-manage-portal.md#access-the-sql-virtual-machines-resource) and select **Patching** under **Settings**.
8989

9090
![SQL Automatic Patching for existing VMs](./media/virtual-machines-windows-sql-automated-patching/azure-sql-rm-patching-existing-vms.png)
9191

articles/virtual-machines/windows/sql/virtual-machines-windows-sql-availability-group-cli.md

Lines changed: 67 additions & 65 deletions
Large diffs are not rendered by default.

articles/virtual-machines/windows/sql/virtual-machines-windows-sql-availability-group-quickstart-template.md

Lines changed: 93 additions & 86 deletions
Large diffs are not rendered by default.
Lines changed: 35 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: How to perform an in-place upgrade of SQL Server edition on Azure VM| Microsoft Docs
2+
title: Perform an in-place upgrade of a SQL Server edition on an Azure VM| Microsoft Docs
33
description: Learn how to change the edition of your SQL Server VM in Azure.
44
services: virtual-machines-windows
55
documentationcenter: na
@@ -16,83 +16,82 @@ ms.author: mathoma
1616
ms.reviewer: jroth
1717

1818
---
19-
# How to perform an in-place upgrade of SQL Server edition on Azure VM
19+
# Perform an in-place upgrade of a SQL Server edition on an Azure VM
2020

21-
This article describes how to change the edition of SQL Server for an existing SQL Server on a Windows virtual machine in Azure.
21+
This article describes how to change the edition of SQL Server on a Windows virtual machine in Azure.
2222

23-
The edition of SQL Server is determined by the product key, and is specified with the installation process. The edition dictates what [features](/sql/sql-server/editions-and-components-of-sql-server-2017) are available within the SQL Server product. You can change the SQL Server edition with the installation media and either downgrade to reduce cost or upgrade to enable more features.
23+
The edition of SQL Server is determined by the product key, and is specified with the installation process. The edition dictates what [features](/sql/sql-server/editions-and-components-of-sql-server-2017) are available in the SQL Server product. You can change the SQL Server edition with the installation media and either downgrade to reduce cost or upgrade to enable more features.
2424

25-
If you updated the edition of SQL Server using the installation media after registering with the SQL VM resource provider, then to update the Azure billing accordingly you should set the SQL Server Edition Property of the SQL VM resource as follows:
25+
If you updated the edition of SQL Server by using the installation media after registering with the SQL VM resource provider, then to update the Azure billing accordingly, you should set the SQL Server edition property of the SQL VM resource as follows:
2626

27-
1. Sign into the [Azure portal](https://portal.azure.com).
28-
1. Navigate to your SQL Server virtual machine resource.
29-
1. Under **Settings**, select **Configure** and then select your desired edition of SQL Server from the drop-down under **Edition**.
27+
1. Sign in to the [Azure portal](https://portal.azure.com).
28+
1. Go to your SQL Server virtual machine resource.
29+
1. Under **Settings**, select **Configure**. Then select your desired edition of SQL Server from the drop-down list under **Edition**.
3030

3131
![Change edition metadata](media/virtual-machines-windows-sql-change-edition/edition-change-in-portal.png)
3232

33-
1. Review the warning notifying you that you must change SQL Server edition first, and that edition property must match SQL Server edition.
33+
1. Review the warning that says you must change the SQL Server edition first, and that the edition property must match the SQL Server edition.
3434
1. Select **Apply** to apply your edition metadata changes.
3535

3636

3737
## Prerequisites
3838

39-
To do an in-place change of the edition of SQL Server, you will need the following:
39+
To do an in-place change of the edition of SQL Server, you need the following:
4040

4141
- An [Azure subscription](https://azure.microsoft.com/free/).
42-
- A Windows [SQL Server VM](https://docs.microsoft.com/azure/virtual-machines/windows/sql/virtual-machines-windows-portal-sql-server-provision) registered with the [SQL VM resource provider](virtual-machines-windows-sql-register-with-resource-provider.md).
43-
- Setup media with the desired edition of SQL Server. Customers who have [software assurance](https://www.microsoft.com/licensing/licensing-programs/software-assurance-default) can obtain their installation media from the [Volume Licensing Center](https://www.microsoft.com/Licensing/servicecenter/default.aspx). Customers do not have software assurance can use the setup media from a marketplace SQL Server VM image that has their desired edition.
42+
- A [SQL Server VM on Windows](https://docs.microsoft.com/azure/virtual-machines/windows/sql/virtual-machines-windows-portal-sql-server-provision) registered with the [SQL VM resource provider](virtual-machines-windows-sql-register-with-resource-provider.md).
43+
- Setup media with the desired edition of SQL Server. Customers who have [Software Assurance](https://www.microsoft.com/licensing/licensing-programs/software-assurance-default) can obtain their installation media from the [Volume Licensing Center](https://www.microsoft.com/Licensing/servicecenter/default.aspx). Customers who don't have Software Assurance can use the setup media from an Azure Marketplace SQL Server VM image that has their desired edition.
4444

4545

46-
## Upgrade edition
46+
## Upgrade an edition
4747

48-
> [!WARNING]
49-
> - **Upgrading the edition of SQL Server will restart the service for SQL Server, as well as any associated services, such as Analysis Services and R Services.**
48+
> [!WARNING]
49+
> Upgrading the edition of SQL Server will restart the service for SQL Server, along with any associated services, such as Analysis Services and R Services.
5050
51-
To upgrade the edition of SQL Server, obtain the SQL Server setup media for the desired edition of SQL Server, and then do the following:
51+
To upgrade SQL Server, obtain the SQL Server setup media for the desired edition of SQL Server, and then do the following:
5252

53-
1. Launch Setup.exe from the SQL Server installation media.
54-
1. Navigate to **Maintenance** and choose the **Edition Upgrade** option.
53+
1. Open Setup.exe from the SQL Server installation media.
54+
1. Go to **Maintenance** and choose the **Edition Upgrade** option.
5555

56-
![Upgrade edition of SQL Server](media/virtual-machines-windows-sql-change-edition/edition-upgrade.png)
56+
![Selection for upgrading the edition of SQL Server](media/virtual-machines-windows-sql-change-edition/edition-upgrade.png)
5757

58-
1. Select **Next** until you reach the **Ready to upgrade edition** page, and then select **Upgrade**. The setup window may hang for a few minutes while the change is taking effect, and then you will see a **Complete** page confirming that your edition upgrade is complete.
58+
1. Select **Next** until you reach the **Ready to upgrade edition** page, and then select **Upgrade**. The setup window might stop responding for a few minutes while the change is taking effect. A **Complete** page will confirm that your edition upgrade is finished.
5959

60-
After SQL Server edition is upgraded, you should modify the "Edition" property of the Sql Virtual Machine on Azure portal as shown above; this will update the metadata and billing associated with this VM.
60+
After the SQL Server edition is upgraded, modify the edition property of the SQL Server virtual machine in the Azure portal as shown earlier. This will update the metadata and billing associated with this VM.
6161

62-
## Downgrade edition
62+
## Downgrade an edition
6363

64-
> [!WARNING]
65-
> - **Downgrading the edition of SQL Server requires completely uninstalling SQL Server, which may incur additional downtime**.
64+
To downgrade the edition of SQL Server, you need to completely uninstall SQL Server, and reinstall it again with the desired edition setup media.
6665

67-
68-
To downgrade the edition of SQL Server, you will need to completely uninstall SQL Server, and reinstall it again with the desired edition setup media.
66+
> [!WARNING]
67+
> Uninstalling SQL Server might incur additional downtime.
6968
7069
You can downgrade the edition of SQL Server by following these steps:
7170

7271
1. Back up all databases, including the system databases.
7372
1. Move system databases (master, model, and msdb) to a new location.
7473
1. Completely uninstall SQL Server and all associated services.
7574
1. Restart the virtual machine.
76-
1. Install SQL Server using the media with the desired edition of SQL Server.
75+
1. Install SQL Server by using the media with the desired edition of SQL Server.
7776
1. Install the latest service packs and cumulative updates.
78-
1. Replace the new system databases that were created during installation with the system databases you previously moved to a different location.
77+
1. Replace the new system databases that were created during installation with the system databases that you previously moved to a different location.
7978

80-
Once the SQL Server edition is downgraded, you should modify the 'Edition' property of the SQL virtual machine within the Azure portal as shown above; this will update the metadata and billing associated with this VM.
79+
After the SQL Server edition is downgraded, modify the edition property of the SQL Server virtual machine in the Azure portal as shown earlier. This will update the metadata and billing associated with this VM.
8180

8281
## Remarks
8382

84-
- The edition property for the SQL Server VM must match the edition of the SQL Server installed to the virtual machine for all SQL Virtual Machines including both PAYG and BYOL license types.
85-
- If you drop your SQL Server VM resource, you will go back to the hard-coded edition setting of the image.
86-
- The ability to change the edition is a feature of the SQL VM resource provider. Deploying a marketplace image through the Azure portal automatically registers a SQL Server VM with the resource provider. However, customers who are self-installing SQL Server will need to manually [register their SQL Server VM](virtual-machines-windows-sql-register-with-resource-provider.md).
87-
- Adding a SQL Server VM to an availability set requires recreating the VM. As such, any VMs added to an availability set will go back to the default edition and the edition will need to be modified again.
83+
- The edition property for the SQL Server VM must match the edition of the SQL Server instance installed for all SQL Server virtual machines, including both pay-as-you-go and bring-your-own-license types of licenses.
84+
- If you drop your SQL Server VM resource, you will go back to the hard-coded edition setting of the image.
85+
- The ability to change the edition is a feature of the SQL VM resource provider. Deploying an Azure Marketplace image through the Azure portal automatically registers a SQL Server VM with the resource provider. However, customers who are self-installing SQL Server will need to manually [register their SQL Server VM](virtual-machines-windows-sql-register-with-resource-provider.md).
86+
- Adding a SQL Server VM to an availability set requires re-creating the VM. Any VMs added to an availability set will go back to the default edition, and the edition will need to be modified again.
8887

8988
## Next steps
9089

9190
For more information, see the following articles:
9291

9392
* [Overview of SQL Server on a Windows VM](virtual-machines-windows-sql-server-iaas-overview.md)
94-
* [SQL Server on a Windows VM FAQ](virtual-machines-windows-sql-server-iaas-faq.md)
95-
* [SQL Server on a Windows VM pricing guidance](virtual-machines-windows-sql-server-pricing-guidance.md)
96-
* [SQL Server on a Windows VM release notes](virtual-machines-windows-sql-server-iaas-release-notes.md)
93+
* [FAQ for SQL Server on a Windows VM](virtual-machines-windows-sql-server-iaas-faq.md)
94+
* [Pricing guidance for SQL Server on a Windows VM](virtual-machines-windows-sql-server-pricing-guidance.md)
95+
* [Release notes for SQL Server on a Windows VM](virtual-machines-windows-sql-server-iaas-release-notes.md)
9796

9897

0 commit comments

Comments
 (0)