Skip to content

Commit 817c278

Browse files
committed
Update support policy information
1 parent f4bfdcb commit 817c278

8 files changed

+103
-40
lines changed

articles/azure-arc/data/includes/upgrade-supported-path.md

Lines changed: 0 additions & 21 deletions
This file was deleted.

articles/azure-arc/data/support-policy.md

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,33 +12,31 @@ ms.author: "dinethi"
1212
---
1313
# Azure Arc-enabled data services support policy.
1414

15-
This article explains the support policy for Azure Arc-enabled data services.
15+
This article describes the support policies and troubleshooting boundaries for Azure Arc-enabled data services. This article specifically explains support for Azure Arc data controller and Azure Arc-enabled SQL Managed Instance.
1616

1717
## Support policy
1818
- Azur Arc-enabled data services follows [Microsoft Modern Lifecycle Policy](https://support.microsoft.com/help/30881/modern-lifecycle-policy).
1919
- Read the original [Modern Lifecycle Policy announcement](https://support.microsoft.com/help/447912/announcing-microsoft-modern-lifecycle-policy).
2020
- For additional information, see [Modern Policy FAQs](https://support.microsoft.com/help/30882/modern-lifecycle-policy-faq).
2121

22-
## Supported updates
22+
## Support versions
2323

24-
Microsoft supports Azure Arc-enabled data services for one year from the date of the release. This support applies to the data controller, and any supported data services. For example, this support also applies to Azure Arc-enabled SQL Managed Instance.
24+
Microsoft supports Azure Arc-enabled data services for one year from the date of the release. This support applies to the data controller, and any supported data services. For example, this support also applies to Azure Arc-enabled SQL Managed Instance.
25+
26+
For descriptions, and instructions on how to identify a version release date, see [Supported versions](upgrade-overview.md#supported-versions).
2527

2628
Microsoft releases new versions periodically. [Version log](version-log.md) shows the history of releases.
2729

28-
Each release contains an image tag. Use the image tag to identify when Microsoft released the component. Microsoft supports the component for 1 full year after the release.
30+
To plan updates, see [Upgrade Azure Arc-enabled data services](upgrade-overview.md).
2931

30-
### Example
32+
## Support by components
3133

32-
For example, a complete image tag for the release in June, 2022 is: `v1.8.0_2022-06-1`.
34+
Microsoft supports Azure Arc-enabled data services, including the data controller, and the data services (like Azure Arc-enabled SQL Managed Instance) that we provide. Data services requires a Kubernetes distribution deployed in a customer operated environment. Microsoft does not provide support for the Kubernetes distribution. Support for the environment and hardware that hosts Kubernetes is provided by the operator of the environment and hardware.
3335

34-
The image tag follows this pattern, *\<version\>_\<date\>-#*.
35-
- \<version\> identifies the data services major and minor version numbers. The pattern is: **v**#.#.#
36-
- \<date\> identifies the year, month, and day of the release. The pattern is: YYYY-MM-DD-#.
37-
- -# identifies an internal build number.
36+
Microsoft has worked with industry partners to validate specific distributions for Azure Arc-enabled data services. You can see a list of partners and validated solutions in [Azure Arc-enabled data services Kubernetes validation](validation-program.md).
3837

39-
The example image released on June 6th, 2022.
38+
Microsoft recommends that you run Azure Arc-enabled data services on a validated solution.
4039

41-
Microsoft supports this release through June 5th, 2023.
40+
## See also
4241

43-
> [!NOTE]
44-
> The latest current branch version is always in the **Full Support** servicing phase. This support statement means that if you encounter a code defect that warrants a critical update, you must have the latest current branch version installed in order to receive a fix.
42+
[SQL Server running in Linux containers](/troubleshoot/sql/general/support-policy-sql-server)

articles/azure-arc/data/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,8 @@ items:
9898
href: update-service-principal-credentials.md
9999
- name: Upgrade
100100
items:
101+
- name: Overview
102+
href: upgrade-overview.md
101103
- name: Indirect connectivity mode
102104
items:
103105
- name: Data controller indirect - CLI

articles/azure-arc/data/upgrade-data-controller-direct-cli.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,8 +64,7 @@ This section shows how to upgrade a directly connected data controller.
6464
> To upgrade, delete all non-GA database instances. You can find the list of generally available
6565
> and preview services in the [Release Notes](./release-notes.md).
6666
67-
[!INCLUDE [upgrade-supported-path](includes/upgrade-supported-path.md)]
68-
67+
For supported upgrade paths, see [Upgrade Azure Arc-enabled data services](upgrade-overview.md).
6968

7069
### Authenticate
7170

articles/azure-arc/data/upgrade-data-controller-direct-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ This section shows how to upgrade a directly connected data controller.
3737
> To upgrade, delete all non-GA database instances. You can find the list of generally available
3838
> and preview services in the [Release Notes](./release-notes.md).
3939
40-
[!INCLUDE [upgrade-supported-path](includes/upgrade-supported-path.md)]
40+
For supported upgrade paths, see [Upgrade Azure Arc-enabled data services](upgrade-overview.md).
4141

4242

4343
### Upgrade

articles/azure-arc/data/upgrade-data-controller-indirect-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ This section shows how to upgrade an indirectly connected data controller.
6464
> To upgrade, delete all non-GA database instances. You can find the list of generally available
6565
> and preview services in the [Release Notes](./release-notes.md).
6666
67-
[!INCLUDE [upgrade-supported-path](includes/upgrade-supported-path.md)]
67+
For supported upgrade paths, see [Upgrade Azure Arc-enabled data services](upgrade-overview.md).
6868

6969

7070
### Upgrade

articles/azure-arc/data/upgrade-data-controller-indirect-kubernetes-tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ This section shows how to upgrade an indirectly connected data controller.
7373
> To upgrade, delete all non-GA database instances. You can find the list of generally available
7474
> and preview services in the [Release Notes](./release-notes.md).
7575
76-
[!INCLUDE [upgrade-supported-path](includes/upgrade-supported-path.md)]
76+
For supported upgrade paths, see [Upgrade Azure Arc-enabled data services](upgrade-overview.md).
7777

7878

7979
### Upgrade
Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: Overview - upgrade Azure Arc-enabled data services
3+
description: Explains how to upgrade Azure Arc-enabled data controller, and other data services.
4+
services: azure-arc
5+
ms.service: azure-arc
6+
ms.subservice: azure-arc-data
7+
author: dnethi
8+
ms.author: dinethi
9+
ms.reviewer: mikeray
10+
ms.date: 08/15/2022
11+
ms.topic: conceptual
12+
---
13+
14+
# Upgrade Azure Arc-enabled data services
15+
16+
This article describes the paths and options to upgrade Azure Arc-enabled data controller and data services.
17+
18+
## Supported versions
19+
20+
Each release contains an image tag. Use the image tag to identify when Microsoft released the component. Microsoft supports the component for 1 full year after the release.
21+
22+
Identify your current version by image tag. The image tag version scheme is:
23+
- `<Major>.<Minor>.<optional:revision>_<date>`.
24+
- `<date>` identifies the year, month, and day of the release. The pattern is: YYYY-MM-DD.
25+
26+
For example, a complete image tag for the release in June, 2022 is: `v1.8.0_2022-06-06`.
27+
28+
The example image released on June 6th, 2022.
29+
30+
Microsoft supports this release through June 5th, 2023.
31+
32+
> [!NOTE]
33+
> The latest current branch version is always in the **Full Support** servicing phase. This support statement means that if you encounter a code defect that warrants a critical update, you must have the latest current branch version installed in order to receive a fix.
34+
35+
## Upgrade path
36+
37+
Upgrades are limited to the next incremental minor or major version. For example:
38+
39+
- Supported version upgrades:
40+
- 1.1 -> 1.2
41+
- 1.3 -> 2.0
42+
- Unsupported version upgrades:
43+
- 1.1 -> 1.4 Not supported because one or more minor versions are skipped.
44+
45+
## Upgrade order
46+
47+
Upgrade the data controller before you upgrade any data service. Azure Arc-enabled SQL Managed Instance is an example of a data service.
48+
49+
A data controller may be up to one version ahead of a data service. A data service major version may not be one version ahead, or more than one version behind a data controller.
50+
51+
The following list displays supported and unsupported configurations, based on image tag.
52+
53+
- Supported configurations.
54+
- Data controller and data service at same version:
55+
- Data controller: `v1.9.0_2022-07-12`
56+
- Data service: `v1.9.0_2022-07-12`
57+
- Data controller ahead of data service by one version:
58+
- Data controller: `v1.9.0_2022-07-12`
59+
- Data service: `v1.8.0_2022-06-14`
60+
61+
- Unsupported configurations:
62+
- Data controller behind data service:
63+
- Data controller: `v1.8.0_2022-06-14`
64+
- Data service: `v1.9.0_2022-07-12`
65+
- Data controller ahead of data service by more than one version:
66+
- Data controller: `v1.9.0_2022-07-12`
67+
- Data service: `v1.6.0_2022-05-02`
68+
69+
## Schedule maintenance
70+
71+
The upgrade will cause a service interruption (downtime).
72+
73+
The amount of time to upgrade the data service depends on the service tier.
74+
75+
The data controller upgrade does not cause application downtime.
76+
77+
- General Purpose: A single replica is not available during the upgrade.
78+
- Business Critical: A SQL managed instance incurs a brief service interruption (downtime) once during an upgrade. After the data controller upgrades a secondary replicas, the service fails over to an upgraded replica. The controller then upgrades the previous primary replica.
79+
80+
> [!TIP]
81+
> Upgrade the data services during scheduled maintenance time.
82+
83+
### Automatic upgrades
84+
85+
When a SQL managed instance `desiredVersion` is set to `auto`, the data controller will automatically upgrade the managed instance.

0 commit comments

Comments
 (0)