Create a Distributed Cache

This section will demonstrate how you can create a distributed cache through the Web Manager and PowerShell in NCache Professional.

Clustered Cache

A cache cluster is a set of interconnected server nodes forming a cluster of servers that behave as a single cache unit from the outside. Here is how you can create a clustered Distributed cache.

Using NCache Web Manager

  • Launch NCache Web Manager by browsing to http://localhost:8251 or <server-ip>:8251 on Windows and Linux.

  • In the left navigation bar, click on Clustered Caches. This opens up the Clustered Caches page at <server-ip>:8251/ClusteredCaches/.

  • To create a new clustered cache, click on New.

Create Distributed Cache Web

  • From the In-Memory Store Type dropdown menu, select Distributed Cache and specify the name of your cache. Select JSON or Binary from the Serialization dropdown menu as per your requirement. Click Next.

Select serialization format web

  • Select the caching topology and any advanced options like Operation Timeout and Statistic Replication Interval. Click Next.

Select Caching Topology Web

  • Specify Maximum Size of the cache, if required. You can also add cache nodes to the cluster by specifying the node IP address and clicking on Add Node button. To add more nodes, click Add Node button. Click Next once all the required nodes are added.
Warning

If a node is already registered on that cache, notification is prompted.

Select Replication Strategy Web

  • Change the Cluster Port and Port Range if required. Click Next.

Cache Size Clustered Cache Web

  • In Advanced Options page, you can configure the following settings:

    • You can change the Default Priority of eviction from the dropdown list.

    • You can change the Eviction Percentage; items will be evicted from the cache using this percentage value if eviction is enabled.

    • You can change the Clean Interval value. Default is 15 seconds.

    • This cache can be started automatically upon the completion of this process if you have checked the Start this cache on Finish checkbox on this dialog box.

    • You can make the cache start itself automatically after service restart by checking the checkbox Auto start this cache on service startup.

Select Eviction Clustered Cache Web

  • Click Finish. Created cache will appear in Clustered Caches page with the server nodes and their status and a success notification will be received in the notification panel.

Distributed Cache Web

Using PowerShell

New-Cache cmdlet enables the user to create a new cache on one or more server nodes.

This command creates a distributed cache named demoClusteredCache of Partitioned topology of size 1024MB on node 20.200.20.40. You can explicitly specify InMemoryStoreType as DistributedCache. If InMemoryStoreType is not specified, the command will create a distributed cache since it is the default option.

New-Cache demoClusteredCache -Server 20.200.20.40 -Size 1024 -Topology Partitioned

Local Cache

A local cache can be created in the following ways

Using NCache Web Manager

  • Launch NCache Web Manager by browsing to http://localhost:8251 or <server-ip>:8251 on Windows and Linux.

  • In the left navigation bar, click on Local Caches. This opens up the Local Caches page at <server-ip>:8251/LocalCaches/. The page shows any existing local caches on your machine and additional details like Server and Server Platform.

  • To create a new local cache, click on New.

Create New Local Cache Web

  • Specify the Server Node IP / Name and click Next.

Enter Server IP Web

  • Specify the In-Memory Store Type as Local Cache from the dropdown menu. Afterwards, specify the Name, Isolation Level, and Serialization (Binary or JSON) of your cache. Click Next.
Warning

If a cache already exists against the Name specified, you are prompted with an error message.

Note

It is recommended that you use JSON serialization if you are using ASP.NET 5.0 and above. For more details click here.

Specify Cache Name Web

  • Change the cache size if required and click Next.

Specify Cache Size Web

  • In Advanced Options page, you can configure the following settings:

    • You can change the Default Priority of eviction from the dropdown list.

    • You can also change the Eviction percentage; items will be evicted from the cache using this percentage value if eviction is enabled.

    • You can change the Clean interval value. Default is 15 seconds.

    • This cache can be started automatically upon the completion of this process if you have checked the Start this cache on Finish checkbox on this dialog box.

    • You can make the cache to start automatically after service restart by checking the checkbox Auto start this cache on service startup.

Advanced Options Web

  • Click Finish. The created cache will appear on the Local Caches page, and a success notification will be received in the notification panel.

Local Cache Started

Using PowerShell

New-Cache cmdlet enables the user to create a new cache on one or more server nodes.

This command creates a cache called myCache of Local topology with Size of 1024MB on the node 20.200.20.39

Note

By default, NCache will create a cache with InMemoryStoreType of Local Cache if you don't specify this option explicitly.

New-Cache myCache -Topology Local -Server 20.200.20.39 -Size 1024

See Also

Start Cache
Remove Cache
Add Server Node