Synchronize Caches in Bridge

State transfer is a process in which you can synchronize the state of the source cache with the target cache via the Bridge (WAN Replication). It is used to resynchronize the target cache after events such as cache addition, node recovery, or temporary connectivity interruptions, ensuring data consistency between connected caches.

You can execute state transfer any time after the Bridge starts, to synchronize the selected caches either by using the NCache Management Center or PowerShell. This process helps prevent data drift, restores consistency after outages, and supports reliable replication by bringing the target cache back in sync with the source cache.

Important

This option is provided for the caches connected to the Bridge.

Using the NCache Management Center

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

  • In the left navigation bar, click on Bridges. It will open up a list of pre-existing Bridges. From the list, select the Bridge Name and go to View Details.

Important

Please ensure your Bridge is running.

NCache Management Center showing the selected Bridge with its details page open and the list of connected caches.

  • On the page opened with details, go to the Bridge Caches section and click on the Sync Caches button in the Bridge Caches section of the NCache Management Center, used to initiate state transfer. button. This button is only available if the Bridge is running.

NCache Management Center displaying the Sync Caches option for a running Bridge.

  • Specify the source and target caches for the state transfer and click on Start.

Dialog in NCache Management Center for selecting source and target caches and starting the Bridge state transfer.

  • You will be notified that the state transfer has been initiated.

Using PowerShell

The Start-BridgeStateTransfer command enables you to initiate a state transfer between the source and target caches.

  • The following command initiates a State Transfer from source cache defaultCache.WestCoast to target cache defaultCache.EastCoast for Bridge defaultBridge running on 20.200.20.11 using Port 9817.
Start-BridgeStateTransfer -Name defaultBridge -Server 20.200.20.11 `
                          -SourceCache defaultCache.WestCoast -TargetCache defaultCache.EastCoast `
                          -Port 9817
  • This command starts state transfer from defaultCache.US to defaultClusteredCache.US through defaultBridge on the specified server with mutual TLS (mTLS) enabled. It runs from a machine where NCache is not installed and uses C:\certs\client.pem to authenticate the machine running the cmdlet. The -TlsCertPassword parameter decrypts the certificate’s password-protected private key. Omit this parameter if the private key is not encrypted.
Start-BridgeStateTransfer -Name defaultBridge -Server 20.200.20.11 `
                          -SourceCache defaultCache.US -TargetCache defaultClusteredCache.US `
                          -TlsCertPath "C:\certs\client.pem" -TlsCertPassword "clientKeyPassword"
  • The following command initiates a State Transfer from source cache defaultCache.WestCoast to target cache defaultCache.EastCoast for Bridge defaultBridge running on 20.200.20.11 using security credentials.
Start-BridgeStateTransfer -Name defaultBridge -Server 20.200.20.11 `
                          -SourceCache defaultCache.WestCoast -TargetCache defaultCache.EastCoast `
                          -Credentials(Get-Credential john_smith)

See Also

Create Bridge
Configure Bridge Settings
Configure Conflict Resolver
Remove Cache from Bridge