Bridge Server Settings

This section explains various Bridge server configurations required to set up and optimize WAN Replication in NCache. All Bridge-related settings are defined in the Bridge Service configuration file. Any modification to this file must be done manually, followed by a service restart for the changes to take effect.

.NET Windows: Alachisoft.NCache.BridgeService.exe.config placed at %NCHOME%\bin\service.
.NET Core Windows: Alachisoft.NCache.BridgeService.dll.config placed at %NCHOME%\bin\service.
.NET Linux: Alachisoft.NCache.BridgeDaemon.dll.config placed at /opt/ncache/bin/service.

Bind to Multiple Network Interface Cards

If your server has multiple Network Interface Cards (NICs), you can bind the Bridge Server to a specific IP address using the following configuration key :

<add key="NBridgeServer.BindToIP" value="20.200.20.40"/>`

This setting specifies the IP address used by the Bridge Server for client connections. It is particularly useful in multi-homed servers to control and isolate network traffic.

Configure Server Ports

You can configure the Bridge Server ports for client communication and management operations as described below:

Client/Server TCP Port

This port defines the endpoint on which the Bridge Server listens for incoming connection requests from source and target caches. The Port tag specifies the port on which the Bridge Service listens for incoming client connections. The default port value is 9900.

<add key="NBridgeServer.Port" value="9900"/>`

Management Port

The ManagementPort tag specifies the port on which the Bridge Management Server listens for incoming management and monitoring connections. The default port value is 8260.

<add key="NBridgeServer.ManagementPort" value="8260"/>`

Configure Memory Settings

You can configure socket buffer sizes to optimize Bridge Server performance.

Send Buffer Size

This tag specifies the send buffer size (in bytes) used by the Bridge Server socket when sending data to clients. The default value is 131072 bytes (128 KB).

<add key="NBridgeServer.SendBufferSize" value="131072" />

Receive Buffer Size

This tag specifies the receive buffer size (in bytes) used by the Bridge Server socket for incoming data. The default value is 131072 bytes (128 KB).

<add key="NBridgeServer.ReceiveBufferSize" value="131072" />

Configure Windows Event Logging

This tag defines the minimum threshold size (in MBs) of the Bridge queue required to continue receiving operations from the Bridge cache. The default value is 30 MB. If the Bridge queue reaches its maximum capacity, replication from caches stops and a warning message is logged in the system event log.

<add key="NBridgeServer.BridgeSizeThreshold" value="20"/>

You can comment this tag if you do not want to log any warning messages.

State Transfer Timeout

This tag specifies the timeout interval (in seconds) for resetting the state transfer from the source cache to the target cache during a State Transfer operation. This setting is particularly useful when a previous transfer could not complete due to the unavailability of the source cache. The default value is 20 seconds, with a minimum of 3 seconds and a maximum of 60 seconds.

<add key="NBridgeServer.BridgeCacheStateTransferTimeout" value="20"/>

Note

Restart the Bridge Service after making any changes to the Bridge Service file.

Operation Failure Retries

The BridgeOperationFailureRetries tag defines the number of retry attempts made by the cache to resend an operation to the Bridge in case of a failure. The default value is 3 retries. You can increase or decrease this number based on network stability or operational needs.

<add key="NCacheServer.BridgeOperationFailureRetries" value="3"/>

Bulk Threshold Size

The BridgeBulkOperationSize tag specifies the batch size (in KB) used for sending operations from the cache to the Bridge. The default value is 500 KB. Increasing this size can improve throughput but may lead to higher memory usage.

<add key="NCacheServer.BridgeBulkOperationSize" value="500"/>

Replication Interval

This tag defines the delay interval (in milliseconds) between two consecutive bulk operations from the cache to the Bridge. The default value is 3000 milliseconds (3 seconds). Adjust this setting to control the replication frequency and maintain an optimal balance between performance and data consistency.

<add key="NCacheServer.BridgeReplicationInterval" value="3000"/>