Cluster Settings for Cache

Important

If you want to update cache settings, please refer to the Update Cache Config section.

Note

%NCHOME% is the NCache install directory.

Cluster Port

Cluster ports are the ports at which NCache clusters start. Specify port through config.ncconf file located at %NCHOME%\config. 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. Additionally, 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 conclude, or the operation will fail. The default Timeout value is 60 seconds. This is also the minimum value. Specify operation timeout through config.ncconf file located at %NCHOME%\config. In the config.ncconf configuration of EACH server specifies 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 connect through TCP connections, which may break up due to network failure. These retries are about when a connection goes down, and the cache node tries to establish a connection with configured retries. 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. In config.ncconf configuration of EACH server specifies 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. 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. In config.ncconf of EACH server specify the stats-repl-interval key in the <cluster-settings> tag:

 <cache-settings ...>
   <cache-topology topology="mirrored">
     <cluster-settings operation-timeout="60sec" stats-repl-interval="1sec"
     use-heart-beat="True">
      ...
     </cluster-settings>
   </cache-topology>
</cache-settings>

See Also

General Cache Settings
Error Logging
Eviction Policy