Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Update the Azure Guest OS by Modifying the Service Configuration File

Update the Azure Guest OS by Modifying the Service Configuration File

Updated: March 2, 2015

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 (Guest OS)

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.

  1. Open the service configuration file (.cscfg file name extension) for the cloud service.

  2. In the ServiceConfiguration element, type a numberfor the osFamily attribute. For example, to specify the operating system family that is substantially compatible with Windows Server 2012 R2, set osFamily=4

  3. 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 Windows Azure Service Configuration Schema.

      To review available Guest OS versions, their configuration values and determine their compatibility with the Windows Azure SDK, see Windows Azure Guest OS Versions and SDK Compatibility Matrix.

    For more information about the osFamily and the osVersion attributes of the ServiceConfiguration element, see the Windows Azure Service Configuration Schema reference topic.

See Also

© 2015 Microsoft