Performance Comparison Between Reading from Disk vs. AppFabric Cache
This sample shows that it is more efficient to store and read from the AppFabric cache than from disk.
The sample reads a number of image files to simulate user requests to access the files from the disk or from the cache, and compares the time taken to serve the image files.
Note
Samples are provided for educational purposes only. They are not intended to be used in a production environment and have not been tested in a production environment. Microsoft does not provide technical support for these samples.
Prerequisites
Ideally, users should have knowledge of Windows PowerShell scripting.
The sample assumes the following:
Windows PowerShell 2.0 is installed.
Microsoft AppFabric 1.1 for Windows Server is installed. (This also adds the required DLLs to the GAC.)
Configure the AppFabric Cache
If you have not done so already, configure the AppFabric cache by using the Microsoft AppFabric 1.1 for Windows Server configuration tool (use default settings). The sample assumes that an AppFabric cache is configured with default settings (cacheHostName=AppFabricCachingService and cacheName=default).
Start the Cache Cluster
Open a Windows PowerShell command window in elevated mode and run the following command to add the Distributed Cache administration module:
Import-Module DistributedCacheAdministration
Run the following command to grant your user account access to the cache cluster as a client. Supply your user and domain name.
Grant-CacheAllowedClientAccount domain\username
Use Get-CacheAllowedClientAccounts command to verify your user account has been granted access.
Start the cluster by using Start-CacheCluster command.
Build and Run This Sample
The sample automatically links to the AppFabric Cache DLLs (Microsoft.ApplicationServer.Caching.Client.dll and Microsoft.ApplicationServer.Caching.Core.dll) from the GAC.
Open the DiskVersusCachePerformance.sln solution in Visual Studio.
Open a command prompt and change directory to : <Location of the sample>\CacheVersusDiskPerformance\DiskVersusCachePerformance\bin\Debug
This sample needs to be passed one command-line parameter: the path to the fileshare directory, part of the DiskVersusCachePerformance folder. (You can also add this to the project properties, in the section “command line arguments”).
Run the exe to start the sample test:
<Location of the sample>\CacheVersusDiskPerformance\DiskVersusCachePerformance\bin\Debug> DiskVersusCachePerformance.exe ..\..\..\fileshare
The actions performed by the sample are described in the useractions.xml file in the fileshare folder. The following actions are supported.
Action | Parameter(s) | Description |
---|---|---|
PageSize |
Size |
Set the page size (number of files to read) |
LogIn |
UserName |
Log in the user |
LogOut |
UserName |
Log out the user |
ViewAlbum |
AlbumIndex |
Move to folder “album[Index]” |
ViewPage |
PageIndex |
Read files [PageIndex*PageSize - PageIndex*(PageSize+1)-1] |
ViewNextPage |
N/A |
Move to next set of files [(PageIndex+1)*PageSize - PageIndex*(PageSize+2)-1] |
ViewPrevPage |
N/A |
Move to previous set of files |
A sequence of actions can be defined as follows.
<useraction> <action>PageSize</action> <data>500</data> </useraction>
<useraction> <action>LogIn</action> <data>tom</data> </useraction>
<useraction> <action>ViewAlbum</action> <data>0</data> </useraction>
<useraction> <action>ViewPage</action> <data>0</data> </useraction>
<useraction> <action>ViewNextPage</action> <data>null</data> </useraction>
<useraction> <action>ViewPrevPage</action> <data>null</data> </useraction>
<useraction> <action>LogOut</action> <data>tom</data> </useraction>
The preceding segment is interpreted as:
Set number of items per page as 500
Log in tom (allows the logged-on user to access the page)
Select album0
View first page (read files 0-499 from the disk or cache)
View next page (try to read files 500-999 from disk)
View previous page (re-read files 0-499 from the cache now that files are loaded to the cache)
Log out (revert permission granted)
At each logout, the sample reports a performance comparison of accessing the files from the disk versus from the AppFabric cache.
Note
For each subsequent run of this sample, use the Restart-CacheCluster
command to clear the cache, and wait for 10-15 seconds.
Note
During the sample run you may encounter messages such as [size2_il.cur-DiskRead- error 2 Delay (ticks) 7128]. The error shows the difference between file size reported by FileInfo and the actual size of the file read from the disk. This difference can be ignored because data stored in the cache is the same size as data read from the disk.
Troubleshooting
If data is not getting added into the cache, it could be that the cache’s eviction policy is getting in the way. To ensure that the cache does not have any eviction policy set, please run the following commands to remove the default cache and recreate it with no eviction policy:
Remove-Cache -CacheName default
New-Cache -CacheName default -Eviction None
Remove This Sample
Restart the cache cluster by using the Restart-CacheCluster command to clean up data from the cache.
See Also
Other Resources
Samples (AppFabric 1.1 Caching)
2012-09-12