Add Cache Server Node

You can add a cache server node to the cluster at any time. After adding a server node to the cluster, you need to start that node so that it can join the cluster.

Note

This feature is also available in the NCache Community Edition.

Prerequisites

Make sure the NCache Service is running. If it is not, do the following:

In any Command Line Tool of your choice, enter the following command:

Start-Service -Name NCacheSvc

For .NET Core, ensure that you are running the NCache Service as an administrator. Here are the steps to do so:

  • Open the Services Window and look for NCache in the list.
  • Right click on NCacheSvc from the list and choose Properties.
  • Go to the Log On tab and click on the Browse button.
  • In the object name field, type Administrator and click on the Check Names button.
  • It will pick the appropriate Administrator, then click OK.
  • Now, set a Password and click OK.
  • Right click on the NCache Service and choose the Restart option. Now your service will start running as administrator.

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 a new page. It shows any existing local or clustered caches and additional details like Server and Server Platform.

  • Against the cache name, click on View Details.

Add Server Node Web

  • This opens up the detailed configuration page for the cache. The Server Nodes tab displays a list of IP statuses on the existing server nodes of the cache.

  • Click on the Add Client Node Button Web button and specify the server node's IP. Click on Add Client Node Button Web to add it to the cache. Upon which you will get a success notification.

Enter server node ip web

Note

You might get prompted with a dialog box upon these changes, asking whether to reload or overwrite the cache config file.

  • The newly added node is displayed in the Server Nodes list.
Note

You also have the option to download logs to monitor a specific server node.

Using Command Line Tools

The Add Node enables the users to add a new server node to the existing clustered cache on the specified server. This 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.

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

Manually Editing NCache Configuration

You can also manually edit the NCache configuration to add a server node to the cluster as explained below.

Important

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

  • To add a server node to a cache cluster, add a new <server-node> tag within the <servers> tag in config.ncconf of each of your cache servers. The following example adds a new node 20.200.20.39 to the cache named demoCache existing on server node 20.200.20.40:
<cache-deployment>
  ...
<servers>
  <server-node ip="20.200.20.40"/>
  <server-node ip="20.200.20.39"/>
</servers>
...
</cache-deployment>
Note

Repeat this step on all server nodes.

  • In client.ncconf of the server node from where the client is being executed, add the following information about the node under the <configuration> tag:
<cache id="democache" client-cache-id="" client-cache-syncmode="optimistic" skip-client-cache-if-unavailable="True" reconnect-client-cache-interval="10" default-readthru-provider="" default-writethru-provider="" load-balance="True" enable-client-logs="False" log-level="error">
  <server name="20.200.20.40"/>
  <server name="20.200.20.39"/>
</cache>
  • Once changes are made, start the cache, and restart the NCache Service for the changes to take effect.

See Also

Create a Cache
Remove Cache
Remove Server Node