Upgrades

Perforce 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.

Before you upgrade

Perforce TeamHub uses MongoDB which is automatically upgraded during the Perforce TeamHub upgrade. However, MongoDB does not support skipping release versions when upgrading, so you must follow the Upgrade instructions in the Perforce TeamHub release notes. The correct order for upgrading Perforce TeamHub is:

  • Make sure you are using Perforce TeamHub 2025.2 before upgrading to 2025.3.

  • Make sure you are using Perforce TeamHub 2023.2 or later before upgrading to 2025.2.

  • Make sure you are using Perforce TeamHub 2023.1 before upgrading to 2023.2.

  • Make sure you are using Perforce TeamHub 2022.2 before upgrading to 2023.1.

  • Make sure you are using Perforce TeamHub 2022.1 before upgrading to 2022.2.

  • Make sure you are using Perforce TeamHub 2021.1 before upgrading to 2022.1.

  • Make sure you are using Perforce TeamHub 2019.3 or later before upgrading to 2021.1.

Upgrade Perforce TeamHub

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.

Standard

RHEL and CentOS upgrades

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

Ubuntu

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

Enterprise or HA

When updating the Enterprise or 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.

Perforce 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.elX.x86_64.rpm
sudo hth-ctl reconfigure

Ubuntu 

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

Perforce 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.elX.x86_64.rpm
sudo hth-ctl reconfigure

Ubuntu

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