Edit Cluster Configuration Settings (Windows Server AppFabric Caching)

  • Article

With the caching features of Windows Server AppFabric, you can edit the cluster configuration settings in XML. This topic provides an overview of the steps required to make those changes.

The cluster configuration settings specify how the cluster itself, the named caches, and the cache hosts will work. For more information about the cluster configuration settings that are available, see Cluster Configuration Settings (Windows Server AppFabric Caching).

Windows PowerShell offers the Export-CacheClusterConfig and Import-CacheClusterConfig commands for making cluster configuration changes in XML.

Using any of these commands requires that your cache cluster must be restarted for the changes to take effect. There are other ways of making named cache configuration changes. For more information, see Edit Cache Configuration Settings with Windows PowerShell (Windows Server AppFabric Caching).

Note

When using the Export-CacheClusterConfig and Import-CacheClusterConfig commands to change cluster configuration settings, adding or removing named caches and cache hosts by inserting or removing XML elements is not supported. To add or remove named caches or cache hosts, use the Windows PowerShell cache administration tool and the AppFabric Configuration Wizard. For more information about the Windows PowerShell cache administration commands, see Using Windows PowerShell to Manage Windows Server AppFabric Caching Features.

The following procedures assume that you have a running cache cluster.

To edit cluster configuration changes in XML

  1. From the Windows PowerShell-based cache administration tool, export the cluster configuration settings with the Export-CacheClusterConfig command. For more information about using Windows PowerShell, see Using Windows PowerShell to Manage Windows Server AppFabric Caching Features.

  2. Open the XML-based cluster configuration file that was exported in the previous step.

  3. Locate and edit the attributes of the cluster configuration settings that you would like to change. Adding or removing host or cache elements is not supported.

  4. Save the XML-based cluster configuration file that was edited.

  5. Stop the cache cluster if it is running with the Stop-CacheCluster. Note: This will flush all data out of the cache cluster.

  6. Use the Import-CacheClusterConfig command to import the XML-based cluster configuration file that was edited in step 3.

  7. Start the cache cluster with the Start-CacheCluster command for the new configuration settings to take effect.

See Also

Concepts

Set the Cluster Management Role and Lead Host Designations (Windows Server AppFabric Caching)
Edit Cache Configuration Settings with Windows PowerShell (Windows Server AppFabric Caching)
Windows Server AppFabric Caching Configuration Options
Windows Server AppFabric Caching Concepts
Configuring the Cache Cluster (Windows Server AppFabric Caching)
Using Configuration Methods (Windows Server AppFabric Caching)

Other Resources

Configuring the Cache Client with XML