Upgrades

Helix DAM is built on top of Helix TeamHub. To install Helix DAM, you use the Helix TeamHub packages.

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

Upgrading Helix DAM 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.

Upgrade Helix Search

Make sure the version of Helix Search you upgrade to is supported by the version of Helix DAM you are upgrading to, see Helix authentication prerequisites.

The Helix Search index structure changed to improve indexing speeds in Helix Search 2024.3. If you are upgrading from Helix Search 2024.2 or earlier, Helix Search will automatically migrate your index structure to the new one introduced in Helix Search 2024.3. While the migration is happening, the Elasticsearch Hosts service status will display In Progress on the Helix SearchService Status page, see View status. When the migration is complete, the Elasticsearch Hosts service status will change to Success. The time taken for the migration depends on the size of your index, it can be as short as a few minutes for a small index and hours for a larger index.

For Helix Search upgrade instructions, see Upgrading Helix Search in the Helix Core Search Documentation.

Upgrade Helix DAM

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

Ubuntu

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

Enterprise

When updating the Enterprise 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 and Helix DAM 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