SALES: 1-800-867-1380

Azure Guest OS Releases and SDK Compatibility Matrix

Updated: June 17, 2014

ImportantImportant
This page applies to Cloud Services web and worker roles, which run on top of a Guest OS. It does not apply to IaaS Virtual Machines. If you configure your roles to use automatic Guest OS updates as described in Azure Guest OS Update Settings, it is not vital that you read this page.

TipTip
Subscribe to the Guest OS Update RSS Feed to receive the most timely notification on all Guest OS changes. Changes mentioned on that feed will be integrated into this page approximately every week.

June 24, 2014 –June release (versions 4.9, 3.16, 2.28, and 1.36) started June 16th and completed June 24th

June 13, 2014 –May release (versions 4.8, 3.15, 2.27, and 1.35) started May 30th and completed June 10th.

May 28, 2014 – Microsoft is giving customers an additional 90 days (until Sept 2nd 2014) to move off Guest OS Family 1 (Windows 2008). See Azure Guest OS Family 1 Retirement Information for more information.

May 6, 2014 –April release (versions 4.7, 3.14, 2.26, and 1.34) started May 2nd and completed May 6th.

April 16, 2014 –March release (versions 4.6, 3.13, 2.25, and 1.33) completed April 15th and includes relevant MSRC updates through March 2014.

March 24, 2014 –February release (versions 4.5, 3.12, 2.24, and 1.32) started on March 11th and completed March 21st. The release includes the relevant MSRC updates through February 2014.

This section lists the currently supported Guest OS versions. Guest OS families and versions have a disabled date and an expiration date. A Guest OS is removed from the management portal on or after its "disabled" date. It is then "in transition" but is supported with limited ability to update a deployment. The expiration date is when a version or family is scheduled to be removed from the Azure system completely. Cloud services still running on a version when it expires will be stopped, deleted or force upgraded to a newer version depending on the policies listed earlier on this page.

WarningWarning
*The retirement of Guest OS family 1 began June 1, 2013 and is scheduled to complete soon. Do not create new installations and upgrade older ones using this Guest OS family. For more information see Azure Guest OS Family 1 Retirement Information

Enhanced security configuration registry settings were included in the Guest OS starting with versions 3.3, 2.15, and 1.23. Review these settings in KB article 2859054.

The Guest OS version will not be disabled or force updated before the dates listed below.

 

Guest OS Version Configuration String Release Date Disable Date (removed from Portal) Expiration Date (forced update sometime after this date)

FAMILY 4
Windows Server 2012 R2
Supports .NET 4.0, 4.5, 4.5.1

4.9

WA-GUEST-OS-4.9_201406-01

June 16 2014

Aug 16 2014

TBD

4.8

WA-GUEST-OS-4.8_201405-01

June 1 2014

Aug 1 2014

TBD

4.7

WA-GUEST-OS-4.7_201404-01

May 2 2014

July 2 2014

TBD

4.6

WA-GUEST-OS-4.6_201403-01

Mar 28 2014

June 9 2014

TBD

4.5

WA-GUEST-OS-4.5_201402-01

Mar 21 2014

May 21 2014

TBD

FAMILY 3
Windows Server 2012
Supports .NET 4.0, 4.5

3.16

WA-GUEST-OS-3.16_201406-01

June 16 2014

Aug 16 2014

TBD

3.15

WA-GUEST-OS-3.15_201405-01

June 1 2014

Aug 1 2014

TBD

3.14

WA-GUEST-OS-3.14_201404-01

May 2 2014

July 2 2014

TBD

3.13

WA-GUEST-OS-3.13_201403-01

Mar 28 2014

June 9 2014

TBD

3.12

WA-GUEST-OS-3.12_201402-01

Mar 21 2014

May 21 2014

TBD

FAMILY 2
Windows Server 2008 R2 SP1
Supports .NET 3.5, 4.0

2.28

WA-GUEST-OS-2.28_201406-01

June 16 2014

Aug 16 2014

TBD

2.27

WA-GUEST-OS-2.27_201405-01

June 1 2014

Aug 1 2014

TBD

2.26

WA-GUEST-OS-2.26_201404-01

May 2 2014

July 2 2014

TBD

2.25

WA-GUEST-OS-2.25_201403-01

Mar 28 2014

June 9 2014

TBD

2.24

WA-GUEST-OS-2.24_201402-01

Mar 21 2014

May 21 2014

TBD

FAMILY 1*
Windows Server 2008 SP2
3.5, 4.0. Does NOT support 4.5 or later even if manually installed.

   

Sept 2 2014

Sept 2 2014

1.36

WA-GUEST-OS-1.36_201406-01

June 1 2014

Aug 16 2014

TBD

1.35

WA-GUEST-OS-1.35_201405-01

June 1 2014

Aug 1 2014

TBD

1.34

WA-GUEST-OS-1.34_201404-01

May 2 2014

July 2 2014

TBD

1.33

WA-GUEST-OS-1.33_201403-01

Mar 28 2014

June 9 2014

TBD

1.32

WA-GUEST-OS-1.32_201402-01

Mar 21 2014

May 21 2014

TBD

This table shows which Guest OS family is compatible with which Azure SDK versions. For more information beyond this table, see Azure SDK for .NET Support and Retirement Information.

ImportantImportant
To ensure that your service works as expected, you must deploy it to Guest OS release that is compatible with the version of the Azure SDK used to develop your service. If you do not, the deployed service may exhibit errors in the cloud that were not apparent in the development environment.

 

Guest OS Family SDK Versions Supported

1

Version 1.0 and later

2

Version 1.3 and later

3

Version 1.8 and later

4

Version 2.1 and later

The Guest OS families are based on released versions of Microsoft Windows Server. The Guest OS is the underlying operating system that Azure Cloud Services run on. Each Guest OS has a family, version and release number.

A "Guest OS family" corresponds to a Windows Server operating system release that a Guest OS is based on. For example, family 3 is based on Windows Server 2012.

A "Guest OS version" is the family OS image plus relevant Microsoft Security Response Center (MSRC) patches available at the date the new Guest OS version is produced. Not all patches may be included. Numbers start at 0 and increment by 1 each time a new set of updates is added. Trailing zeros are only shown if important. That is, version 2.10 is a different, much later version than version 2.1.

A "Guest OS release" refers to a rerelease of a Guest OS version. A rerelease occurs if Microsoft finds issues during testing requiring changes. The latest release always supersedes any previous releases, public or not. The management portal will only allow users to pick the latest release for a given version. Deployments running on a previous release are usually not force upgraded depending on the severity of the bug.

In the example below, 2 is the family, 12 is the version and "rel2" is the release.

Guest OS release - 2.12 rel2
Configuration string for this release - WA-GUEST-OS-2.12_201208-02

The configuration string for a Guest OS has this same information embedded in it, along with a date showing which MSRC patches were considered for that release. In this example, MSRC patches produced for Windows Server 2008 R2 up to and including August 2012 were considered for inclusion. Only patches specifically applying to that version of Windows Server are included. For example, if an MSRC patch applies to Microsoft Office, it will not be included because that product is not part of the Windows Server base image.

This page includes information on upcoming Guest OS Releases. Customers have indicated that they want to know when a release occurs because their cloud service roles will reboot if they are set to "Automatic" update. Guest OS releases typically occur at least 5 days after the MSRC update release that occurs on the second Tuesday of every month. New releases include all the relevant MSRC patches for each Guest OS family.

Microsoft Azure is constantly releasing updates. The Guest OS is only one such update in the pipeline. A release can be affected by a number of factors too numerous to list here. In addition, Azure runs on literally hundreds of thousands of machines. This means that it's impossible to give an exact date and time when your role(s) will reboot. We will update the Guest OS Update RSS Feed with the latest information we have, but consider that time an approximate window. We are aware that this is problematic for customers and working on a plan to limit or time reboots.

When a new release of the Guest OS is published, it can take time to fully propagate across Azure. As services are updated to the new Guest OS, they are rebooted honoring update domains. Services set to use "Automatic" updates will get a release first. After the update, you’ll see the new Guest OS version listed for your service in the Azure Management Portal. Rereleases may occur during this period. Some versions may be deployed over longer periods of time and automatic upgrade reboots may not occur for many weeks after the official release date. Once a Guest OS is available, you can then explicitly choose that version from the portal or in your configuration file. For more information, see Update the Azure Guest OS from the Management Portal and Update the Azure Guest OS by Modifying the Service Configuration File.

For a great deal of valuable information on restarts and pointers to more information technical details of Guest and Host OS updates, see the MSDN blog post titled Role Instance Restarts Due to OS Upgrades.

If you manually update your Guest OS, please read the important information below on Guest OS support and retirement.

Microsoft makes the Guest OS release as secure as possible as soon as possible. Every relevant new MSRC update is integrated into the very next Guest OS release. The Guest OS is based on Windows Server, so updates that do not apply to Windows Server won't apply to the Guest OS.

To know if a particular MSRC update is in a particular Guest OS version, refer to the last part of the configuration string. For an explanation of this string, see Guest OS Family, Version and Release Explanation. For example, Guest OS version 3.8 has the configuration string WA-GUEST-OS-3.8_201310-01. Guest OS family 3 is functionally equivalent Windows Server 2012. The "201310" in the configuration string indicates that all MSRC patches applying to Windows Server 2012 up to and including the October 2013 MSRC release are integrated into Guest OS version 3.8.

In the past, we've published a table that explicitly lists the updates applied to the Guest OS at Azure Guest OS MSRC Updates Matrix. Going forward, we will not maintain this table because you can obtain this information using the rules stated in the previous paragraph.

See Also

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