One of the most useful tools to use in Windows Azure Development is the Windows Azure MMC. The Microsoft Management Console, or MMC, is the management console that many of the Windows Server Management interfaces can plug into. The Windows Azure Team has put together the Windows Azure specific MMC Console Plugin that is available for download on Microsoft MSDN Code Site at http://code.msdn.microsoft.com/windowsazuremmc.
When you navigate to the page, click on the tab for downloads and you will find three different files;
- PerfMon-Friendly Log Viewer Plugin
- PerfMon-Friendly Log Viewer Plugin (Source Only)
The main file you’ll need to download is the WindowsAzureMMC.exe file. Once this file is downloaded, run the executable. An installation wizard will appear, just click next and step through each of the steps accepting any defaults.
Once the executable runs it should pop up a Windows Explorer Window, if not navigate to where the files where just installed (unzipped) to. By default the installer places them in C:\WindowsAzureMMC\. Find the file StartHere.cmd located in the installation directory and fun the file.
When the file is executed a DOS prompt will flicker, and another configuration wizard titled Windows Azure Management Tools will appear.
Click next and the installation will start, checking each of the dependencies required to execute the MMC.
Continue to click any next prompts, and then you will have the Windows Azure MMC Console open once the StartHere.cmd finishes executing. Click close on the configuration wizard.
The MMC will now be displayed on screen as shown below.
Open the Windows Azure Management section by clicking on the small tree view arrow on the left hand side. The tree view will open up to a Service Management Node with a Hosted Services, Storage Services, and Affinity Groups listed underneath the node. Select the actual Service Management Node so that the middle window shows the connection form shown here.
Now navigate back to Windows Azure Platform Web Interface (http://windows.azure.com). Click on the project displayed on the main screen to select it.
When the follow page displays, click on the Account tab at the center top of the page.
When the Account Page finishes rendering look at the very bottom to locate the subscription ID.
Enter the subscription ID into the form. Now click on the ellipsis button on the form so the certificates that are available are displayed.
Click on the underlined link on the certificate you want to use (sometimes there are a few options, depending on what is installed on the machine already). A properties dialog should appear when you click on the underlined link button.
Click on the Details Tab on the top of the properties dialog window.
Now click on the Copy to File Button. An export process will start for the certificate. Click on next. On the next screen make sure No, do not export the private key is selected. The next screen selects the DER encoded binary X.509 (.CER) option. Verify this setting and then click next.
Click on next and then enter the path and filename where you want to save the certificate.
Now that you have the certificate, return to the Windows Azure Platform Web Interface (http://windows.azure.com). Navigate to the Account Tab section of the site again. On that page click on the Manage My API Certificates. This is the same page as shown above in the image captioned “Windows Azure Project Account Properties“. Once the page displays click on the Choose File button on the page. Find the location the certificate was saved and select the certificate. Now click the upload button to upload the file to the Windows Azure Account.
When the file is done uploading the page will update and show something similar to what is shown in the next screenshot.
Now you can click on the OK button, if you haven’t already, to confirm the API Certificate in the Windows Azure MMC. Click on the Connect button in the far right window area of the MMC. It should take a second but the connection should occur. You can tell by the Default storage account form drop down becomes enabled. At this time though, since we haven’t placed anything in storage or started any storage services there will be nothing displayed in the drop down.
At this point the MMC is functional; there just isn’t much to look at in the Windows Azure Account yet. So let’s change that and setup some sample services. First head back over to the Windows Azure Platform Web Interface (http://windows.azure.com). Once you’re in click on the project as we did before so that it is the focus point. Click on the +New Service link in the top right of the main page window section.
The next screen will display the options to create a Windows Azure Storage Account or a Hosted Services Role. Click on the Windows Azure Storage Account option.
On the screen that renders fill out the service label and description. Both of these fields are mostly free text, allowing spaces and special characters. Click next when you have filled out the label and description.
The next form that comes up has the public storage account name. This field must be compliant with URI naming conventions. The idea also is that these storage services use a RESTful API, it is best to follow the REST Architecture ideals and name the location something easy to read and to remember. You can click the check availability button to verify if the name is used or not. If it is available move down and select Anywhere US for the region.
Once you are finished click the create button at the bottom of the form. The next window will render the results of creating the Windows Azure Storage Account. This page has all the information you’ll need to fill out the Windows Azure MMC connection information.
If you still have the Windows Azure MMC open, bring focus to it again. If not open it back up and open the Windows Azure Management tree view back to the Service Management Node and verify or enter the information for the subscription ID and API Certificate. Now click on the Connect link button on the right hand window pane. The MMC will then connect and will populate the Default storage account drop down. Click on the drop down and you will see your Windows Azure Storage Account that we just created.
Now that we have a Windows Azure Storage Account, let’s get a Windows Azure Services Role running also. Navigate back to the Windows Azure Platform Web Interface (http://windows.azure.com). Once the page has rendered click on your specific project, wait for that page to render and then on the +New Service link. This time select the Windows Azure Services Role to create. On the next page fill out the service label and description the same as with the Windows Azure Storage Account creation.
Click next when complete. On the next page that renders you’ll again pick a public URI subdomain path, which I’ve used firstservicesample as mine, and select Anywhere US from the drop down for the region. Click on the create button when complete. The following page will display with a single cube image in the center of the screen, label Production. For now, the instance role is available, but nothing is deployed and nothing is being charged at this time. However this is perfect for checking out the Windows Azure MMC display of the services.
Return to the Windows Azure MMC and click on the Hosted Services node. Click on Connect in the right hand window pane under actions. The firstservicesample node, or whatever you may have named the service, will display with the staging, production, and certificates nodes appearing below. From here you can deploy, upgrade, run, delete, suspend, swap, or even save the configuration of your roles. This is extremely helpful so that one doesn’t always need to return to the site and can maintain multiple hosted services, storage services, affinity groups, and more from the MMC.
Next let’s click on the Storage Explorer Node just below the Service Management Node. Click on New Connection and enter the Account Name as shown below.
Now that the account name and URIs are filled out. Return to the storage services properties page in the Windows Azure Platform Web Interface (http://windows.azure.com).
On this page you’ll find the key you need to finish off the form in the Windows Azure MMC. Once you’ve completed the form click on OK. The MMC should now populate out the cloud storage account area with a node for BLOB Containers.
Click on the BLOG Containers so and click on Add Container in the right hand side window pane under actions. Enter a name, in this case I entered musicmanager, and click OK. Now you should have a BLOB Storage Container in your Windows Azure Storage Account.
Click on the musicmanager BLOB Container, or whatever you named yours, and then click on Upload BLOB under the actions window on the right hand side. Select a file, I’ve chosen a music MP3 I have on my local machine.
Click OK and you’ll see the Operations queue node on the lower left hand side of the Console Root tree view populate with the upload activity task.
After the upload is complete the BLOB Container will then show the BLOBs just below it when selected in the Windows Azure MMC.