Upgrading using TPM

To upgrade an existing installation, the new distribution must be downloaded and unpacked, and the included tpm command used to update the installation. The upgrade process implies a small period of downtime for the replicator as the updated versions of the tools are restarted, but downtime is deliberately kept to a minimum, and the replicator should be in the same operational state once the upgrade has finished as it was when the upgrade was started.

warning

Before performing an upgrade, please ensure that you have checked the "Installation Prerequisites" and the appropriate Release Notes for the version you are upgrading, as software and system requirements may have changed between versions and releases.

The method for the upgrade process depends on whether you installed via the ini method or via the staging method

Upgrading an INI based Installation

1. On each host in your deployment, download the release package and place this in your staging directory, typically /opt/continuent/software.

2. Unpack the release package:

   shell> tar zxf tungsten-replicator-8.0.4-132.tar.gz

3. Change to the unpackaged directory:

   shell> cd tungsten-replicator-8.0.4-132

4. Run the validation process:

   shell> ./tools/tpm validate-update

   Note

   The validate process will check that prerequisites are in place and that tpm can safely upgrade the software. Any errors that are reported should be handled before proceding

5. Run the upgrade process:

   shell> ./tools/tpm update --replace-release

The update process should now be complete. The current version can be confirmed by using trepctl reset.

Upgrading a staging based installation

1. Download the release package and place this in the staging directory on your staging host, typically /opt/continuent/software.

   If you are unsure which host and directory this should be, execute the following on any host:

   shell> tpm query staging

   The output of this command will display the host and directory

2. Unpack the release package:

   shell> tar zxf tungsten-replicator-8.0.4-132.tar.gz

3. Change to the unpackaged directory:

   shell> cd tungsten-replicator-8.0.4-132

4. Fetch a copy of the existing configuration information:

   shell> ./tools/tpm fetch --hosts=host1,host2,autodetect --user=tungsten --directory=/opt/continuent

   Important

   You must use the version of tpm from within the staging directory (./tools/tpm) of the new release, not the tpm installed with the current release.

   The current configuration information will be retrieved to be used for the upgrade:

   shell> ./tools/tpm fetch --hosts=host1,host2 --directory=/opt/continuent --user=tungsten
   ..
   NOTE  >> Configuration loaded from host1,host2

5. Run the validation process:

   shell> ./tools/tpm validate-update

   Note

   The validate process will check that prerequisites are in place and that tpm can safely upgrade the software on all hosts. Any errors that are reported should be handled before proceding

6. Run the upgrade process:

   shell> ./tools/tpm update --replace-release

The update process should now be complete. The current version can be confirmed by using trepctl reset.