Helix TeamHub Administrator Guide (2019.3 Enterprise)

Combo Setup

It doesn't take long to get Helix TeamHub up and running with Combo deployment after the hardware, firewall and operating system prerequisites are met.

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

Step 1: Installing Packages

Install using repositories

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

Please configure postfix as Internet Site during setup.

RHEL and CentOS

  1. Run the following command to install the dependencies:

    yum install python-devel gettext python-docutils pam-devel cronie postfix libidn libidn-devel sudo mailx libgomp bzip2
    
  2. Add the Perforce packaging key to your RPM keyring:

    sudo rpm --import https://package.perforce.com/perforce.pubkey
  3. Add the Perforce repository to your YUM configuration by creating a file called /etc/yum.repos.d/perforce.repo with the following content, where <version> is either 6 for RHEL/CentOS 6 or 7 for RHEL 7/CentOS 7.

    [perforce]
    name=Perforce
    baseurl=http://package.perforce.com/yum/rhel/<version>/x86_64
    enabled=1
    gpgcheck=1

    For example, to install TeamHub on RHEL/CentOS 7, add:

    [perforce]
    name=Perforce
    baseurl=http://package.perforce.com/yum/rhel/7/x86_64
    enabled=1
    gpgcheck=1
  4. Run the following command to install the TeamHub package:

    sudo yum install hth

Ubuntu

  1. Run the following command to install the dependencies:

    apt-get install python-dev python-docutils gettext sudo libpam0g-dev postfix libidn11 libidn11-dev cron bzip2 mailutils libgomp1
    
  2. Add the Perforce packaging key to your APT keyring:

    wget -qO - https://package.perforce.com/perforce.pubkey | sudo apt-key add -
  3. Add the Perforce repository to your APT configuration by creating a file called /etc/apt/sources.list.d/perforce.list with the following line:

    deb http://package.perforce.com/apt/<os> <distro> release

    where:

    • <os> is ubuntu
    • <distro> is xenial

    For example, to install TeamHub on Ubuntu xenial, add:

    deb http://package.perforce.com/apt/ubuntu xenial release
  4. 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 dependencies:

    yum install python-devel gettext python-docutils pam-devel cronie postfix libidn libidn-devel sudo mailx libgomp bzip2
    
  2. Run the following command to install the package:

    rpm -ivh hth-<version>-stable.el6.x86_64.rpm

    For example, to install TeamHub 2018.2.3, run:

    • On RHEL/CentOS 6:

      rpm -ivh hth-2018.2.3-stable.el6.x86_64.rpm
    • On RHEL/CentOS 7:

      rpm -ivh hth-2018.2.3-stable.el7.x86_64.rpm

Ubuntu

  1. Run the following command to install the dependencies:

    apt-get install python-dev python-docutils gettext sudo libpam0g-dev postfix libidn11 libidn11-dev cron bzip2 mailutils libgomp1
  2. 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 2019.1.
    • <distro> is xenial.

    For example, to install TeamHub 2019.2, run:

    • On Ubuntu xenial:

      dpkg -i hth_2019.2-stable~xenial_amd64.deb

Step 2: 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 3: 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