Skip to content

Latest commit

 

History

History
45 lines (34 loc) · 4.22 KB

WebsitePublish.md

File metadata and controls

45 lines (34 loc) · 4.22 KB
Raw

This document explains how to build and deploy a sample website that is used to show data and alerts in the Connect The Dots project. It assumes you have all necessary software and subscriptions and that you have cloned or download the ConnectTheDots.io project on your machine.

Prerequisites

Make sure you have all software installed and necessary subscriptions as indicated in the Readme.md file for the project. To repeat them here, you need

  1. Microsoft Azure subscription (free trial subscription is sufficient)
  2. Access to the Azure Streaming Analytics Preview
  3. Visual Studio 2013 – Community Edition

In addition, you must have run the AzurePrep program discussed in that section, as it creates the event hubs from which the website pulls data, as well as populates the web.config file that is published for the Azure website. If you already have the event hubs and are simply republishing a website, you can just edit the web.config file manually before publishing. To do this, open ConnectTheDots\Azure\WebSite\ConnectTheDotsWebSite\web.config and find the lines

<add key="Microsoft.ServiceBus.EventHubDevices" value="ehdevices" />
<add key="Microsoft.ServiceBus.EventHubAlerts" value="ehalerts" />
<add key="Microsoft.ServiceBus.ConnectionString" value="Endpoint=sb://{namespace-name}.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue={key}" />
<add key="Microsoft.ServiceBus.ConnectionStringDevices" value="Endpoint=sb://{namespace-name}.servicebus.windows.net/;SharedAccessKeyName=WebSite;SharedAccessKey={key}" />
<add key="Microsoft.ServiceBus.ConnectionStringAlerts" value="Endpoint=sb://{namespace-name}.servicebus.windows.net/;SharedAccessKeyName=WebSite;SharedAccessKey={key}" />
<add key="Microsoft.Storage.ConnectionString" value="DefaultEndpointsProtocol=https;AccountName={storageaccount};AccountKey={key}" />

You will need to replace the last four connection strings with the appropriate values for your subscription, found in https://manage.windowsazure.com as follows:

  1. ServiceBus.ConnectionString. Select Service Bus from the left nav menu, highlight the Namespace Name created earlier, click on Connection Information at the bottom of the screen, and copy the RootManagedSharedAccessKey.
  2. ServiceBus.ConnectionStringDevices. Select Service Bus from the left nav menu, select the Namespace Name created earlier, highlight ehdevices, click on Connection information at the bottom of the screen, and copy the WebSite Connection string.
  3. ServiceBus.ConnectionStringAlerts. Select Service Bus from the left nav menu, select the Namespace Name created earlier, highlight ehalerts, click on Connection information at the bottom of the screen, and copy the WebSite Connection string.
  4. Storage.ConnectionString. Select Storage from left nav menu, highlight the storage account created earlier, click on Manage Access Keys at the bottom of the screen, and copy the Primary Access Key.

Publish the Azure Website

  • Open the ConnectTheDots\Azure\WebSite\ConnectTheDotsWebSite.sln solution in Visual Studio
  • In VS, Right-click on the project name and select Publish.
  • Select Azure Web Sites, create new one.
    • Site name: [pick something unique]
    • Region: [pick same region as you used for Stream Analytics]
    • Database server: no database
    • Password: [leave suggested password]
  • Publish (you might need to install WebDeploy extension if you are having an error stating that the Web deployment task failed. You can find WebDeploy here).

Websockets setting

  • Enable WebSockets for the new Azure Web site

##Running the site

  • Open the site in a browser to verify it has deployed correctly.
    • At the bottom of the page you should see “Connected.”. If you see “ERROR undefined” you likely didn’t enable WebSockets for the Azure Web Site (see step d above).