Create a Distributed Cache

This section will demonstrate how you can create a distributed cache through the NCache Management Center and the Command Line Interface.

Create a Distributed Cache Using the NCache Management Center

• 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. This opens up the Clustered Caches page at <server-ip>:8251/ClusteredCaches.

• To create a new Distributed Cache, click on New.

• The In-Memory Store screen appears. 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 the caching topology and any advanced cluster options like Operation timeout and Statistic replication interval. If you have selected the Partition-Replica Cache topology, you have to select a Replication Strategy, either Asynchronous or Synchronous. Click Next.

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

Warning

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

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

• If you want to enable encryption and compression, select the Enable Encryption and Enable Compression checkboxes. If enabled, set the Providers and Key for encryption and Threshold Size for compression. Click Next.

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

  • Eviction is enabled by default. You can configure the Eviction Policy accordingly. If you want to disable eviction, uncheck the checkbox Enable Eviction.

  • 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. The default is 15 seconds.

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

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

• Click Finish. The created cache will appear on the Clustered Caches page with the server nodes and their status. A success notification will be received in the notification panel.

Using Command Line Interface

You can also use PowerShell or Command Line Tools to manage distributed caches by using the NCache-supported Command Line Interface.

• Windows
• Linux

Create Cache

The 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 Partition-Replica topology of size 1024MB on node 20.200.20.40.

New-Cache -Name demoClusteredCache -Server 20.200.20.40 -Size 1024 -Topology PartitionReplica

Add Node to Cache

The Add-Node cmdlet enables the users to add a new server node to the existing clustered cache on the specified server. It also enables users to have multiple server nodes in a clustered cache.

This command adds a new node 20.200.20.39 to the cache named demoClusteredCache existing on server node 20.200.20.40, which already exists.

Add-Node -CacheName demoClusteredCache -ExistingServer 20.200.20.40 -NewServer 20.200.20.39

Start Cache

Once the cache is created, you need to start the clustered cache on all the server nodes so that operations can be performed on it. The Start-Cache cmdlet enables the user to start the registered cache and cache process on the specified nodes.

Perform this step on all server nodes.

Start-Cache -Name demoClusteredCache -Server 20.200.20.40

See Also

Add Local/Remote Clients
Monitor Caches
NCache Programmer's Guide
NCache Command Line Interface