Procedure for Upgrading from 4.1/4.2 to 4.3

Edit online

About this task

This section describes how to upgrade from 4.1 or 4.2 to 4.3. When upgrading from 4.1 or 4.2 to 4.3, your existing 4.1/4.2 data is preserved.

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.

Procedure

  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 your current 4.1/4.2 BigMemory Max documentation. You can use the backup to restore the 4.1/4.2 data manually into your 4.3 installation, but note that your existing 4.1/4.2 data is preserved anyway during the 4.3 upgrade procedure. You can also use the backup in case you need to revert to your 4.1/4.2 installation at a later stage.
  4. Shut down the server array. A safe shutdown procedure is as follows.
    1. Shut down the mirror servers using the stop-tc-server script.
    2. Shut down the clients. A Terracotta client will shut down when you shut down your application.
    3. 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.