Add Client to Cache

Cache clients are lightweight modules through which cache applications can connect to hosted cache servers. You can add local or remote client nodes to existing clustered cache(s) in NCache.

In order to get a more detailed explanation of cache clients, please see the Cache Client section.

Step 1: Add Cache Client to Cache

Using the NCache Management Center

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

Add Client Node Web

This opens up the detailed configuration page for the cache. The Client Nodes tab displays a list and status of any existing client nodes of the cache.
Click on the button and specify the client node IP. A success notification will be displayed.

Enter Client Node Ip Web

The newly added node is displayed in the Client Nodes list, with client cache status.

Using Command Line Tools

Add-ClientNode cmdlet enables the user to add one or more client nodes to existing clustered cache(s).

This command adds a client node 20.200.20.39 to a cache named demoClusteredCache already exists on server node 20.200.20.40.

For more properties of this command, you can refer to NCache Command Line Reference.

Add-ClientNode -CacheName demoClusteredCache -Server 20.200.20.40 -ClientNode 20.200.20.39

Important

If you have more than one IP address on a client machine, enter the IP address on which the NCache Service is running.

Step 2: Verify the Addition of Cache Client

You can quickly run a Test-Stress Tool that comes with NCache installation to verify that cache clients can make calls to cache servers. To start this test on the cache you just created, please execute Test-Stress in the Command Line:

Test-Stress -CacheName demoClusteredCache

This command starts making cache calls to the cache servers as Test-Stress simulates transactional load on the specified cache. You can monitor the cache performance using PerfMon counters in .NET and .NET Core for Windows.