Configuring Write-through Cache Provider

To preserve the cache data in some persistent storage, you can configure Write-through providers for a cache. By using the Write-through provider, the cached data and data added/updated/removed are synchronized with a data source.

Important

For .NET, before deploying your DLL files, ensure you have the appropriate .NET Version installed as discussed in the NCache Installation Guide.

Using the NCache Management Center for Write-through Cache

Launch the NCache Management Center by browsing to http://localhost:8251 or <server-ip>:8251 on Windows and Linux.
In the left navigation bar, click on Clustered Caches or Local Caches, based on the cache to which the query index will be added. Against the cache name, click on View Details.
Make sure that the cache is stopped.

Configure Read Through Web

This opens up the detailed configuration page for the cache. Go to the Advanced Settings tab and click on Backing Source in the left bar.
Check the Enable Write-through box. Choose to add a provider.

Configure Read Through Web

A new page will open up. Enter the Provider Name in the text box and then click on the "..." button to browse for assembly implementing the IWriteThruProvider interface. Select the class name from the drop-down list.
Select the required Write-through provider.

Configure Write-through Provider Name

You can also provide the values to your Write-through provider class if required. Specify the parameter name in the Parameter field and its value against it under the Value field.

Note

These parameters, along with their assigned values, are passed to the selected Write-through provider when it is initialized on cache start. Providing the parameters is optional.

Configure Write-through Parameters

Click OK.
The selected provider class will be listed in the Read-Through provider list in the Backing Source tab.

Write-through Providers List

Deploy the Write-through provider assembly along with its dependent assemblies if any. Click on the Deploy Backing Source Provider button at the bottom left of the Backing Source tab page. Browse for the required assemblies, select all of the required assemblies, and click Open.

Write-through Providers List

After applying all the changes click on Save Changes.

Using Command Line Tools

Configure Write-through

The Add BackingSource cmdlet enables users to configure backing source (Read-through, Write-through) providers for the specified cache.

This command configures Writer1 as the Write-through provider on demoCache.

Add-BackingSource -CacheName demoCache -AssemblyName C:\Downloads\Providers.dll -Class NCache.Sample.Providers.Writers.Writer1 -ProviderName writer1 -WriteThru

Remove Write-through

Remove BackingSource cmdlet removes the pre-configured backing source providers (read-through or Write-through) from the cache or a specified server.

The following command removes the pre-configured Write-through provider named Writer1 from the demoCache existing on server 20.200.20.39.

Remove-BackingSource -CacheName demoCache -ProviderName Writer1 –WriteThru –Server 20.200.20.39