|
| 1 | +--- |
| 2 | +title: Guest OS family 2, 3, and 4 retirement notice | Microsoft Docs |
| 3 | +description: Information about when the Azure Guest OS Family 2, 3, and 4 retirement happened and how to determine if you are affected. |
| 4 | +services: cloud-services |
| 5 | +ms.subservice: auto-os-updates |
| 6 | +author: raiye |
| 7 | +manager: timlt |
| 8 | +ms.service: cloud-services |
| 9 | +ms.topic: article |
| 10 | +ms.date: 07/03/2024 |
| 11 | +ms.author: raiye |
| 12 | +ms.custom: compute-evergreen |
| 13 | +--- |
| 14 | + |
| 15 | +# Guest OS Family 2, 3, and 4 retirement notice |
| 16 | + |
| 17 | +The retirement of Azure Guest OS Families 2, 3, and 4 was announced in July 2024, with the following end-of-life (EOL) dates: |
| 18 | +- **Windows Server 2008 R2:** December 2024 |
| 19 | +- **Windows Server 2012 and Windows Server 2012 R2:** February 2025 |
| 20 | + |
| 21 | +If you have additional questions, visit the [Microsoft Q&A question page for Cloud Services](/answers/topics/azure-cloud-services.html) or [contact Azure support](https://azure.microsoft.com/support/options/). |
| 22 | + |
| 23 | +## Are you affected? |
| 24 | + |
| 25 | +Your Cloud Services or [Cloud Services Extended Support](../cloud-services-extended-support/overview.md) are affected if any one of the following applies: |
| 26 | + |
| 27 | +1. You have a value of "osFamily = "2", "3", or "4" explicitly specified in the ServiceConfiguration.cscfg file for your Cloud Service. |
| 28 | +1. The Azure portal lists your Guest Operating System family value as "Windows Server 2008 R2", “Windows Server 2012”, or “Windows Server 2012 R2”. |
| 29 | + |
| 30 | +To find which of your cloud services are running which OS Family, you can run the following script in Azure PowerShell, though you must [set up Azure PowerShell](/powershell/azure/) first. |
| 31 | + |
| 32 | +```powershell |
| 33 | +foreach($subscription in Get-AzureSubscription) { |
| 34 | + Select-AzureSubscription -SubscriptionName $subscription.SubscriptionName |
| 35 | +
|
| 36 | + $deployments=get-azureService | get-azureDeployment -ErrorAction Ignore | where {$_.SdkVersion -NE ""} |
| 37 | +
|
| 38 | + $deployments | ft @{Name="SubscriptionName";Expression={$subscription.SubscriptionName}}, ServiceName, SdkVersion, Slot, @{Name="osFamily";Expression={(select-xml -content $_.configuration -xpath "/ns:ServiceConfiguration/@osFamily" -namespace $namespace).node.value }}, osVersion, Status, URL |
| 39 | +} |
| 40 | +``` |
| 41 | + |
| 42 | +Your cloud services will be impacted by OS Family 2, 3, and 4 retirement if the osFamily column in the script output is empty (as default will change) or contains a "2", "3", or "4". |
| 43 | + |
| 44 | +## Recommendations if you are affected |
| 45 | + |
| 46 | +We recommend you migrate your Cloud Service or [Cloud Services Extendeed Support](../cloud-services-extended-support/overview.md) roles to one of the supported Guest OS Families: |
| 47 | + |
| 48 | +**Guest OS family 7.x** - Windows Server 2022 *(recommended)* |
| 49 | + |
| 50 | +1. Ensure that your application is using Visual Studio 2019 and above with Azure Development Workload as selected and your application is targeting .NET framework version 4.8 and above. |
| 51 | +1. Set the osFamily attribute to "7" in the ServiceConfiguration.cscfg file, and redeploy your cloud service. |
| 52 | + |
| 53 | +**Guest OS family 6.x** - Windows Server 2019 |
| 54 | + |
| 55 | +1. Ensure that your application is using SDK 2.9.6 or later and your application is targeting .NET framework 3.5 or 4.7.2 and above. |
| 56 | +1. Set the osFamily attribute to "6" in the ServiceConfiguration.cscfg file, and redeploy your cloud service. |
| 57 | + |
| 58 | +## Important clarification regarding Cloud Services support |
| 59 | + |
| 60 | +As we continue our commitment to providing the best possible support and services, we would like to clarify the distinction between the retirement of Azure Guest OS Families 2, 3, and 4, and the broader support strategy for Azure Cloud Services. |
| 61 | + |
| 62 | +The announcement of the retirement of Azure Guest OS Families 2, 3, and 4, effective May 2025, pertains specifically to the operating systems within these families. This retirement doesn't extend the overall support timeline for Azure Cloud Services (classic) beyond the scheduled deprecation in August 2024. [Cloud Services Extended Support](../cloud-services-extended-support/overview.md) continues support with Guest OS Families 5 and newer. |
| 63 | + |
| 64 | +Customers currently using Azure Cloud Services who wish to continue receiving support beyond August 2024 are encouraged to transition to [Cloud Services Extended Support](../cloud-services-extended-support/overview.md). This separate service offering ensures continued assistance and support. Cloud Servives Extended Suport requires a distinct enrollment and isn't automatically included with existing Azure Cloud Services subscriptions. |
| 65 | + |
| 66 | +## Next steps |
| 67 | + |
| 68 | +Review the latest [Guest OS releases](cloud-services-guestos-update-matrix.md). |
0 commit comments