1. Goal

This manual will help you step-by-step to install CloudSaver on Window Azure.

1.1 Glossary

· SSL Certificate: it provides security for Web traffic including confidentiality, message integrity, non-repudiation and authentication.

· Azure Storage: it provides persistent, redundant storage in the cloud.

· Subscription ID: it allows the use of Windows Azure and its administration tool.

· Partner/Client (PC): the company which will use the application.

· Technical Contact (TC): the technician who will setup the solution on the cloud.

· End-user (EU): everybody belonging to the PC group.

· Virtual Machine Size: Windows Azure offers various instance sizes from Small with one core to Extra- Large with eight cores.

2. Installation process

The installation can be done in two different ways:

· Using the source code

· Using a pre-compiled application

Except for the second solution, you can customize CloudSaver’s functionalities using the source code. The compiled application allows you to make the deployment quickly.

2.1 Using the source code

You can open the solution using Visual Studio 2010. At first you need to have installed Window Azure SDK, which you can find at this link: http://www.microsoft.com/download/en/details.aspx?id=15658)

The project has been written in ASP.NET 4 Web Forms.

Technical features:

· .NET Framework 4


· AJAX Toolkit

· AspProviders

After customizing the solution, you can right-click on the project and select “Publish”. This action will create a package .cspkg and a file .cscfg which you can deploy on the Windows Azure.

2.2 Using a pre-compiled application

You need to create a Window Azure account (to have more info, read the guide at this link http://www.microsoft.com/online/help/it-it/helphowto/f9a74cd3-c940-4946-9095-433708a74552.htm).

After that, you have to follow these steps:

1. Go to https://windows.azure.com

2. In “Hosted Services, Storage Accounts & CDN” section, click on “Hosted Services”.


Picture 1: Azure control panel - Hosted Services

3. Click on “New Hosted Service” to create a new service

a. Set the service name, the url alias and the deploy region


Picture 2: Create a New Hosted Service

4. Upload the SSL certificate which you have already created with its private key (to create a new certificate you can read a brief guide 4.14.1):


Picture 3: Upload a SLL certificate

5. Take a note of the thumbprint of the certificate, available on the right of the panel after its uploading:


Picture 4: Thumbprint of the certificate

6. In the “Storage Accounts” section, create a new storage service (“New Storage Account”) like below picture:


Picture 5: Create a New Storage Account

7. Take a note of the Storage account name and its access key (available on the right):


Picture 6: Storage Access Keys

8. Edit ServiceConfiguration.cscfg file specifying:

a. Storage account name (parameter {0})

b. Storage access key (parameter {1})

c. Thumbprint of the SSL certificate (parameter {2})


9. If you don’t want to use the manual configuration , you can use the Microsoft.CloudSaver.Configurator.exe tool. It will create a cscfg file already compiled with the specified parameters.

Picture 7: Configurator Tool for CSCFG file

10. Come back to “Hosted Services” to create the deployment. Click on “New Production Deployment”, set a name (es. “v1.0”) and the location of your deploy package and of the configuration file created before:


Picture 8: Create a new Deployment

11. If everything is fine, you should see the following scenario:


Picture 9: Application deployed

3. How to use

After the installation, the solution is on line and available going to an url which has this pattern: [yourAppName].cloudapp.net.

After the first access, the application runs an autosetup which allows to see this page:


Picture 10: CloudSaver homepage

You have to login with the following administrative credentials:

· Username: Admin

· Password: Passw0rd!

An admin user, thought his/her administration page, can:

· Create a new user (admin user or common user)

· Edit user permission

· Reset the password

· Manage all permission

· Manage system settings

The picture below shows how to create the users and set the company name and logo:


Picture 11: User creation (Administrator page)


Picture 12: System settings

3.1 File saving process

The user (admin or simple user) has his/her own folder to save files.

In the “files” page you can upload, download, delete your files. Every user can change the application theme using the dropdown list on the left:


Picture 13: Files Management

4. Appendix

4.1 How to create a SSL self-signed certificate

This brief guide will help you to create a SSL certificate to provide a secure communication (transport-layer security).

4.1.1 How to create a certificate using IIS

After opening IIS, you have to go to “Server Certificates” section:


Picture 14: IIS and SSL Certificate

Click on “Create Self-Signed Certificate” and set a certificate name. Export the certificate right-clicking on it.

Picture 15: Certificate export


While the exporting, set a password for the private key. Now you can import the .pfx file in Windows Azure administrative console.

Last edited Dec 22, 2011 at 11:27 AM by child, version 1


No comments yet.