The tpm update command is used when applying configuration changes or upgrading to a new version. The process is designed to be simple and maintain availability of all services. The actual process will be performed as described in Section 10.2, “Processing Installs and Upgrades”. The behavior of tpm update is dependent on two factors.
Are you upgrading to a new version or applying configuration changes to the current version?
The installation method used during deployment.
Check the output of tpm query staging to determine
which method your current installation uses. The output for an
installation from a staging directory will start with
# Installed from
An installation based on an INI file may include this line but there
will be an
/etc/tungsten/tungsten.ini file on each
Upgrading to a new version
If a staging directory was used; see Section 10.3.6, “Upgrades from a Staging Directory”.
If an INI file was used; see Section 10.4.3, “Upgrades with an INI File”
Applying configuration changes to the current version
If a staging directory was used; see Section 10.3.7, “Configuration Changes from a Staging Directory”.
If an INI file was used; see Section 10.4.4, “Configuration Changes with an INI file”.
During the update process, the cluster will be in
This is intentional to prevent unwanted failovers during the proces, however it is
important to understand that should the primary faill for genuine reasons NOT
associated with the upgrade, then failover will also not happen at that time.
It is important to ensure clusters are returned to the
as soon as all Maintenance operations are complete and the cluster is stable.
Special Considerations for the Connector
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.
The tpm command will use connector reconfigure when changing connector settings without a version upgrade.
The use of connector reconfigure is disabled for the following:
--application-port --application-readonly-port --router-gateway-port --router-jmx-port --conn-java-mem-size
If connector reconfigure can't be used, connector graceful-stop 30 and connector start are used.