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.

Download the Helix TeamHub Combo package specific to the host operating system from Perforce's package repositories. After uploading the package to the server, install the dependencies and the package itself as root.

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

Step 1: Installing Packages

Install the dependencies and the package itself as root:

RHEL and CentOS

yum install python-devel gettext python-docutils pam-devel cronie postfix libidn libidn-devel bzip2
rpm -ivh hth-X.X.X-stable.el6.x86_64.rpm

Debian and Ubuntu

apt-get install python-dev python-docutils gettext sudo libpam0g-dev postfix libidn11 libidn11-dev cron bzip2
dpkg -i hth_X.X.X_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 Bootstrap 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
    
Updated on: 17 November 2017