title: Connection Retries description: Tune NCache Connection Retries to control how many times a node retries TCP connections to other cluster nodes after network failure. Set via Management Center (Advanced Cluster Options) or config.ncconf (connection-retries). Helps tolerate temporary connection failures before the connection is considered permanently failed. Default: 2 retries. Ideal for unreliable networks or high-availability setups.

canonical: https://www.alachisoft.com/resources/docs/ncache/admin-guide/connection-retries.html

Connection Retries

Nodes participating in a cluster are connected with each other through TCP connections, which may break due to network failures or infrastructure issues. In such cases, a node attempts to re-establish connectivity by scanning the configured server list once per attempt. If no connection is restored, it waits for the configured Retry Interval and then repeats the scan until the configured retry limit is reached. Connection Retries specifies the maximum number of reconnection attempts before a node marks a connection as unavailable, helping prevent premature node isolation and improve cluster stability. These settings can be changed in the following ways.

Using the NCache Management Center

  • Launch the NCache Management Center by browsing to http://localhost:8251 or <server-ip>:8251.

  • In the left navigation bar, click on Clustered Caches.

  • Against the cache name, click on View Details.

NCache Management Center showing the list of caches with the "View Details" option highlighted for a running cache.

  • This opens up the detailed configuration page for the cache. Go to the Advanced Settings tab and click on Cluster Settings in the left bar.

  • Set the Connection Retries present in the Advanced Cluster Options section, as per your requirement.

Advanced Cluster Options in NCache Management Center displaying the Connection Retries setting under Cluster Settings.

  • Click on Save Changes at the bottom of the page to apply this configuration to the cache.

Manually Editing NCache Configuration

You can manually edit the NCache configuration file as explained below:

Important

Ensure the cache is stopped before making any configuration changes.

  • Specify the Connection Retries count through config.ncconf by specifying the connection-retries in the <cluster-connection-settings> tag:
<cluster-settings ...>
  <cluster-connection-settings cluster-port="7804" port-range="2" connection-retries="2" .../>
</cluster-settings>
  • Once the changes are made, restart the NCache Service, and then start the cache.”.

See Also

Ports
Operation Timeout
Statistic Replication Interval
Retry Interval