azureproviders Wiki Rss Feed

Updated Wiki: Adding a new profile property

ihenriksen — Mon, 07 May 2012 09:03:48 GMT

Adding a new profile property is not very intuitive, so I thought I would write a quick how-to on it.

Let say we have a new property called "TaxPercentage, first of all you need to add the following line to Webpages->Web.config under system.web->profile->properties.

<add name="TaxPercentage" type="System.String" defaultValue="" />

, that takes care of the ASP.NET declerative part, now for our code.

First, open AzureTableStorage->UserEntity.cs and add the following line in the profile region:

public string TaxPercentage { get; set; }

, this defines the entity.

Now we need to tell the profile provider that we have a new property too, so open WebPages->Bll->AzureProfileProvider.cs and add the following to the PropertyNames structure:

   public const string TaxPercentage = "TaxPercentage";

Then go to the SetPropertyValues() method, there you will find a large switch block (yes, yes, bad bad bad... I must refactor this sometime. ) and add the following line:

case PropertyNames.TaxPercentage:
   userEntity.TaxPercentage = (string)pv.PropertyValue;
   break;

, this is the code called when you store a property.

Then go to the GetPropertyValues() method, there also you will find a large switch block and add the following line:

case PropertyNames.TaxPercentage:
   pv.PropertyValue = userEntity.TaxPercentage;
   break;

Thats it, I will refactor this when I have some spare time, this is just too hard as it is at the moment.

Updated Wiki: Documentation

ihenriksen — Mon, 07 May 2012 09:03:10 GMT

Guides

Gettings started
Adding a new profile property

Tips

How to lower costs

Solution

Other

External resources

Updated Wiki: Adding a new profile property

ihenriksen — Mon, 07 May 2012 09:02:38 GMT

<add name="TaxPercentage" type="System.String" defaultValue="" />

, that takes care of the ASP.NET declerative part, now for our code.

First, open AzureTableStorage->UserEntity.cs and add the following line in the profile region:

public string TaxPercentage { get; set; }

   public const string TaxPercentage = "TaxPercentage";

Then go to the SetPropertyValues() method, there you will find a large switch block (yes, yes, bad bad bad... I must refactor this sometime. ) and add the following line:

case PropertyNames.TaxPercentage:
   userEntity.TaxPercentage = (string)pv.PropertyValue;
   break;

, this is the code called when you store a property.

Then go to the GetPropertyValues() method, there also you will find a large switch block and add the following line:

case PropertyNames.TaxPercentage:
   pv.PropertyValue = userEntity.TaxPercentage;
   break;

Thats it, I will refactor this when I have some spare time, this is just too hard as it is at the moment.

Updated Wiki: Documentation

ihenriksen — Tue, 31 Jan 2012 15:53:01 GMT

Guides

Gettings started

Tips

How to lower costs

Solution

Other

External resources

Updated Wiki: How to lower costs

ihenriksen — Tue, 31 Jan 2012 15:52:27 GMT

This is a small guide that may help you save money when using AzureProviders. In addition you should read guides on how to save costs in general on the Azure platform.

Checking for dead worker roles
The MultiThreadedWorkerRole project has one thread for each worker role, plus one "servant" thread that monitors if all the threads are ok, restarting them if they have died. This servant sleeps for CheckDeadThreadSleepInSeconds (in app.config) seconds between each time it checks if the worker role threads are dead. By default it checks every 4 seconds, which in most cases is overkill increasing this could save you computing cost.

Turning off session provider
If you are not using sessions, ie. your code does not use any session"something" code, then you can disable it by removing it from you web.config definition, this can save you computing-, and table storage transaction costs.

E-mail worker role
By default the e-mail worker role checks for new e-mails to send on the queue every 60 seconds, as specified in EmailWorkerMaxThreadSleepSeconds in the app.config file. In some cases letting the users wait more than a minute for an e-mail is just fine, increasing it could save you computing costs.

Session-state worker role
The session-state worker role has one task; to remove expired sessions from the table storage. By default it checks for expired sessions every 60 seconds, this is probably overkill in most cases. Increasing SessionStateWorkerMaxThreadSleepSeconds as defined in app.config may save you computing-, and table storage transaction costs.

Azure Diagnostics logging
(Only applicable for V1.7 or later) Azure Diagnostics logging is so transaction expensive that it should only be used in development, or for testing purposes, and should only be used in a production environment in very special scenarios. You can turn it off by removing its configuration from web.config and app.config plus removing the calling code from both WebRole.cs files.

Updated Wiki: WebPages project

ihenriksen — Fri, 14 Oct 2011 18:04:44 GMT

WebPages project

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

A Web page that a newly registered user needs to visit in order to sign in for the first time. An e-mail with a personal link to this page is sent after the user has registered by /Account/Register.aspx. The request parameter "Id" should contain the user id of the user that is to be activated, if not an error is displayed.

After the user has activated his account a confirmation e-mail is sent to the user.

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

A Web page that lets a user create a new account.

Note: After the user has registered an e-mail is sent with a link to /Account/ActivateAccount.aspx to activate the user account and to validate the e-mail address of the user. The domain here is by default www.myapp.com, change the domain to the correct value for your development, staging, or production environment.

/Account/ResetPassword.aspx

A Web page that lets the user reset his/her password if they have forgotten it. The user must answer the question he/she entered when he/she created the account.

The new automatically generated password is sent to the users e-mail address.

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

A Web page that shows the user profile. If the profile page belongs to the user that is viewing it the user can upload a picture and enter his/her gender. Here you can add/remove you own fields, the default fields are just there as an example.

The default portrait field scales the uploaded image to a thumbnail and stores the processed image in the Azure Blob Storage. The gender field is stored in the Azure Table Storage.

Querystring parameters

By default our own user profile page is displayed, if you want to see another users profile page then you can add the user name to the "name" querystring parameter, like this:

http://example.com/Account/User.aspx?name=Admin

The example above would show Admin's user profile page.

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

There is no harm in calling this page more than once.

History of InitApp.aspx

In earlier versions of AzureProviders this page was removed and the code moved to Global.asax or the Azure Role OnStart() method, but this attempt ultimately failed because of the context of the processes than ran them, and so the /Admin/InitApp.asp web page was re-implemented again.

If you have a better way of doing the initialization of AzureProviders then please let me know, but make sure that you have tested that it works in staging/production first and not just your development environment, like I mistakenly did.

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

Business logic for a custom ASP.NET Membership Provider that stores all its data in the Azure Table Storage.

Note: If you are only interested in the membership provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the membership provider deceleration from Web.config.

/Bll/AzureProfileProvider.cs

Business logic for a custom ASP.NET Profile Provider that stores all its data in the Azure Table and Blob Storage.

Note: If you are only interested in the profile provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the profile provider deceleration from Web.config.

/Bll/AzureRoleProvider.cs

Business logic for a custom ASP.NET Role Provider that stores all its data in the Azure Table Storage.

Note: If you are only interested in the role provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the role provider deceleration from Web.config.

/Bll/AzureSessionStateProvider.cs

Business logic for a custom ASP.NET Session-State Provider that stores all its data in the Azure Table Storage.

Note: If you are only interested in the session provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the session provider deceleration from Web.config.

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

By default ASP.NET only allows 2 concurrent client requests, this is really inefficient as your Azure server instances has capabilities of processing many more simultaneous asynchronous requests. Because of this AzureProviders accepts 48 concurrent client requests by default, but you should really try and find the setting that works best for your solution. See http://social.msdn.microsoft.com/Forums/en-US/windowsazuredata/thread/d84ba34b-b0e0-4961-a167-bbe7618beb83 for more information on the subject.

<configuration><system.net><settings>

By default ASP.NET uses the HTTP Expect 100-Continue pattern, which can be a performance issue if your HTTP operations are small, because of this AzureProviders has turned HTTP Expect 100-Continue off. See http://social.msdn.microsoft.com/Forums/en-US/windowsazuredata/thread/d84ba34b-b0e0-4961-a167-bbe7618beb83 for more information on the subject.

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 13:33:18 GMT

WebPages project

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

There is no harm in calling this page more than once.

History of InitApp.aspx

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

/Bll/AzureProfileProvider.cs

/Bll/AzureRoleProvider.cs

/Bll/AzureSessionStateProvider.cs

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

Updated Wiki: ThreadedRoleEntryPoint project

ihenriksen — Sun, 02 Oct 2011 13:31:10 GMT

ThreadedRoleEntryPoint project

ThreadedRoleEntryPoint is a class library project that works as the business logic for multi-threaded roles; i.e. the MultiThreadedWorkerRole project. If you create a standard Azure worker role only a single thread is in use, this is a huge waste of resources as the server instances that the worker roles run on have processors with many cores that are capable of processing many threads asynchronously, MultiThreadedWorkerRole worker role counters his by spawning one thread for each role.

Multi-threaded role

The MultiThreadedWorkerRole project's job is to spawn a new thread for each job that is done. If you create a standard Azure worker role only a single thread is in use, this is a huge waste of resources as the server instances that the worker roles run on have processors with many cores that are capable of processing many threads asynchronously, MultiThreadedWorkerRole worker role counters his by spawning one thread for each role.

See http://www.31a2ba2a-b718-11dc-8314-0800200c9a66.com/2010/12/running-multiple-threads-on-windows.html for information on how this multi-threaded worker role software design pattern works.

ThreadedRoleEntryPoint.cs

ThreadedRoleEntryPoint is an abstract class that works as a role entry point for multi-threaded worker roles. It has the following work assigned to it:

spawn a thread for each job,
monitor and restart dead threads.

The application setting CheckDeadThreadSleepInSeconds determines how often ThreadedRoleEntryPoint should check for dead threads, increasing this may save you Azure computing costs.

WorkerEntryPoint.cs

WorkerEntryPoint is an abstract class that contains the logic for the Back-Off design pattern.

Back-off pattern

Updated Wiki: MultiThreadedWorkerRole project

ihenriksen — Sun, 02 Oct 2011 13:30:41 GMT

MultiThreadedWorkerRole project

The MultiThreadedWorkerRole project is the worker role in the AzureProviders solution.

Multi-threaded role

Back-off pattern

The MultiThreadedWorkerRole project inherits a Back-Off design pattern from ThreadedWorkerRoleLib, this pattern causes the System.Threading.Thread.Sleep() to double after each time the job was unemployed. Since you pay per processing hour on Azure this design pattern saves you money.

Since some jobs are more important than others you can specify the maximum back-off time. As an example, sending an e-mail immediately may not be so important, the user gladly can wait a minute, but charging someone's credit card should happen immediately.

app.config

app.config is an application configuration file.

<configuration><appSettings>

Key/value's:

NumberOfSendEmailRetries; (default=3) Number of send an e-mail attempts before giving up
CheckDeadThreadSleepInSeconds; (default=4) Number of seconds to sleep after checking that all the worker role threads are up and running
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued
EmailWorkerMaxThreadSleepSeconds; (default=30) When using the Back Off pattern never let the e-mail worker thread sleep more than this number of seconds
SessionStateWorkerMaxThreadSleepSeconds; (default=60) When using the Back Off pattern never let the session-state worker thread sleep more than this number of seconds
ApplicationName; (default="MyApp1") Name of application, should match the one in the WebPages web.config

<configuration><system.net><mailSettings>

Contains the E-mail SMTP server settings. You must change this to your own e-mail server provider, if you do not have one the you can use SendGrid (http://sendgrid.com) which allows you to send up to 200 e-mails a day for free.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

EmailWorker.cs

The EmailWorker class listens to the Azure e-mail queue for e-mails that is to be sent. EmailWorker will try to send the e-mail as many times as specified in the application setting NumberOfSendEmailRetries before giving up.

Since EmailWorker inherits WorkerEntryPoint it will run in its own thread.

SMTP server

The SMTP settings is found in the mailSettings section of app.config.

MessageWorker.cs

The MessageWorker class is an example of how a minimal job is defined in AzureProviders. A job defined like this would run in its own thread.

Since MessageWorker inherits WorkerEntryPoint it will run in its own thread.

SessionStateWorker.cs

The SessionStateWorker class clears any expired ASP.NET Membership sessions from the SessionStateEntity table.

Since SessionStateWorker inherits WorkerEntryPoint it will run in its own thread.

WorkerRole.cs

The WorkerRole class is the entry point for the Azure infrastructure process, it initializes the role process.

The WorkerRole.GetWorkerRoles() method is where you define which jobs you want to run in the MultiThreadedWorkerRole worker role, by default the EmailWorker and SessionStateWorker jobds are defined here, you can add your own here. All jobds will run in their own thread, separate from the other roles in the MultiThreadedWorkerRole worker role. You can comment in MessageWorker to experiment with adding a new job.

WorkerRole inherits the abstract ThreadedWorkerRoleLib.ThreadedRoleEntryPoint which handles most of the logic for the job.

EmailWorkerMaxThreadSleepSeconds and SessionStateWorkerMaxThreadSleepSeconds settings in app.config sets the maximum time to thread sleep using the Back-Off pattern.

Updated Wiki: CrossCuttingConcerns project

ihenriksen — Sun, 02 Oct 2011 13:29:49 GMT

CrossCuttingConcerns project

New in V1.7.

The CrossCuttingConcerns project handles cross-cutting concerns like logging and diagnostics, this functionality is used by all the projects in the solution and by both roles, so the code does not belong anywhere else than in a separate project.

AzureDiagnostics.cs

The AzureDiagnostics class handles all kinds of logging and diagnostics from the Azure server instances to the Azure Table Storage and Blob Storage. By default a lot of logging and diagnostics is enabled, much more than you probably want after you go live, therefore you should alter your settings in here. Since this class is called "all over the place" we can not the settings in a application configuration file or in the role settings, all settings are therefore hard-coded in the class.

The AzureDiagnostics.EnableAzureDiagnostics() is what enables diagnostics for a Azure role, it is by default called from all the role OnStart() methods.

This video goes through all of the concepts that the AzureDiagnostics class handles:
http://www.microsoftpdc.com/2009/SVC15

Tables

These are the Azure Tables that are created by the AzureDiagnostics class:

WADDiagnosticsInfrastructureLogs is the Azure infrastructure log,
WADDirectoriesTable contains references to all the file-based logs that are stored in the Azure Blob Storage (the IIS logs),
WADLogsTable is the diagnostics logs (see System.Diagnostics.Trace for more information about trace logs),
WADPerformaceCountersTable is the log for your performance counters (by default only the processor percentage is tracked)
WADWindowsEventLogsTable contains the Windows Application and System logs by default.

Blob containers

By default the AzureDiagnostics class creates the wad-iis-logfiles Azure blob container, this blob contains all the IIS logfiles in the W3C Extended Log File Format.

Scheduled transfers

Scheduled transfers is how often you want your logs and diagnostics being uploaded to the Azure Table Storage and Blob Storage.

The AzureDiagnostics.SetDiagnositcManagerScheduledTransferPeriods() method sets how often the scheduled transfers should occur. Commenting out a line here will disable the logging or diagnostics of that type. By default all scheduled transfers are set to 5 minutes.

Crash dumps

By default full crash dumps are stored as a blob in the Azure Blob Storage.

Full crashdumps are not available in asp.net roles as the exception is always caught. The only exception here is when the role is starting, as that happens in another non-ASP.NET process

Performance counters

Performance counters are enabled by default by AzureProviders, the counters that are to be tracked is set in the AzureDiagnostics.AddPerformanceCounterMonitoring() method, by default only the processor percentage is tracked.

Microsoft.WindowsAzure.Diagnostics.PerformanceCounterConfiguration.CounterSpecifier is language specific, so if you run your developer environment in another language OS that an English one you may get into trouble. For a complete list of possible PerformanceCounterConfiguration.CounterSpecifier values for your OS language run "typeperf.exe /Q" in a console. By default the sample rate is every 15 seconds from the tracked performance counters, you may want to tweak this to get less log entries.

Windows Event logs

By default all Windows events to the Application and System logs are stored in the Azure Table Storage, you can change this in the _AzureDiagnostics.AddEventLoggingFromWindowsEventLog() method. Decide here what Windows event logs you are interested in seeing, you can also filter out events if you want to. The syntax is <channel>!XPath Query , see http://msdn.microsoft.com/en-us/library/dd996910(VS.85).aspx for more information.

Updated Wiki: AzureQueue project

ihenriksen — Sun, 02 Oct 2011 13:29:10 GMT

AzureQueue project

A data access layer (DAL) class library project that handles create, read, update, and delete (CRUD) operations on the Azure Queue.

The e-mail queue

By default a queue for processing e-mails is created by the AzureProviders solution. Whenever an e-mail is to e sent it is first placed in the e-mail queue to be processed asynchronously by the MultiThreadedWorkerRole role. This is very useful as the process sending the e-mail does not have to wait until the e-mail is sent before continuing its further processing

AzureQueueContext.cs file

The AzureQueueContext class is the context for the AzureQueueDataSource class. It holds information like

the name of the e-mail queue,
the cloud storage account in use,
the current cloud queue client.

Retry policy

The AzureQueueContext class also sets the number of retries before failing; by default an e-mail is attempted sent three times before being ignored. Application setting key QueueDequeueRetrySleepSeconds decides how many seconds the queue waits before retrying after a failed attempt.

Nagling

HTTP PUT requests smaller than 1460 bytes are inefficient with nagling turned on. The AzureProviders solution has turned nagling off by default, this setting is set in the UseNaglingWithQueue application setting key.

See http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for information about gained advantages by turning off nagling.

AzureQueueDataSource.cs file

The AzureQueueDataSource class is the data source against the Azure Queue.

E-mail serialization

AzureQueueDataSource also handles internal operations like serializing and de-serializing to and from JSON. The e-mails that are put in the e-mail queue is stored there as EmailEntity objects serialized as JSON.

Creating the e-mail queue

AzureQueueDataSource.CreateQueuesIfTheyDontExists() contains code that creates the e-mail queue, this is currently called from ~/Admin/InitApp.aspx. In early versions of AzureProviders this was done automatically, this was removed later since the overhead and expense was considered too much.

EmailEntity.cs file

The EmailEntity class is used for serializing and de-serializing e-mails as the e-mails are placed and retrieved from the e-mail queue.

Updated Wiki: AzureTableStorage project

ihenriksen — Sun, 02 Oct 2011 13:28:37 GMT

AzureTableStorage project

AzureTableStorage is a data access layer (DAL) class library that handles all create, read, update, and delete (CRUD) operations against the Azure Table Storage.

AzureTableStorageDataSource.cs

The AzureTableStorageDataSource class is the data source towards the Azure Table Storage as specified in the DataConnectionString role setting.

Nagling

HTTP PUT requests smaller than 1460 bytes are inefficient with nagling turned on. The AzureProviders solution has turned nagling off by default, this setting is set in the UseNaglingWithTable application setting key.

See http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for information about gained advantages by turning off nagling.

Tables

The AzureTableStorageDataSource class contains code that creates the Azure tables, this is currently called from ~/Admin/InitApp.aspx. In early versions of AzureProviders this was done automatically, this was removed later since the overhead and expense was considered too much.

These are the Azure tables that are created by default:

UserEntity contains ASP.NET Membership users,
RoleEntity contains ASP.NET Membership roles,
SessionStateEntity contains ASP.NET Membership sessions.

AzureTableStorageServiceContext.cs

The AzureTableStorageServiceContext class is the data context that is used with the Azure Table data source. It also contains the name of the Azure tables.

RoleEntity.cs

RoleEntity is a Microsoft.WindowsAzure.StorageClient.TableServiceEntity data entity class that is used to store ASP.NET Membership roles in the Azure Table Storage.

SessionStateEntity.cs

SessionStateEntity is a Microsoft.WindowsAzure.StorageClient.TableServiceEntity data entity class that is used to store ASP.NET Membership sessions in the Azure Table Storage.

UserEntity.cs

UserEntity is a Microsoft.WindowsAzure.StorageClient.TableServiceEntity data entity class that is used to store ASP.NET Membership users in the Azure Table Storage. Roles are stored in a comma seperated (CVS) string.

Updated Wiki: AzureQueue project

ihenriksen — Sun, 02 Oct 2011 13:27:45 GMT

AzureQueue project

A data access layer (DAL) class library project that handles create, read, update, and delete (CRUD) operations on the Azure Queue.

The e-mail queue

AzureQueueContext.cs file

The AzureQueueContext class is the context for the AzureQueueDataSource class. It holds information like

the name of the e-mail queue,
the cloud storage account in use,
the current cloud queue client.

Retry policy

Nagling

AzureQueueDataSource.cs file

The AzureQueueDataSource class is the data source against the Azure Queue.

E-mail serialization

Creating the e-mail queue

EmailEntity.cs file

The EmailEntity class is used for serializing and de-serializing e-mails as the e-mails are placed and retrieved from the e-mail queue.

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 10:02:41 GMT

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

There is no harm in calling this page more than once.

History of InitApp.aspx

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

/Bll/AzureProfileProvider.cs

/Bll/AzureRoleProvider.cs

/Bll/AzureSessionStateProvider.cs

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 08:59:49 GMT

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

There is no harm in calling this page more than once.

History of InitApp.aspx

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

/Bll/AzureProfileProvider.cs

/Bll/AzureRoleProvider.cs

/Bll/AzureSessionStateProvider.cs

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

~/About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 08:58:13 GMT

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

There is no harm in calling this page more than once.

History of InitApp.aspx

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

Business logic for a custom ASP.NET Membership Provider that stores all its data in the Azure Table Storage.

Note: If you are only interested in the membership provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the membership provider deceleration from Web.config **

/Bll/AzureProfileProvider.cs

Business logic for a custom ASP.NET Profile Provider that stores all its data in the Azure Table and Blob Storage.

Note: If you are only interested in the profile provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the profile provider deceleration from Web.config **

/Bll/AzureRoleProvider.cs

Business logic for a custom ASP.NET Role Provider that stores all its data in the Azure Table Storage.

Note: If you are only interested in the role provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the role provider deceleration from Web.config **

/Bll/AzureSessionStateProvider.cs

Business logic for a custom ASP.NET Session-State Provider that stores all its data in the Azure Table Storage.

Note: If you are only interested in the session provider code and not the rest of AzureProviders, then it is sufficient to copy this file and the session provider deceleration from Web.config **

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

~/About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 08:50:49 GMT

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

There is no harm in calling this page more than once.

History of InitApp.aspx

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

Business logic for a custom ASP.NET Membership Provider that stores all its data in the Azure Table Storage.

/Bll/AzureProfileProvider.cs

Business logic for a custom ASP.NET Profile Provider that stores all its data in the Azure Table and Blob Storage.

/Bll/AzureRoleProvider.cs

Business logic for a custom ASP.NET Role Provider that stores all its data in the Azure Table Storage.

/Bll/AzureSessionStateProvider.cs

Business logic for a custom ASP.NET Session-State Provider that stores all its data in the Azure Table Storage.

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

~/About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 08:44:19 GMT

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

There is no harm in calling this page more than once. In earlier versions of AzureProviders this page was removed and the code moved to Global.asax or the Azure Role OnStart() method, but this attempt ultimately failed because of the context of the processes than ran them, and so the /Admin/InitApp.asp web page was re-implemented again.

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

Business logic for a custom ASP.NET Membership Provider that stores all its data in the Azure Table Storage.

/Bll/AzureProfileProvider.cs

Business logic for a custom ASP.NET Profile Provider that stores all its data in the Azure Table and Blob Storage.

/Bll/AzureRoleProvider.cs

Business logic for a custom ASP.NET Role Provider that stores all its data in the Azure Table Storage.

/Bll/AzureSessionStateProvider.cs

Business logic for a custom ASP.NET Session-State Provider that stores all its data in the Azure Table Storage.

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

~/About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 08:27:45 GMT

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

Business logic for a custom ASP.NET Membership Provider that stores all its data in the Azure Table Storage.

/Bll/AzureProfileProvider.cs

Business logic for a custom ASP.NET Profile Provider that stores all its data in the Azure Table and Blob Storage.

/Bll/AzureRoleProvider.cs

Business logic for a custom ASP.NET Role Provider that stores all its data in the Azure Table Storage.

/Bll/AzureSessionStateProvider.cs

Business logic for a custom ASP.NET Session-State Provider that stores all its data in the Azure Table Storage.

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

~/About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.

<configuration><system.net><connectionManagement>

<configuration><system.net><settings>

Updated Wiki: WebPages project

ihenriksen — Sun, 02 Oct 2011 08:23:15 GMT

The WebPages project is the start-up ASP.NET web application.

/Account/ActivateAccount.aspx

/Account/ChangePassword.aspx

A Web page that allows a user to change his/her password.

A confirmation e-mail is sent to the user after the password has been changed.

/Account/Login.aspx

A Web page that allows the user to sign in using his/her username or e-mail address and password.

/Account/Logout.aspx

A Web page that signs the user out.

/Account/Register.aspx

A Web page that lets a user create a new account.

After the user has registered an e-mail is sent with a link to /Account/ActivateAccount.aspx to activate the user account and to validate the e-mail address of the user.

/Account/ResetPassword.aspx

/Account/UnlockAccount.aspx

A Web page that allows the user to unlock his/her user account in the case it has been locked out. After unlocking a confirmation is sent to the users e-mail address.

/Account/User.aspx

Querystring parameters

/Account/Web.config

Contain rules of which sub-pages are visible to which user roles.

/Admin/InitApp.aspx

A Web page that initializes the AzureProviders application. You need to visit this page once to create:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Admin/Roles.aspx

A Web page that lists all the ASP.NET Role Provider roles.

/Admin/Sessions.aspx

A Web page that lists all the active ASP.NET Session Provider sessions.

/Admin/Statistics.aspx

A Web page that shows the total number of registered users and the number of online users.

/Admin/Users.aspx

A Web page that lists all the ASP.NET Membership Provider users.

/Admin/Web.config

Contain rules of which sub-pages are visible to which user roles.

Email.resx

E-mail message resources like e-mail header and footer.

Profile.resx

Resources used by the ASP.NET Profile Provider.

/Bll/AzureMembershipProvider.cs

Business logic for a custom ASP.NET Membership Provider that stores all its data in the Azure Table Storage.

/Bll/AzureProfileProvider.cs

Business logic for a custom ASP.NET Profile Provider that stores all its data in the Azure Table and Blob Storage.

/Bll/AzureRoleProvider.cs

Business logic for a custom ASP.NET Role Provider that stores all its data in the Azure Table Storage.

/Bll/AzureSessionStateProvider.cs

Business logic for a custom ASP.NET Session-State Provider that stores all its data in the Azure Table Storage.

/Bll/GraphicUtilities.cs

Business logic that lets you create thumbnails and resize images.

/Bll/InitApplication.cs

Business logic that creates:

Azure tables
Azure queue
Azure blob storage
Admins role
Admin user & profile

/Ccc/EncryptionUtilities.cs

Business logic that makes a MD5 hash from a string.

/Images/

Image file folder.

/Scripts/

JavaScript file folder.

/Styles/

CSS file folder.

~/About.aspx

Some information about the AzureProviders solution.

Default.aspx

The start page. Demo's the ASP.NET Session-State Provider by showing when the user session was started.

Global.asax

Initializes the Azure Cloud Storage Account when the Web application starts.

Site.master

Master page.

Web.config

<configuration><appSettings>

Key/value's:

StaticKey; A static key is used instead of machiekey to encrypt passwords since machinekey changes when in development
fromEmail; (default="do-not-reply@example.com") This is the e-mail address that will be the sender on all the e-mails sent by this application
AdminName; (default="Admin") By default a administrator user is made and this is its sign in name
AdminEmail; (default="admin@example.com") By default a administrator user is made and this is its e-mail
AdminPassword; (default="Password") By default a administrator user is made and this is its password
AdminQuestion; (default="Color of my first car?") By default a administrator user is made and this is its password retrieval question
AdminAnswer; (default="Kiwi") By default a administrator user is made and this is its password retrieval answer
AdminRoleName; (default="Admins") By default a role is created to hold administrators and this is its name. Admin is added to this by default
ApplicationName; (default="MyApp1") The name of your application, should match the one in the MultiThreadedWorkerRole app.config
QueueDequeueRetrySleepSeconds; (default=3600) Number of seconds to wait before retrying if a message was dequeued in the Azure Queue
UseNaglingWithTable; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.
UseNaglingWithQueue; (default="false") PUT HTTP requests smaller than 1460 bytes are ineffecient with nagling turned on, see http://blogs.msdn.com/b/windowsazurestorage/archive/2010/06/25/nagle-s-algorithm-is-not-friendly-towards-small-requests.aspx for more information on the subject.

<configuration><system.web><authentication><forms>

Sets the ASP.NET login page to /Account/Login.aspx

<configuration><system.web><membership>

Settings for the custom ASP.NET Membership Provider.

<configuration><system.web><profile>

Settings for the custom ASP.NET Profile Provider.

<configuration><system.web><roleManager>

Settings for the custom ASP.NET Role Provider.

<configuration><system.web><sessionState>

Settings for the custom ASP.NET Session-State Provider.