Umbraco on Windows Azure Step-by-step guide This guide is used in the Workshop training on 24 th June 2011 at OneOffice in Ghent. Presentation can be found on: http://www.slideshare.net/orbitone It describes the installation and migration of an existing Umbraco website to Windows Azure using the new accelerator by Microsoft. http://waacceleratorumbraco.codeplex.com Date: 24 June 2011 Developed by: Wim De Coninck Reference: Developed for: Orbit One BVBA Raas van Gaverestraat 83 B-9000 GENT, BELGIUM Website www.orbitone.com E-mail info@orbitone.com Tel. +32 9 330 15 00 VAT BE 456.457.353 Bank 442-7059001-50 (KBC)
Contents 1. Prerequisites 3 2. Umbraco Windows Azure accelerator 4 2.1. Prepare the Storage Account 4 2.2. Run the setup script 5 2.3. Prepare the Accelerator for deployment 5 2.4. Prepare the hosted service 6 2.5. Prepare the SQL Azure Server 7 2.6. Configure Umbraco with the setup script 7 2.7. Upload a clean Umbraco 8 3. Migrate with SQL Azure Migration Wizard 9 3.1. Configure the source database 10 3.2. Configure the destination database 11 4. Umbraco from CodePlex 12 4.1. Install 12 4.2. Configure 12 Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 2
1. Prerequisites For running the setup scripts and generating the deployment package you will need the following pre-requisites: Visual Studio 2010 and.net 4 Windows Azure SDK and Tools for Visual Studio (March 2011) version 1.4 SQL Express 2008 R2 A Windows Azure account: You can request a free (no credit card required) account by visiting http://windowsazurepass.com/, enter your country and cloudcover for promo code. It will take a couple of days before you will receive your account, so please request it a week before attending the training. Once you ve installed those, let s go get the rest: The accelerator on CodePlex SQL Azure Migration wizard Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 3
2. Umbraco Windows Azure accelerator 2.1. Prepare the Storage Account First we need a Storage account. Follow the steps below. 1. Log on to the Windows Azure platform at http://windows.azure.com 2. Click New Storage account found in the ribbon 3. Choose a subscription 4. Enter a valid name for your storage account 5. Select a region: West Europe 6. Click OK 7. Select the storage account click View in the properties pane to see the Primary Access Key. 8. Copy the Primary Access Key to the clipboard Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 4
2.2. Run the setup script 1. Double click the Setup.cmd from the extracted accelerator folder 2. Enter the storage account name 3. Enter the storage accounts primary key You are now prompted with the message: You'll need to manually deploy the Accelerator to Windows Azure.. Leave this message as it is for now. 2.3. Prepare the Accelerator for deployment 1. Open the Umbraco.sln file located in the code folder of the accelerator 2. In the solution Explorer, right click the UmbracoAccelerator Cloud Project and Publish 3. Select Create Service package only: 4. Click Ok. When the deployment succeeded a new Explorer window opens with the following 2 files: Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 5
2.4. Prepare the hosted service 1. Go back to the Windows Azure Platform portal 2. Click New Hosted Service found in the ribbon 3. In the dialog, select the subscription you are using. 4. Enter a service name and URL prefix 5. Choose the region: West Europe 6. Choose Deploy to Production as a deployment option 7. Give your deployment a name: eg: v1.0 8. Browse to the local location for the package and service configuration. 9. Upload the remote desktop certificate. a. Click Add Certificate b. Browse to the Assets folder from the accelerator c. Select the remote.pfx certificate d. The password is q3&d3new7@0 The package begins to upload and shows the deployment status. This process can take from 5 to 15 minutes. Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 6
2.5. Prepare the SQL Azure Server 1. In the Windows Azure Platform portal home screen select New Database Server 2. Select the region: West Europe 3. Choose an administrator name and a password 4. Add the firewall rule for the Orbit One IP range: 195.80.238.1-255 5. Click Ok and then Finish. 6. Take note of the server name (servername.database.windows.net) 2.6. Configure Umbraco with the setup script Once the WebRoles have been deployed, go back to the command line window and proceed with the configuration process. 1. Provide the SQL Azure database name to create 2. Enter the user name and password 3. Do you want a clean install? (Y/N) Choose Y in order to create a clean database. NOTE: Choose N to migrate an existing Umbraco database to SQL Azure. (see Migrate with SQL Azure Migration Wizard) 4. Enter the SQL Azure server name from before 5. Enter a database name 6. Enter the credentials for the SQL Azure server (in this demo we will just use the sql azure admin account) Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 7
2.7. Upload a clean Umbraco 1. Download the Umbraco 4.7 at http://umbraco.codeplex.com/releases 2. Extract the package to c:\temp\umbraco\v4.7.0.378 3. Go back to the command line and provide the path to the Build folder (with trailing slash): c:\temp\umbraco\v4.7.0.378\build\ NOTE: If you want to migrate an existing site take a backup of the site and enter the physical path to the site with trailing slash in the command window. 4. Give a database name for the Session State database (the same server will be used) 5. Upload a site to the blob storage? Choose Yes 6. Provide the site name (used as host header, eg. www.umbracointhecloud.com) To be able to view the site, you ll need to register the domain to point to Windows Azure. To work around that, we enter the IP address at the bottom of the screen. To find this IP address you ping yoursite.cloudapp.net or look for it in the portal. It is the last property of your deployment in the hosted services tab. Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 8
3. Migrate with SQL Azure Migration Wizard Download the SQL Azure Migration Wizard at http://sqlazuremw.codeplex.com/releases Extract the zip file and start the program. Choose Analyze and migrate - SQL Database. Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 9
3.1. Configure the source database 1. Enter the local database server 2. Provide credentials 3. Specify the database 4. Click Connect 5. Click Next 3 times 6. Click Yes to generate the SQL script 7. Click Next when the script is generated Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 10
3.2. Configure the destination database 1. Enter the name of the SQL Azure database server 2. Provide credentials 3. I have a blank database on the SQL Azure database server Specify the database Click Connect I don t have a blank database Use the master database Click Connect Click Create database Give the database a name Click Create database 4. Click Next 5. Click Yes to run the scripts against the destination server Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 11
4. Umbraco from CodePlex 4.1. Install 1. Download Umbraco 4.7 from codeplex: http://umbraco.codeplex.com/releases/ 2. Extract to c:\inetpub\umbraco a. Create website in IIS and point to c:\inetpub\umbraco b. Change the application pool to.net 4.0 c. Grant full control permission to the application pool user on the Umbraco folder. 4.2. Configure Browse to the website, and complete the configuration process. Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 12
5. Questions? Wim De Coninck http://twitter.com/wimdc Olivier Mangelschots http://twitter.com/omangels Umbraco on Windows Azure - Step-by-step guide - 24 June 2011 13