AppFabric 1.1 Caching: The cache size configuration should reflect the actual number of cache hosts in the cluster
This topic is intended to address a specific issue identified by a Best Practices Analyzer scan. You should apply the information in this topic only to computers that have had the AppFabric 1.1 Caching Best Practices Analyzer run against them and are experiencing the issue addressed by this topic. For more information about best practices and scans, see Best Practices Analyzer.
Operating System |
Windows Server 2008 R2 |
Product/Feature |
Microsoft AppFabric 1.1 for Windows Server Caching |
Severity |
Error |
Category |
Configuration |
Issue
The current cache size configuration is not recommended for the number of cache hosts in the cluster.
Impact
Cache operation can be negatively impacted due to this misconfiguration.
Resolution
Add or remove cache hosts, or modify the cache size configuration using the following guidelines
Number of cache hosts | Recommended size setting |
---|---|
1-5 |
"Small" |
6-10 |
"Medium" |
> 10 |
"Large" |
If you choose to change the cache cluster size setting, use the following steps.
Open a Windows PowerShell command prompt.
Use the Stop-CacheCluster command to stop the cache cluster.
Record the names and settings of all named caches. Then remove them with the Remove-Cache command.
Use the Export-CacheClusterConfig command to export the cache cluster settings to an XML file.
Open the exported settings file and locate the dataCache element. Change the size attribute to
"Small"
,"Medium"
, or"Large"
.Save the changes to the cache cluster settings file, and close it.
Import these changes back into the cache cluster with the Import-CacheClusterConfig command.
Recreate the named caches with the New-Cache command.
Start the cache cluster with the Start-CacheCluster command.
Additional references
Cluster Configuration Settings
Edit Cluster Configuration Settings
Cache Administration with Windows PowerShell (AppFabric 1.1)
2012-09-12