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
@@ -38,7 +38,7 @@ To enable LTR, you can define a policy using a combination of four parameters: w
38
38
Changes to the LTR policy apply only to future backups. For example, if you modify the weekly backup retention (W), monthly backup retention (M), or yearly backup retention (Y), the new retention setting only applies to new backups. The retention of existing backups isn't modified. The LTR policy can be configured for each database in Azure SQL Database and Azure SQL Managed Instance. If you intend to delete old LTR backups before their retention period expires, you can [manually delete the backups](./long-term-backup-retention-configure.md#delete-ltr-backups).
39
39
40
40
> [!NOTE]
41
-
> In both Azure SQL Database and Azure SQL Managed Instance, when you enable an LTR policy for the first time for a database, and the policy specifies a yearly retention, the most recent full backup from point-in-time-restore (PITR) is copied to long term storage.
41
+
> In both Azure SQL Database and Azure SQL Managed Instance, when you enable an LTR policy for the first time for a database, the most recent full backup from point-in-time-restore (PITR) is copied to long term storage.
title: Register with SQL IaaS Agent extension (Linux)
3
-
description: Learn how to register your SQL Server on Linux Azure VM with the SQL IaaS Agent extension to enable Azure features, as well as for compliance, and improved manageability.
2
+
title: Register with SQL Server IaaS Agent extension (Linux)
3
+
description: Learn how to register your SQL Server on Linux Azure Virtual Machines with the SQL Server IaaS Agent extension to enable Azure features, compliance, and improved manageability.
Register your SQL Server VM with the [SQL IaaS Agent extension](sql-server-iaas-agent-extension-linux.md) to unlock a wealth of feature benefits for your SQL Server on Linux Azure VM.
23
+
Register your SQL Server VM with the [SQL Server IaaS Agent extension](sql-server-iaas-agent-extension-linux.md) to enable additional management features for your SQL Server on Linux Azure VM.
23
24
24
25
## Overview
25
26
26
-
Registering with the [SQL Server IaaS Agent extension](sql-server-iaas-agent-extension-linux.md) creates the **SQL virtual machine**_resource_ within your subscription, which is a _separate_ resource from the virtual machine resource. Unregistering your SQL Server VM from the extension removes the **SQL virtual machine**_resource_ but will not drop the actual virtual machine.
27
+
When you register with the extension, you create the **SQL virtual machine**resource within your subscription. This resource is separate from the virtual machine resource. When you unregister your SQL Server VM from the extension, you remove the **SQL virtual machine**resource but keep the actual virtual machine.
27
28
28
-
To utilize the SQL IaaS Agent extension, you must first [register your subscription with the **Microsoft.SqlVirtualMachine** provider](#register-subscription-with-rp), which gives the SQL IaaS Agent extension the ability to create resources within that specific subscription.
29
+
To use the extension, you must first [register your subscription with the **Microsoft.SqlVirtualMachine** provider](#register-your-subscription-with-the-resource-provider). This registration grants the extension the ability to create resources within that subscription.
29
30
30
-
> [!IMPORTANT]
31
-
> The SQL IaaS Agent extension collects data for the express purpose of giving customers optional benefits when using SQL Server within Azure Virtual Machines. Microsoft will not use this data for licensing audits without the customer's advance consent. See the [SQL Server privacy supplement](/sql/sql-server/sql-server-privacy#non-personal-data) for more information.
31
+
> [!IMPORTANT]
32
+
> The SQL Server IaaS Agent extension collects data to provide customers with optional benefits when using SQL Server in Azure Virtual Machines. Microsoft doesn't use this data for licensing audits without your advance consent. To learn more, see the [SQL Server privacy supplement](/sql/sql-server/sql-server-privacy#non-personal-data).
32
33
33
34
## Prerequisites
34
35
35
-
To register your SQL Server VM with the extension, you'll need:
36
+
To register your SQL Server VM with the extension, you need:
36
37
37
38
- An [Azure subscription](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn).
38
-
-An Azure Resource Model [Ubuntu Linux virtual machine](/azure/virtual-machines/linux/quick-create-portal) with[SQL Server 2017 (or greater)](https://www.microsoft.com/sql-server/sql-server-downloads) deployed to the public or Azure Government cloud.
39
+
-A Linux virtual machine running[SQL Server 2017 or a later version](https://www.microsoft.com/sql-server/sql-server-downloads) deployed in the public or Azure Government cloud.
39
40
- The latest version of [Azure CLI](/cli/azure/install-azure-cli) or [Azure PowerShell (5.0 minimum)](/powershell/azure/install-az-ps).
40
41
41
-
## Register subscription with RP
42
+
## Register your subscription with the resource provider
42
43
43
-
To register your SQL Server VM with the SQL IaaS Agent extension, you must first register your subscription with the **Microsoft.SqlVirtualMachine** resource provider (RP). This gives the SQL IaaS Agent extension the ability to create resources within your subscription. You can do so by using the Azure portal, the Azure CLI, or Azure PowerShell.
44
+
To register your SQL Server VM with the extension, first register your subscription with the **Microsoft.SqlVirtualMachine** resource provider. This registration grants the extension the ability to create resources within your subscription. You can register using the Azure portal, Azure CLI, or Azure PowerShell.
44
45
45
46
### Azure portal
46
47
47
48
Register your subscription with the resource provider by using the Azure portal:
48
49
49
50
1. Open the Azure portal and go to **All Services**.
50
-
1. Go to **Subscriptions** and select the subscription of interest.
51
+
1. Go to **Subscriptions** and select the subscription you want to use.
51
52
1. On the **Subscriptions** page, select **Resource providers** under **Settings**.
52
53
1. Enter **sql** in the filter to bring up the SQL-related resource providers.
53
-
1. Select **Register**, **Re-register**, or **Unregister** for the **Microsoft.SqlVirtualMachine** provider, depending on your desired action.
54
-
54
+
1. Select **Register**, **Re-register**, or **Unregister** for the **Microsoft.SqlVirtualMachine** provider, depending on your desired action.
55
55
56
-
56
+
:::image type="content" source="../windows/media/sql-agent-extension-manually-register-single-vm/select-resource-provider-sql.png" alt-text="Screenshot of how to modify the provider." lightbox="../windows/media/sql-agent-extension-manually-register-single-vm/select-resource-provider-sql.png":::
57
57
58
58
### Command line
59
59
60
60
Register your Azure subscription with the **Microsoft.SqlVirtualMachine** provider using either Azure CLI or Azure PowerShell.
61
61
62
62
# [Azure CLI](#tab/bash)
63
63
64
-
Register your subscription with the resource provider by using the Azure CLI:
64
+
Register your subscription with the resource provider by using Azure CLI:
65
65
66
66
```azurecli-interactive
67
-
# Register the SQL IaaS Agent extension to your subscription
68
-
az provider register --namespace Microsoft.SqlVirtualMachine
67
+
az provider register --namespace Microsoft.SqlVirtualMachine
69
68
```
70
69
71
70
# [Azure PowerShell](#tab/powershell)
72
71
73
-
Register your subscription with the resource provider by using Azure PowerShell:
72
+
Register your subscription with the resource provider by using Azure PowerShell:
74
73
75
74
```powershell-interactive
76
-
# Register the SQL IaaS Agent extension to your subscription
The SQL IaaS Agent extension on Linux is only available in lightweight mode, which supports only changing the license type and edition of SQL Server. Use the Azure CLI or Azure PowerShell to register your SQL Server VM with the extension in lightweight mode for limited functionality.
82
+
The extension is only available in lightweight mode on Linux, which supports only changing the license type and edition of SQL Server. Use the Azure CLI or Azure PowerShell to register your SQL Server VM with the extension in lightweight mode for limited functionality.
85
83
86
84
Provide the SQL Server license type as either pay-as-you-go (`PAYG`) to pay per usage, Azure Hybrid Benefit (`AHUB`) to allocate your own license, or disaster recovery (`DR`) to activate the [free DR replica license](../windows/business-continuity-high-availability-disaster-recovery-hadr-overview.md#free-dr-replica-in-azure).
87
85
@@ -91,70 +89,71 @@ Register a SQL Server VM in lightweight mode with the Azure CLI:
91
89
92
90
```azurecli-interactive
93
91
# Register Enterprise or Standard self-installed VM in Lightweight mode
94
-
az sql vm create --name <vm_name> --resource-group <resource_group_name> --location <vm_location> --license-type <license_type>
92
+
az sql vm create --name <vm_name> --resource-group <resource_group_name> --location <vm_location> --license-type <license_type>
95
93
```
96
94
97
95
# [Azure PowerShell](#tab/powershell)
98
96
99
97
Register a SQL Server VM in lightweight mode with Azure PowerShell:
You can verify if your SQL Server VM has already been registered with the SQL IaaS Agent extension by using the Azure portal, the Azure CLI, or Azure PowerShell.
114
-
116
+
You can verify if your SQL Server VM is registered with the extension by using the Azure portal, the Azure CLI, or Azure PowerShell.
115
117
116
118
### Azure portal
117
119
118
-
Verify the registration status by using the Azure portal:
120
+
Verify the registration status by using the Azure portal:
119
121
120
122
1. Sign in to the [Azure portal](https://portal.azure.com).
121
123
1. Go to your SQL virtual machines resource.
122
-
1. Select your SQL Server VM from the list. If your SQL Server VM is not listed here, it likely hasn't been registered with the SQL IaaS Agent extension.
124
+
1. Select your SQL Server VM from the list. If your SQL Server VM isn't listed here, it likely isn't registered with the extension.
123
125
124
126
### Command line
125
127
126
128
Verify current SQL Server VM registration status using either Azure CLI or Azure PowerShell. `ProvisioningState` shows as `Succeeded` if registration was successful.
127
129
128
130
# [Azure CLI](#tab/bash)
129
131
130
-
Verify the registration status by using the Azure CLI:
132
+
Verify the registration status with Azure CLI:
131
133
132
134
```azurecli-interactive
133
135
az sql vm show -n <vm_name> -g <resource_group>
134
136
```
135
137
136
138
# [Azure PowerShell](#tab/powershell)
137
139
138
-
Verify the registration status by using the Azure PowerShell:
140
+
Verify the registration status with Azure PowerShell:
An error indicates that the SQL Server VM has not been registered with the extension.
148
+
An error indicates that the SQL Server VM isn't registered with the extension.
147
149
148
150
## Automatic registration
149
151
150
-
[Automatic registration](../windows/sql-agent-extension-automatic-registration-all-vms.md) is supported for Ubuntu Linux VMs.
151
-
152
-
153
-
## Next steps
152
+
[Automatic registration](../windows/sql-agent-extension-automatic-registration-all-vms.md) with the extension enables Azure to register all existing and future SQL Server VMs in a subscription with the extension, helping you maintain consistent management.
154
153
155
-
For more information, see the following articles:
154
+
## Related content
156
155
157
-
*[Overview of SQL Server on Windows VMs](sql-server-on-linux-vm-what-is-iaas-overview.md)
158
-
*[FAQ for SQL Server on Windows VMs](frequently-asked-questions-faq.yml)
159
-
*[Pricing guidance for SQL Server on Windows VMs](../windows/pricing-guidance.md)
160
-
*[Release notes for SQL Server on Windows VMs](../windows/doc-changes-updates-release-notes-whats-new.md)
156
+
-[Overview of SQL Server on Linux Azure Virtual Machines](sql-server-on-linux-vm-what-is-iaas-overview.md)
157
+
-[FAQ for SQL Server on Windows VMs](frequently-asked-questions-faq.yml)
158
+
-[Pricing guidance for SQL Server on Azure VMs](../windows/pricing-guidance.md)
159
+
-[What's new with SQL Server on Azure Virtual Machines?](../windows/doc-changes-updates-release-notes-whats-new.md)
![learn-build-service-prod[bot]](https://avatars.githubusercontent.com/in/237442?v=4&size=40){kind=avatar}
0 commit comments