Use the tpm update command to upgrade to the latest version.
tar zxf tungsten-clustering-5.4.0-48.tar.gzshell>
After unpacking the new software into the staging directory, the
tpm update command will read the
tungsten.ini configuration and install the new
software. All services will be stopped and the new services will be
The tpm update command may cause a brief outage while restarting the connectors. This will occur if you are upgrading to a new version You can avoid that with:
The connectors must be updated separately on each server by running:
As of software version 4.0.0, the tpm command will use connector graceful-stop 30 followed by connector start when upgrading versions. If that command fails then a regular connector stop is run. This behavior is also applied when using tools/tpm update --replace-release.
During the lifetime of the cluster, switches may happen and the current
master may well be a different node than what is reflected in the static
ini file in the
master= line. Normally, this difference
is ignored during and update or an upgrade.
However, if a customer has some kind of procedure (i.e. automation) which
hand-edits the ini configuration file
master= line at
some point, and such hand-edits do not reflect the current reality at the
time of the update/upgrade, an update/upgrade will fail and the cluster
may be left in an indeterminate state.
The best practice is to NOT change the
in the INI configuration file after installation.
There is still a window of opportunity for failure. The update will
continue, passing the
CurrentTopologyCheck test and
potentially leaving the cluster in an indeterminate state if the
master= option is set to a hostname that is not the
current master or the current host.