SALES: 1-800-867-1380

Azure Guest OS Family 1 Retirement Information

Updated: July 1, 2014

ImportantImportant
This information is only applicable when running web or worker roles as part of Azure Cloud Services. It does not apply to Azure Virtual Machines (IaaS).

This page contains information on the upcoming retirement of Guest OS Family 1 (Windows 2008 SP2).

See Manage Upgrades to the Azure Guest Operating System (Guest OS) for information on what the Azure Guest OS is. See Azure Guest OS MSRC Updates Matrix for specifics on which Guest OS families and versions are supported.

The Azure Guest operating system (Guest OS) family 1.x, which is based on the Windows Server 2008 operating system, is being officially retired on June 2, 2014. That deadline has now been extended to Sept 2, 2014 to allow customers additional time to test their services on a new family. The retirement of OS Family 1 was announced on June 1, 2013. In order to avoid any disruption to your service, you should move off this Guest OS Family as soon as possible.

Your Cloud Services are affected if any one of the following applies:

  1. You have a value of "osFamily = "1" explicitly specified in the ServiceConfiguration.cscfg file for your Cloud Service.

  2. You do not have a value for osFamily explicitly specified in the ServiceConfiguration.cscfg file for your Cloud Service. Currently, the system uses the default value of "1" in this case.

  3. The Azure Management Portal lists your Guest Operating System family value as "Windows Server 2008". The topic Determine the Current Guest OS of your Cloud Service tells you how to locate this value.

You can run the script below in Azure PowerShell to find which of your cloud services are running which OS Family, though you must set up Azure PowerShell first. For additional details on the script, see Azure Guest OS Family 1 End of Life: June 2014.

foreach($subscription in Get-AzureSubscription) {
              Select-AzureSubscription -SubscriptionName $subscription.SubscriptionName
              $deployments=get-azureService | get-azureDeployment -ErrorAction Ignore | where {$_.SdkVersion -NE ""}

              $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
}

Your cloud services will be impacted by OS Family 1 retirement if the osFamily column in the script output is empty or contains a "1".

We recommend you migrate your Cloud Service roles to one of the supported Guest OS Families:

Guest OS family 4.x based on Windows Server 2012 R2 (recommended)

  1. Ensure that your application is using SDK 2.1 or later with .NET framework 4.0, 4.5 or 4.5.1.

  2. Set the osFamily attribute to “4” in the ServiceConfiguration.cscfg file, and redeploy your cloud service.


Guest OS family 3.x based on Windows Server 2012

  1. Ensure that your application is using SDK 1.8 or later with .NET framework 4.0 or 4.5.

  2. Set the osFamily attribute to “3” in the ServiceConfiguration.cscfg file, and redeploy your cloud service.

Guest OS family 2.x based on Windows Server 2008 R2

  1. Ensure that your application is using SDK 1.3 and above with .NET framework 3.5 or 4.0.

  2. Set the osFamily attribute to "2" in the ServiceConfiguration.cscfg file, and redeploy your cloud service.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft