Update the Azure Guest OS by Modifying the Service Configuration File
Updated: March 27, 2014
Use the following procedure to configure the Windows Azure Guest operating system (Guest OS) for a Windows Azure cloud service (formerly called a hosted service) by updating the service configuration file. You can initiate a manual Guest OS update by specifying the Guest OS family and version, or you can configure automatic Guest OS updates for your service deployment.
For background on the Windows Azure Guest OS, see Manage Upgrades to the Azure Guest Operating System
|We recommend that you configure your service for automatic Guest OS updates. The Guest OS is updated periodically, with the goal of resolving known security vulnerabilities and providing the most up-to-date runtime environment for Windows Azure. The monthly releases include the patches provided by the Microsoft Security Bulletin.|
Open the service configuration file (.cscfg file name extension) for the cloud service.
In the ServiceConfiguration element, type a number for the osFamily attribute. The number corresponds to the family listed in the Azure Guest OS Releases and SDK Compatibility Matrix. For example, to specify the operating system family that is substantially compatible with Windows Server 2012 R2, set osFamily=4
Set the osVersion attribute:
To configure the service for automatic Guest OS updates, set the osVersion=*
Automatic updates are applied only to web roles and worker roles. Automatically upgrading from one Guest OS family to another is not supported.
To update to a specific Guest OS version, type the configuration value for the version of the Guest OS that you want to apply, as specified in the Azure Service Configuration Schema (.cscfg File).
To review available Guest OS versions, their configuration values and determine their compatibility with the Windows Azure SDK, see Azure Guest OS Releases and SDK Compatibility Matrix.
Note For more information about the osFamily and the osVersion attributes of the ServiceConfiguration element, see the Azure Service Configuration Schema (.cscfg File) reference topic.
- To configure the service for automatic Guest OS updates, set the osVersion=*