Live Upgrade NCache Version

NCache allows Live Upgrading NCache 4.6 to 4.9 or NCache 4.4. to 4.6 with negligible data loss. Live Upgrade significantly reduces the delay in your services caused by an upgrade manually. Using Live Upgrade, you can replicate the data of your currently running cache to latest NCache cache using a Bridge in between while the caches continue to run.

The previous version cache is considered as the source cache, and latest NCache cache is considered as the target cache.

Since the data replication is asynchronous, all clients connected to the source cache get an impression that the operations are being performed on the source cache while a complete copy is being made to the target cache seamlessly. Meanwhile, the source cache configuration remains fully functional and unaffected by the upgrade.

In order to upgrade your cache:

Create a target cache with the same name and configuration as of the source cache. Please refer to the Creating Caches section for step by step illustration of the process.
From the Cache Explorer view, right click on the Bridges node and click Create New Bridge option. The rest of the process for creating bridge is the same as explained in Creating Clustered Bridge for WAN Replication.
To this bridge, you need to add running source cache as an active cache. Note that only one cache should be added.
On the bridge node, replace IP(s) of the target cache in servers-list key in bridge.ncconf under the <bridge-config>...<cache> tags:

<configuration>
  <bridge-config … >
      <cache … servers-list="20.200.20.38, 20.200.20.29" … />
   </bridge-config>
</configuration>

Important

Make sure the source and target caches are in running state before proceeding with this step.

Right click on the bridge name and select Start option in the right click context menu. State transfer will begin automatically.
You can monitor the Performance Counters for state transfer using the Statistics window:

When the state transfer counter is no longer published, it marks the end of the whole process and any connected clients should be stopped. Otherwise replication is continued.
In client.ncconf of each client node, change the IP address of source cache server(s) to the IP addresses of the target cache server(s).
Start the clients. By doing so, you are effectively rerouting your clients to the target cache. All future operations by the clients will now be performed on the latest NCache version.

Warning

There might still be negligible pending activity of the source cache taking place which was requested during the state transfer, like fetch operations. It is advisable to let these remaining operations replicate to the target cache completely so that data loss is avoided.

Check the counters for the bridge. Once the bridge has no data left in the queue or when the operations have been fully replicated, it is safe to:
- Stop the bridge.
- Remove the source cache from the bridge.

You have seamlessly live upgraded to latest NCache version without stopping the cache.

Live Upgrade NCache Version

Important

Warning

See Also