Build new applications in the cloud - or use interoperable services that run on Microsoft infrastructure to extend and enhance your existing applications. You choose what's right for you.

Table of Contents

Installation Guide



1. Pre-requisites

There are two ways to develop applications in Windows Azure: locally on a developer machine or on the Windows Azure production environment. To enable local development, check below Windows Azure Environment products are installed on your machine.

Windows Azure Production Environment is to lead you register an account for working with the Windows Azure.


Windows Azure Tools for Eclipse is the minimum system requirements for installing this plug-in that enable developers to use the Eclipse platform to create applications that run on Windows Azure. Any service from Windows Azure must satisfy Windows Azure Environment.


Windows Azure Environment


Windows Azure Production Environment

  1. Please read Getting Started with the Windows Azure SDK to install Windows Azure SDK and configure Windows.
  2. Get yourself a Windows Azure token. This allows you to deploy to Windows Azure.
  3. If you don’t have a token already, Register for Windows Azure Services
  4. Go to the Windows Azure Portal at (you will need a Live ID) and redeem your token (click on the Account tab)


Windows Azure Tools for Eclipse

If you use an eclipse without PDT, it will be installed automatically by Eclipse Update Manager.

2. Installation

For now, Windows Azure Tools for Eclipse only supports Eclipse update. Make sure your machine is correctly connected to the Internet. Then following below instructions step by step, the Eclipse update wizard will finds and installs all the required plugins.


Open Eclipse, select Help->Install New Software...




In the Available Software, Click Add... button.



In the pop-up dialog, fill in the Location with and Name is user defined (Recommend Windows Azure Tools for Eclipse here).



Select All available sites. If the list of categories doesn't contain the entry "Windows Azure", you need to restart eclipse.


Select Windows Azure PDT and click Next button.



In the next dialog, check Windows Azure PDT and click Next button.



Then read carefully the license agreement. If you accept all conditions, select I accept... option and click Finish button.



Wait a second for downloading and installing the required jar package. When finished installing, it will pop-up a dialog, click Yes button to restart your Eclipse for the changes to take effect.



To check the plugin installation is successful, you can select Help->About Eclipse. In the next dialog box, click Installation Details, select Installed Software option, you will see Windows Azure PDT in the Name list. See the screenshot below.



There will be a new Windows Azure menu in Perspective Menus.



3. Eclipse configuration

Before getting started with this plugin, some configurations are necessary to prevent the potential problems during the development.

3.1 Java and Eclipse setting

The default confiiguration of eclipse is very limited in terms of the resource allocation. We advise users to set up the eclipse.ini file with the following parameters:




3.2 PDT Setting

PDT (PHP Development Toolkit) of eclipse has embedded two debuggers: Zend Debugger and XDebuger. Unfortunately, ZendDebugger uses the default port 10000, which is the default port of Windows Azure Blob service. To resolve this conflict, we need to change the ZendDebugger's default value via Eclipse Preferences: Windows->Preferences`