Demo ScriptWindows Azure Connect

Lab version: 1.0.0

Last updated: 5/8/2023

CONTENTS

OVERVIEW................................................................................................................................................. 3Key Messages......................................................................................................................................... 3

Key Technologies.................................................................................................................................... 3

Time Estimates........................................................................................................................................ 3

SETUP AND CONFIGURATION................................................................................................................. 4

OPENING STATEMENT............................................................................................................................. 5

STEP-BY-STEP WALKTHROUGH.............................................................................................................6Segment 1: Connect local endpoint to a Windows Azure Web Role into the Cloud................................6

SUMMARY................................................................................................................................................ 11

Overview

This document provides setup documentation, step-by-step instructions, and a written script for showing a demo of the Windows Azure Connect capabilities. This document can also serve as a tutorial or walkthrough of the technology. For additional Windows Azure demos, please visit http://www.azure.com.

Key Messages

In this demo you will see three key features:

1. Activation tokens

2. Local endpoint application

3. Groups

Key Technologies

This demo uses the following technologies:

1. Windows Azure

2. Windows Azure SDK and Windows Azure Tools for Microsoft Visual Studio

3. Windows Azure Connect

Time Estimates

Estimated time for setting up and configuring the demo: 15 min

Estimated time to complete the demo: 10 min

Setup and Configuration

Make sure you have checked all the dependencies for this demo before running the setup.

The setup and configuration for this demo involves the following tasks:

Create a hosted service in your subscription

Create a storage account in your subscription

Set PowerShell scripts execution policy to unrestricted

Run provided scripts to build and deploy the sample application

The following steps explains how to perform the previous tasks:

1. Browse to http://windows.azure.com

2. Create a new hosted service

3. Create a new storage account

4. Open a PowerShell console and set the execution policy to unrestricted (you can restore the policy to AllTrusted once finished deploying the application).

PowerShell

Set-ExecutionPolicy unrestricted

Note: The present demo includes a Visual Studio Solution that must be compiled and deployed to a Windows Azure account. To simplify the process, Deploy.cmd script will automatize this task. Please take the following considerations about the deploy script before running it:

• The management certificated created by this tool should not be shared with others.

• The hosted service provided must not contain any Production deployment, because this slot will be used to upload the compiled solution.

• The storage account provided will not be cleaned. Any existing blob, table or queue will remain intact.

5. Browse to the scripts folder and run as administrator the Deploy.cmd script. The script will build the solution and generate the package to deploy.

6. When prompted to create a certificate press Y to generate a new certificate or N if you have a certificate installed in your local machine and have it uploaded as a management certificate in the management portal.

7. If you choose to generate a new certificate, the script will pause to let you upload the generated certificate to the management portal. Upload the certificate to the management portal in the management certificates section and take note of its thumbprint.

8. Enter your subscription ID when prompted and press enter.

9. Enter the hosted service name when prompted and press enter.

10. Enter the storage account name when prompted and press enter.

11. Enter the certificate thumbprint from step 6 when prompted and press enter.

12. Wait until the package is deployed to your hosted service and it is on Ready state.

Opening Statement

In the present demo you will learn how to enable a Virtual Network between your local computer and a Web role, using the Windows Azure Connect capabilities.

Step-by-Step Walkthrough

Segment 1: Connect local endpoint to a Windows Azure Web Role into the Cloud

Action Script Screenshot

1. Navigate to the Windows Azure Management Portal http://windows.azure.com

2. Click on Virtual Network

3. Click on your subscription located on the upper part of the left pane

Your first task is to get the activation token that is used to configure the Windows Azure roles as endpoints in Windows Azure Connect.

After you log into the Windows Azure Management Portal, select the Virtual Network tab.

Expand your subscriptions, and select Groups and Roles.

4. Click on Get Activation Token into the Ribbon menu.

5. Copy the Activation Token to Clipboard

6. Open the Visual Studio solution located in the Code folder, click on properties of the Web role SampleWebApp, go to the Virtual Network tab and click on Activate Windows Azure Account, then paste the activation token.

7. Deploy the package to Windows Azure by running Deploy.cmd script.

Click Get Activation token in the menu to retrieve the token.

Click the Copy Token to Clipboard button to make it easier to collect the token.

Now, shift over to Visual Studio to complete the setup.

From the Web role properties tab, select Virtual Network and paste in the activation token.

We have updated the Windows Azure Service Model to include the activation token so that our role can function as an endpoint in Windows Azure Connect.

8. Go back to the Management Portal, and Click Install Local Endpoint located into the ribbon menu

9. Copy the download link to the clipboard

Return to the management portal so that we can download the software to install to your local machine.

Click the Install Local Endpoint button and copy the link to a browser.

10. Paste the link into the browser and proceed with the Local endpoint installation

11. When it finishes, right click on the Local endpoint icon into the System Tray bar, and see your endpoint is not configured to connect.

Paste the link into a browser to start downloading the endpoint software.

Launch the installation.

Once complete, look at the system tray bar – the endpoint is not yet configured to connect.

12. Go to the Management Portal and you can see your local endpoint reflected into your Windows Azure subscription

Return to the management portal; after a refresh, notice that your computer is not setup as a local endpoint.

13. Click Create Group on located into the Ribbon menu

14. Fill the form with the corresponding info, and click Add button into the Connect From endpoint list, and select your recently created Local Endpoint

15. Click Add button into the Connect To Azure roles or endpoint groups list and select your deployed WebRole

16. Click on Create button.

The next step is to create a group.

Click Create Group.

You need to add your local endpoint to this group so that we can configure the local endpoint. Do this by clicking Add in the Connect From section.

After you’ve added your local endpoint, you need to add your deployed Web role. Do this by clicking Add in the Connect To section.

Finish by clicking the Create button.

17. Go to your System Tray bar, right click on the Local Endpoint icon, and then click Refresh option

18. Now you can see your Local Endpoint now is configured to connect.

19. In order to test it, open a command prompt and ping your Windows Azure endpoint by running the following command, replacing [azure-endpoint] with your endpoint name.

Command Prompt

ping [azure-endpoint]

Now you can refresh the system tray bar and you’ll see that your local endpoint is now configured correctly.

To test, you can now use ping to confirm that the connection is successfully established.

Summary

In this demo, you saw how to setup a virtual network with Windows Azure Connect, downloading the client to your computer and configuring a Web Role hosted in your Azure account.