Cache Cluster Configuration Settings

Important

In case you want to update any cache settings please refer to the Update Cache Config section to follow the set of steps.

Cluster Port

Cluster ports are the ports at which NCache clusters start.

Specify port through config.ncconf file located at %NCHOME%\config. %NCHOME% is NCache install directory. In config.ncconf of EACH server specify the <cluster-port> in <cluster-settings> tag under the <cache-settings> section:

<cache-config>
  <cluster-settings ...>
    <cluster-connection-settings cluster-port="7806" ../>
  </cluster-settings>
</cache-config>

Port Range

Sets the port range for each node in the cluster. If the current port is unavailable, then the server will automatically pick the next available port.

Specify port range through config.ncconf file located at %NCHOME%\config. %NCHOME% is NCache install directory. Specify the port-range key in the <cluster-connection-settings> tag:

<cache-config>
  <cluster-settings ...>
    <cluster-connection-settings cluster-port="7806" port-range="1" ../>
  </cluster-settings>
</cache-config>

Operation TimeOut

Operation Timeout is the maximum time in seconds during which a clustered operation must be completed, otherwise the operation will fail. Default Timeout value is 60 seconds and cannot be less than that. Operation Timeout can be changed in the following way:

Specify operation timeout through config.ncconf file located at %NCHOME%\config. %NCHOME% is NCache install directory. In config.ncconf of EACH server specify the operation-timeout key in the <cluster-settings> tag:

<cache-config>
 <cache-settings ...>
     <cluster-settings operation-timeout="60sec">
      ...
     </cluster-settings>
 </cache-settings>
</cache-config>

Connection Retries

Nodes participating in a cluster are connected with each other through TCP connections which may break up due to network failure. These retries are about when a connection goes down then, cache node tries to establish connection with configured retries. This is done Connection Retries times. In other words, the value of Connection Retries specifies how many times the node should try to restore the connection.

Specify connection retries count through config.ncconf file located at %NCHOME%\config. %NCHOME% is NCache install directory.In config.ncconf of EACH server specify the connection-retries key in the <cluster-connection-settings> tag:

<cache-config>
  <cache-settings ...>
    <cluster-settings ...>
      <cluster-connection-settings connection-retries="2" ../>
    </cluster-settings>
    ...
  </cache-Settings>
</cache-config>

Retry Interval

Retry Interval specifies the time between two successive connection retries.

Specify retry interval through config.ncconf file located at %NCHOME%\config. %NCHOME% is NCache install directory. In config.ncconf of EACH server specify the connection-retry-interval key in the <cluster-connection-settings> tag:

<cache-config>
  <cache-settings ...>
    <cluster-settings ...>
      <cluster-connection-settings connection-retry-interval="2secs"../>
    </cluster-settings>
    ...
  </cache-Settings>
</cache-config>

Statistic Replication Interval

This option is available for clustered cache only. Statistics replication interval is the time interval in seconds after which a node sends its statistics to all other nodes in a cluster.

Specify statistic replication interval through config.ncconf file located at %NCHOME%\config. %NCHOME% is NCache install directory. In config.ncconf of EACH server specify the stats-repl-interval key in the <cluster-settings> tag:

 <cache-settings ...>
   <cache-topology topology="partitioned">
     <cluster-settings operation-timeout="60sec" stats-repl-interval="1sec">
      ...
     </cluster-settings>
   </cache-topology>
</cache-settings>