Upgrades

Warning

Helix TeamHub 2019.2 and earlier: You must upgrade to TeamHub 2019.3 and then upgrade that to the latest version of TeamHub. This extra step is required because MongoDB is automatically upgraded during the TeamHub upgrade and MongoDB does not support skipping release versions when upgrading.

Important

Helix TeamHub 2022.1 and earlier:

The app section of the /var/opt/hth/shared/hth.json configuration file has been updated in the Helix TeamHub 2022.2 release to better support deployments using HTTPS with load balancers.

The is_https configurable is new and the is_ssl configurable operation has been modified. When you upgrade from Helix TeamHub 2022.1 and earlier, Helix TeamHub will set the new is_https configurable value based on your existing is_ cluster and is_ssl settings.

Manually set the is_https value for the following deployment configurations:

Helix TeamHub in Cluster mode without SSL - set is_https to false.
Helix TeamHub in Cluster mode behind balancer without SSL - set is_https to false.
Helix TeamHub in Combo mode behind a load balancer with SSL offloaded to the load balancer - set is_https to true.

To check the HTTPS and SSL configuration options:

in the /var/opt/hth/shared/hth.json file, see Section: app.
in the Helix TeamHub UI, see HTTPS and SSL configuration.

Helix TeamHub is shipped as a native operating system package, like .rpm or .deb, which greatly simplifies upgrades.

Upgrading TeamHub is usually a zero-downtime operation and can be performed on a live system. Before upgrading, read the release notes for more information on any release specific upgrade instructions.

Download the TeamHub packages specific to the host operating system from Perforce's package repositories. After uploading the packages to the server, follow the commands below.

Alternatively, use the Perforce's package repositories directly to upgrade the packages instead of using the rpm -Uvh or dpkg -i commands below.

Combo

RHEL and CentOS upgrades

rpm -Uvh hth-X.X.X-stable.el8.x86_64.rpm
sudo hth-ctl reconfigure

Ubuntu

dpkg -i hth_X.X.X_amd64.deb
sudo hth-ctl reconfigure

Cluster or High Availability

When updating the Cluster or High Availability (HA) deployment type, the package install order (Web or DB) does not matter, as long as they are the same major version. Refer to the release notes for more information on the package install order.

Helix TeamHub DB

Upload the hth-db package to the server designated for Database role and update the package:

RHEL and CentOS

rpm -Uvh hth-db-X.X.X-stable.el8.x86_64.rpm
sudo hth-ctl reconfigure

Ubuntu

dpkg -i hth-db_X.X.X_amd64.deb
sudo hth-ctl reconfigure

Helix TeamHub Web

Upload the hth-web package to the server designated for Web application role and install the package:

RHEL and CentOS

rpm -Uvh hth-web-X.X.X-stable.el8.x86_64.rpm
sudo hth-ctl reconfigure

Ubuntu

dpkg -i hth-web_X.X.X_amd64.deb
sudo hth-ctl reconfigure