Terracotta 10.7 | Terracotta Server Administration Guide | Backup, Restore and Data Migration | Data Migration of Ehcache data
 
Data Migration of Ehcache data
Note:
As noted above, data migration is currently not available for TCStore data.
Data migration can be performed to move Ehcache data to a new cluster without moving the platform data. Please note that only restartable caches contained in a restartable cache manager can be recovered. Since the data migration works at the data directory level, all the data of all restartable cache managers that use the same data directory will be recovered together.
How to perform an offline data migration
Follow the steps in the specified order to perform a migration of cluster data:
1. Shut down the source cluster and copy the contents of all ehcache directories from all required data directories of all active servers in the cluster. You can skip copying data directories containing restartable cache managers that you do not wish to migrate.
2. Start the target cluster (you can just start the active servers at this time) with the same number of stripes as the source cluster. Create the desired cache manager configuration using a client. The cluster URI (including the cluster tier manager name for the cache manager) can be different in the new cluster. If the name part of the URI is different, specify the old name as the restart identifier when using the cache manager configuration API, so that the system can map the data corresponding to a given cache manager correctly. If there are more than one cache managers under the same data directory, use the configuration API to create all the cache managers in the target cluster.
For related information, see the section Fast Restartability of the Ehcache API Developer Guide.
3. Shut down the target cluster and copy the data to the matching data directories. The data directory paths can be different on the target cluster, but must have sufficient space to contain the data being copied over.
4. Once the data is available in all the stripes, you can start the target cluster. It now loads all the cache data that was moved from the source cluster.