Migration Procedure (from 4.1 to 4.2)
This section describes how to migrate from 4.1 to 4.2. When migrating from 4.1 to 4.2, your existing 4.1 data is preserved.
Every installation is unique, with many factors that affect migration. This procedure can be used as a checklist of relevant topics and basic migration tasks.
1. Download the BigMemory kit, and verify that you have the correct license keys for the version you are installing.
2. Prepare the new configuration files. Sample configuration files are located in the BigMemory kit in the config-samples/ directory. You can modify the sample files with specific information for your installation.
3. (Optional) If you have persistence enabled, you should make a backup of your data, as described in the Database Backup Utility section of the 4.1 BigMemory Max documentation.
4. Shut down the server array. A safe shutdown procedure is as follows.
a. Shut down the mirror servers using the stop-tc-server script.
b. Shut down the clients. A Terracotta client will shut down when you shut down your application.
c. Shut down the active servers using the stop-tc-server script.
5. Clear the servers by removing the old version of BigMemory from each installation directory.
6. Install the new BigMemory kit. You must upgrade all Terracotta clients and servers in the cluster to the same version before restarting the cluster.
7. Start the servers with their new configuration files.