Add Client Node

Using NCache Manager

Each clustered cache tree in Cache Explorer contains a node known as Client Nodes. Any number of client nodes can be added in a clustered cache.

• Right click on Client Nodes in Cache Explorer for a cache and then click on the Add Node option.

• Provide the client machine name/IP by expanding Network Neighborhood or you can manually enter client node name/IP in text box.

Important

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

• Click on the Finish button, newly added client node appears under Client Nodes in Cache Explorer tree view.

Note

You might get prompted with a dialog box upon these changes, asking whether to reload or overwrite the cache config file. For more detail maintaining data integrity, refer to this chapter.

Using Windows PowerShell

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.21.144 to a cache named demoClusteredCache already existing on server node 20.200.21.95.

Add-Clientnode demoClusteredCache -Server 20.200.21.95 -ClientNode 20.200.21.144

The following command adds a Client node 20.200.21.144 to a cache named demoClusteredCache which already exists on server node 20.200.21.95 with port number 8251 which is not the default port number.

Add-ClientNode -CacheName demoClusteredCache -Server 20.200.21.95 -ClientNode 20.200.21.144 -Port 8251

Manually Editing NCache Configuration

Important

Make sure the cache is stopped before making any configuration changes.

Cache Server

• To add a client node to cache server, add the following tag within the <cache-deployment> tag in config.ncconf of EACH your cache server:

<cache-deployment>
...
<client-nodes>
  <client-node ip="20.200.21.144"/>
</client-nodes>
...
</cache-deployment>

Note

Repeat this step for all server nodes.

• In client.ncconf of each server, add the following information about the client nodes under the <configuration> tag:

<cache id="demoClusteredCache" load-balance="True" enable-client-logs="False" log-level="error">
  <server name="20.200.21.144"/>
</cache>

Note

Repeat this step for all server nodes.

• Once changes are made, start the cache and restart NCache service.

Remote Client Node

In client.ncconf of the client node, add the following information under the configuration tag:

<cache id="demoClusteredCache" load-balance="True" enable-client-logs="False" log-level="error">
  <server name="20.200.21.144"/>
</cache>

Note

Repeat this step for all client nodes.

See Also

Remove Client Node
Configure Client Cache
Configure Caches
Management Operations