Combo Setup

It doesn't take long to get Helix TeamHub up and running with Combo deployment.

You can either download Helix TeamHub packages and install them manually, or install Helix TeamHub using the Perforce package repositories (recommended).

Step 1: Before you begin

Confirm that you have met all of the prerequisites listed below before installing and configuring Helix TeamHub:

Step 2: Installing Packages

Install using repositories

Install the package itself as root (recommended). If you have downloaded the TeamHub package, see Manually install from a downloaded Helix TeamHub package.

RHEL and CentOS

  1. Configure the Perforce repository if you have not already done so, see Configure the Perforce repository.

  2. Run the following command to install the TeamHub package:

    sudo yum install hth

Ubuntu

  1. Configure the Perforce repository if you have not already done so, see Configure the Perforce repository.

  2. Run the following commands to install the TeamHub package:

    sudo apt-get update
    sudo apt-get install hth

Manually install from a downloaded Helix TeamHub package

If you have downloaded the TeamHub package, perform the following steps to install it.

RHEL and CentOS

  1. Run the following command to install the package where <version> is the TeamHubversion and <OS-Version> is the operating system version:

    rpm -ivh hth-<version>-stable.el<OS-Version>.x86_64.rpm

    For example, to install TeamHub 2020.1, run:

    • On RHEL/CentOS 7:

      rpm -ivh hth-2020.1-stable.el7.x86_64.rpm
    • On RHEL/CentOS 8:

      rpm -ivh hth-2020.1-stable.el8.x86_64.rpm

Ubuntu

  1. Run the following command to install the package:

    dpkg -i hth_<version>-stable~<distro>_amd64.deb

    where:

    • <version> is the TeamHub release you are installing, such as 2021.1.
    • <distro> is xenial, bionic, or focal.

    For example, to install TeamHub 2021.1 on focal, run:

    dpkg -i hth_2021.1-stable~focal_amd64.deb

Step 3: Configuring Helix TeamHub

Every installation, upgrade, or configuration change in Helix TeamHub will require the Helix TeamHub Control utility to reconfigure Helix TeamHub for changes to take effect. To enable all required services after installation, run the following command:

sudo hth-ctl reconfigure

Step 4: Bootstrapping

At this stage Helix TeamHub is installed and running, and can be accessed using hth as Company ID and admin as user ID and password (change them in company and user settings):

http://IP_ADDRESS_OF_YOUR_SERVER/login

However, the Helix TeamHub instance needs to have a valid license before accessing the dashboard. The license can be managed in Helix TeamHub Admin. See License for more information.

Helix TeamHub Admin can be used to further configure the instance (at minimum, configuring hostname and mail settings are recommended), see Bootstrapping Helix TeamHub for more information.

Enable MongoDB Authentication (Optional)

By default MongoDB listens only on localhost on Combo installations and does not use authentication. For added security, authentication can also be configured on Combo installations.

  1. Run the following command to create Helix TeamHub MongoDB admin and user credentials:

     sudo su - hth
     create_mongodb_users.sh
    
  2. Update Helix TeamHub Configuration file at /var/opt/hth/shared/hth.json with Helix TeamHub MongoDB user credentials:

     "backend": {
       ...
       "db_username": "Enter username of Helix TeamHub MongoDB user",
       "db_password": "Enter password of Helix TeamHub MongoDB user"
       ...
     }
     ...
     "mongodb": {
       ...
       "username": "Enter username of Helix TeamHub MongoDB user",
       "password": "Enter password of Helix TeamHub MongoDB user"
       ...
     }
    
  3. Finally, apply the changes by reconfiguring Helix TeamHub:

     sudo hth-ctl reconfigure