SALES: 1-800-867-1380

Azure Guest OS Family 1 Retirement Information

Updated: December 1, 2014

WarningWarning
This page is retired and currently maintained at http://azure.microsoft.com/documentation/articles/cloud-services-guestos-family1-retirement. This page will soon be deleted.

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).

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.

Retirement Notice

The retirement of OS Family 1 was first announced on June 1, 2013.

Sept 2, 2014 – The Azure Guest operating system (Guest OS) Family 1.x, which is based on the Windows Server 2008 operating system, was officially retired. All attempts to deploy new services or upgrade existing services using Family 1 will fail with the error message "Guest OS Family 1 has been retired. If you need additional time for testing/migrating from this OS Family, visit http://go.microsoft.com/fwlink/?LinkId=404439"..

November 3, 2014 – Extended support for Guest OS Family 1 ended and it is fully retired. All services still on Family 1 will be impacted. We may stop those services at any time. There is no guarantee your services will continue to run unless you manually upgrade them yourself.

If you have additional questions, please visit the Cloud Services Forums or contact Azure support.

Finding out if you are affected

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 Service tells you how to locate this value.

To find which of your cloud services are running which OS Family, you can run the script below in Azure PowerShell, 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".

Recommendations if you are affected

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.

Extended Support for Guest OS Family 1 ended Nov 3, 2014

Cloud services on Guest OS family 1 are no longer supported. Please migrate off family 1 as soon as possible to avoid service disruption.

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