BigMemory 4.3.10 | Upgrade and Migration Guide | Upgrading from 3.7 or 4.0 | Procedure for Upgrading from 3.7 or 4.0
 
Procedure for Upgrading from 3.7 or 4.0
Use this procedure to upgrade from 3.7 or 4.0 to another major/minor pair version (e.g., from 3.7 to 4.0 or from 4.0 to 4.1). The procedure is the same for both scenarios. Every installation is unique, with many factors that affect the upgrade procedure. This procedure can be used as a checklist of relevant topics and basic upgrade 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, in case you need to revert to your 3.7/4.0 installation at a later stage.
Note:
You cannot restore data from a 3.7 backup into a 4.x installation.
*For version 3.7, see the Database Backup Utility section of the 3.7 BigMemory Max documentation.
*For version 4.0, see the Live Backup of Distributed In-memory Data section of the 4.0 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, and by deleting the objectdb data that is saved in the server's data 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.