Export (0) Print
Expand All

Azure Guest OS Releases and SDK Compatibility Matrix

Updated: August 15, 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.

Aug 13, 2014 – The August release is projected to start on August 19th.

WarningWarning
July 22, 2014 –The August release (versions 4.11, 3.18, 2.30, and 1.38) will include Cipher Suite enhancements that go beyond the normal Windows Server defaults. Please see Differences between Azure Guest OS and Default Windows Server to determine if your application might be affected by these changes.

July 22, 2014 – Expiration dates for already disabled Guest OS versions have been added to the Future, Current and Transitional Guest OS section. The Feb, March, and April 2014 releases will expire and be removed from service on August 18, 2014.

July 22, 2014 –July release (versions 4.10, 3.17, 2.29, and 1.37) started July 18th and completed July 22nd.

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.

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

The Guest OS includes configuration different from the defaults of Windows Server. For more information see Differences between Azure Guest OS and Default Windows Server.

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

WA-GUEST-OS-4.11_201408-01

Projected for Aug 19 2014

TDB

TBD

4.10

WA-GUEST-OS-4.10_201407-01

July 18 2014

Sept 18 2014

TBD

4.9

WA-GUEST-OS-4.9_201406-01

June 16 2014

Aug 30 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

Aug 18 2014

4.6

WA-GUEST-OS-4.6_201403-01

Mar 28 2014

June 9 2014

Aug 18 2014

4.5

WA-GUEST-OS-4.5_201402-01

Mar 21 2014

May 21 2014

Aug 18 2014

FAMILY 3
Windows Server 2012
Supports .NET 4.0, 4.5

3.18

WA-GUEST-OS-3.18_201408-01

Projected for Aug 19 2014

TDB

TBD

3.17

WA-GUEST-OS-3.17_201407-01

July 18 2014

Sept 18 2014

TBD

3.16

WA-GUEST-OS-3.16_201406-01

June 16 2014

Aug 30 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

Aug 18 2014

3.13

WA-GUEST-OS-3.13_201403-01

Mar 28 2014

June 9 2014

Aug 18 2014

3.12

WA-GUEST-OS-3.12_201402-01

Mar 21 2014

May 21 2014

Aug 18 2014

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

2.30

WA-GUEST-OS-2.30_201408-01

Projected for Aug 19 2014

TBD

TBD

2.29

WA-GUEST-OS-2.29_201407-01

July 18 2014

Sept 18 2014

TBD

2.28

WA-GUEST-OS-2.28_201406-01

June 16 2014

Aug 30 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

Aug 18 2014

2.25

WA-GUEST-OS-2.25_201403-01

Mar 28 2014

June 9 2014

Aug 18 2014

2.24

WA-GUEST-OS-2.24_201402-01

Mar 21 2014

May 21 2014

Aug 18 2014

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

   

Sept 2 2014

See Azure Guest OS Family 1 Retirement Information

1.38

WA-GUEST-OS-1.38_201408-01

Aug 19 2014

Sept 2 2014

See Azure Guest OS Family 1 Retirement Information

1.37

WA-GUEST-OS-1.37_201407-01

July 18 2014

Sept 2 2014

See Azure Guest OS Family 1 Retirement Information

1.36

WA-GUEST-OS-1.36_201406-01

June 1 2014

Aug 30 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

Aug 18 2014

1.33

WA-GUEST-OS-1.33_201403-01

Mar 28 2014

June 9 2014

Aug 18 2014

1.32

WA-GUEST-OS-1.32_201402-01

Mar 21 2014

May 21 2014

Aug 18 2014

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. Any information at this list supersedes the information below.

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

Show:
© 2014 Microsoft