Enterprise setup

Important

The following information only applies to manual Helix DAM deployment. Do not follow these steps if you are using the automated deployment.

Use the following instructions to install and configure Helix DAM for Enterprise deployment.

Note

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

Download the TeamHub Enterprise (hth-db and hth-web) packages specific to the host operating system from Perforce's package repositories.

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

Step 1: Before you begin

Confirm that you have met all of the following prerequisites before installing and configuring Helix DAM:

The hardware you are installing Helix DAM on must meet the Hardware requirements.
Your firewall must be configured to meet the Firewall requirements.
The computers you are installing Helix DAM on must have a supported Operating system requirements.
The computers you are installing Helix DAM on must have the Helix DAM dependencies installed. See Dependency requirements.
Installing from a repository only: The computers you are installing Helix DAM on must be configured for the Perforce repository. See Configuring the Perforce repository.
The system must meet the Helix authentication prerequisites.

Step 2: Installing Helix TeamHub DB

Install using repositories

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

RHEL and CentOS

Configure the Perforce repository if you have not already. See Configuring the Perforce repository.
Run the following command to install the TeamHub package:

sudo yum install hth-db

Ubuntu

Configure the Perforce repository if you have not already. See Configuring the Perforce repository.
Run the following commands to install the TeamHub package:
```
sudo apt-get update
sudo apt-get install hth-db
```

Manually install from a downloaded TeamHub package

Upload the hth-db package to the server designated for Database role, install the package itself as root:

RHEL and CentOS

rpm -ivh hth-db-X.X.X-stable.el7.x86_64.rpm

Ubuntu

dpkg -i hth-db_X.X.X_amd64.deb

Step 3: Configuring Helix TeamHub DB

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

sudo hth-ctl reconfigure

Step 4: Enabling Enterprise mode

For Helix DAM Web to communicate to TeamHub DB, configure MongoDB and Redis to accept authentication and remote connections.

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

sudo su - hth
create_mongodb_users.sh

Important

Remember the MongoDB credentials because they are also required to set up Helix DAM web servers.

Next, reconfigure TeamHub DB for Redis authentication. Open the TeamHub Configuration file at /var/opt/hth/shared/hth.json add the following lines to the JSON file and update credentials:

Note

The setting "is_cluster": true enables Enterprise mode.

{
  ... (snipped)
  "app" : {
    "is_cluster": true
  },
  ... (snipped)
  "redis": {
    "enable": true,
    "password": "Choose Redis password"
  },
  "mongodb": {
    "enable": true,
    "username": "Enter username of Helix TeamHub MongoDB user",
    "password": "Enter password of Helix TeamHub MongoDB user"
  },
  ... (snipped)
}

Use the TeamHub Control utility to reconfigure Helix DAM so the changes can take effect. Run the following command:

sudo hth-ctl reconfigure

Step 5: Installing Helix TeamHub and Helix DAM Web

Note

The computer you install the web components on must also meet the prerequisites. See Step 1: Before you begin.

Install using repositories

Install the package itself as root (recommended). If you downloaded the TeamHub package. See Manually install from a downloaded TeamHub package.

RHEL and CentOS

Configure the Perforce repository if you have not already. See Configuring the Perforce repository.
Run the following command to install the TeamHub package:

sudo yum install hth-web

Ubuntu

Configure the Perforce repository if you have not already. See Configuring the Perforce repository.
Run the following commands to install the TeamHub package:
```
sudo apt-get update
sudo apt-get install hth-web
```

Manually install from a downloaded TeamHub package

Upload the hth-web package to the server designated for Web application role, install the package itself as root.

RHEL and CentOS

rpm -ivh hth-web-X.X.X-stable.el7.x86_64.rpm

Ubuntu

dpkg -i hth-web_X.X.X_amd64.deb

Step 6: Connecting TeamHub and Helix DAM Web to TeamHub DB

Tip

To change the default Company ID, admin User ID, and password before completing installation, you must make the changes before you run the hth-ctl reconfigure control command for the first time. Otherwise, you can change the values after installation in company and user settings.

To change the default values now, run the following commands:

export HTH_INIT_COMPANY_NAME="<hth>"

export HTH_INIT_USERNAME="<admin>"

export HTH_INIT_PASSWORD="<password>"

<hth> is the Company ID, <admin> is the User ID, and <password> is the password.

Company ID and Username must be 2 - 100 characters and cannot contain spaces. Valid characters: A-Z, a-z, 0-9,-, _

Note: Do not reconfigure TeamHub and Helix DAM Web yet. First, 'Turn' the server into a cluster node, and add the TeamHub DB credentials for it to connect to the TeamHub databases. Open the TeamHub Configuration file at /var/opt/hth/shared/hth.json and add the following lines to the JSON file and update credentials and hosts:

{
  ... (snipped)
  "app" : {
    "is_cluster": true
  },
  ... (snipped)
  "backend": {
        "db_host": "Enter IP address or hostname of Helix TeamHub DB server",
        "db_port": "4002",
        "db_username": "Enter username of Helix TeamHub MongoDB user",
        "db_password": "Enter password of Helix TeamHub MongoDB user",
        "redis_host": "Enter IP address or hostname of Helix TeamHub DB server",
        "redis_password": "Enter Redis password chosen on Helix TeamHub DB server",
        "enable": true
  },
  ... (snipped)
}

Finally, apply the changes by reconfiguring Helix DAM Web:

sudo hth-ctl reconfigure

Next steps

After installation is complete, you must configure Helix DAM. See Configuring Helix DAM after manual deployment for details.