Click to Rate and Give Feedback
MSDN
MSDN Library
Windows Azure SDK

  Switch on low bandwidth view
Windows Azure SDK, Community Technology Preview
Getting Started with the Windows Azure SDK
[This is preliminary documentation and is subject to change.]

The Windows® Azure™ SDK contains tools, libraries and samples that you can use to:

  • Build and run a service consisting of a web role and/or an asynchronous worker role in the development fabric, and package the service for deployment to Windows Azure.
  • Build and run services hosted in the development fabric that employ the Blob, Queue, and Table services, and test them locally against development storage.
  • Call into the development storage services for the Blob, Queue, and Table services from a client application that is not hosted in the development Windows Azure fabric.

Installing the Windows Azure SDK and running the development storage and the development fabric requires the following minimum system configuration:

  • Operating system:
    • The 64-bit (x64) version of the SDK requires a 64-bit edition of Windows Vista® SP1 or Windows Server® 2008.
    • The 32-bit (x86) version of the SDK requires a 32-bit editions of Windows Vista SP1 or Windows Server 2008.
Dd179419.note(en-us,MSDN.10).gifNote:
The 32-bit version of the SDK cannot be installed on a 64-bit operating system; running the SDK under Microsoft Windows 32-bit-On-Windows-64-bit (Wow64) is not supported.

Enabling IIS 7.0 with ASP.NET and WCF HTTP Activation

The following instructions enable IIS 7.0 with ASP.NET and WCF HTTP Activation on the supported operating systems.

To enable IIS 7.0 with ASP.NET and WCF HTTP Activation on Windows Server 2008

  1. Click the Start button, and then point to All Programs. Point to Administrative Tools, and then click Server Manager.
  2. In Server Manager, under Features Summary, click Add Features.
  3. In the Add Features dialog box, under.NET Framework 3.0 Features, click .NET Framework 3.0.
  4. Under WCF Activation, click HTTP Activation.
  5. Click Next to enable HTTP Activation.
  6. In Server Manager, under Roles Summary, verify that Web Server (IIS) appears in the list of available roles. If it does not, click Add Roles to install Internet Information Services.
  7. In Server Manager, under Roles Summary, click Web Server (IIS).
  8. In the Web Server (IIS) management window, click Add Role Services.
  9. In the Add Role Services dialog box, expand Web Server, expand Common HTTP Features, and then click Static Content.
  10. In the Add Role Services dialog box, expand Web Server, expand Application Development, and then click ASP.NET.
  11. Click Next to enable Static Content and ASP.NET.

To enable IIS 7.0 with ASP.NET and WCF HTTP Activation on Windows Vista

  1. Click the Start button, click Settings, click Control Panel, click Programs, and then click Programs and Features.
  2. Click Turn Windows Features On or Off.
  3. Under Microsoft .NET Framework 3.0, click Windows Communication Foundation HTTP Activation.
  4. Under Internet Information Services, expand World Wide Web Services.
  5. Under Application Development Features, click ASP.NET.
  6. Under Common HTTP Features, click Static Content.
  7. Install the selected features.

You can optionally enable CGI in IIS 7.0, if you wish to host native applications on FastCGI.

To enable CGI on Windows Server 2008

  1. Click the Start button, and then point to All Programs. Point to Administrative Tools, and then click Server Manager.
  2. In Server Manager, under Roles Summary, click Web Server (IIS).
  3. In the Web Server (IIS) management window, click Add Role Services.
  4. In the Add Role Services dialog box, expand Web Server, expand Application Development, and then click CGI.
  5. Click Next to enable CGI.

To enable CGI on Windows Vista

  1. Click the Start button, click Settings, click Control Panel, click Programs, and then click Programs and Features.
  2. Click Turn Windows Features On or Off.
  3. Under Microsoft .NET Framework 3.0, click Windows Communication Foundation HTTP Activation.
  4. Under Internet Information Services, expand World Wide Web Services.
  5. Under Application Development Features, click CGI.
  6. Install the selected feature.

Before installing the SDK, you must remove previous versions you may have installed. Right-click the Microsoft Windows Installer file, and then click Uninstall to remove the SDK. Then, install the SDK on your computer by running the Windows Installer file. By default, the SDK is installed into the C:\Program Files\Windows Azure SDK\ directory.

Note that you must provide administrator credentials to install, uninstall, or repair the SDK if you are installing as a user other than the computer administrator. If you are not the administrator and you are not running in elevated mode, you'll be prompted with User Account Control (UAC) dialog boxes.

To use the samples, navigate to the installation directory of the SDK and unzip the samples.zip file to a directory where you have write access.

Dd179419.note(en-us,MSDN.10).gifNote:
You may not have write access to directories under the Program Files directory by default. Therefore, it's recommended that you choose a different parent directory for the sample applications, such as C:\Samples.

Next, test the SDK installation as follows:

  1. To open the Windows Azure SDK command prompt, click the Start button, click Program Files, click Windows Azure SDK (May 2009 CTP), and then click Windows Azure SDK Command Prompt.
  2. Navigate to your sample directory, and then run the rundevstore.cmd utility to build the samples, create local tables required by the samples, and launch development storage. Running development storage starts the local Blob, Queue, and Table services.
  3. Navigate to the HelloWorld application directory, and then run the runme.cmd script.

If the development fabric is not already running, you will see the development fabric icon appear in the system tray after a minute or two. Running the sample will automatically launch your Web browser and point to the service's default Web page. You should see the Web interface for the Hello World sample displayed in the browser window. Note that you may need to refresh the browser.

The SDK contains the following directories, as well as a set of release notes:

  • Ref: This directory contains the library for the Windows Azure runtime APIs (Microsoft.ServiceHosting.ServiceRuntime.dll). For details, see Windows Azure SDK Runtime API Reference.
  • Bin: This directory contains the tools that you need to package and run your service, as well as the tools for developing and testing your services on the desktop. For details, see Windows Azure SDK Tools Reference.
  • Samples: This .zip file contains the seven samples that ship with the SDK. There is a readme.txt file in the directory of each sample that explains how to build and run the sample. For details, see Windows Azure SDK Samples.
  • Schemas: This directory contains the schema files for the service definition file and the service configuration file. For details, see Windows Azure SDK Schema Reference.
  • Doc: This directory contains the Help file for the SDK.
  • Release notes: The release notes may be found at the root directory of the SDK installation.
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker