Enterprise setup

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

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

Install P4 DAM using the P4 DAM packages.

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

Alternatively, download the P4 DAM Enterprise (p4dam-db and p4dam-web) packages specific to the host operating system from Perforce's package repositories.

On this page:

Step 1: Before you begin

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

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

Step 2: Install P4 DAM DB

Install using repositories

Install the package itself as root. If you have downloaded the P4 DAM package, see Install manually from a downloaded P4 DAM package.

RHEL and CentOS

Configure the Perforce repository if you have not already. See Configure the Perforce repository.
Run the following command to install the P4 DAM package:
sudo yum install p4dam-db

Ubuntu

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

Install manually from a downloaded P4 DAM package

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

RHEL and CentOS

rpm -ivh p4dam-db-X.X.X-stable.elX.x86_64.rpm

Ubuntu

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

Step 3: Configure P4 DAM DB

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

sudo hth-ctl reconfigure

Step 4: Enable Enterprise mode

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

Run the following command to create P4 DAM MongoDB administrator and user credentials:

sudo su - p4dam
create_mongodb_users.sh

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

Next, reconfigure P4 DAM DB for Redis authentication. Open the P4 DAM configuration file at /var/opt/hth/shared/hth.json, add the following lines to the JSON file, and update the credentials. 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 P4 DAM  MongoDB user",
    "password": "Enter password of P4 DAM  MongoDB user"
  },
  ... (snipped)
}

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

sudo hth-ctl reconfigure

Step 5: Install P4 DAM Web

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. If you have downloaded the P4 DAM package. See Install manually from a downloaded P4 DAM package.

RHEL and CentOS

Configure the Perforce repository if you have not already. See Configure the Perforce repository.
Run the following command to install the P4 DAM package:
sudo yum install p4dam-web

Ubuntu

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

Install manually from a downloaded P4 DAM package

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

RHEL and CentOS

rpm -ivh p4dam-web-X.X.X-stable.elX.x86_64.rpm

Ubuntu

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

Step 6: Connect P4 DAM Web to P4 DAM DB

Do not reconfigure P4 DAM Web yet.

Turn the server into a cluster node.
Add the P4 DAM DB credentials for it to connect to the P4 DAM databases.
Open the P4 DAM configuration file at /var/opt/hth/shared/hth.json.

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 P4 DAM DB server",
        "db_port": "4002",
        "db_username": "Enter username of P4 DAM MongoDB user",
        "db_password": "Enter password of P4 DAM MongoDB user",
        "redis_host": "Enter IP address or hostname of P4 DAM DB server",
        "redis_password": "Enter Redis password chosen on P4 DAM DB server",
        "enable": true
  },
  ... (snipped)
}

Change the P4 DAM Company ID and credentials, then apply your changes.
- The Password must be a minimum of 8 characters and cannot contain spaces. Valid characters: A-Z, a-z, 0-9,-, _
- Company ID and Username must be 2 - 100 characters and cannot contain spaces. Valid characters: A-Z, a-z, 0-9,-, _
Change the P4 DAM Company ID, administrator User ID, Password, and apply the changes by running the following command:
sudo HTH_INIT_COMPANY_NAME="<dam>" HTH_INIT_USERNAME="<administrator>" HTH_INIT_PASSWORD="<password>" hth-ctl reconfigure
Where <dam> is the Company ID, <administrator> is the User ID, and <password> is the password.
If you get an error message after using the reconfigure command, check the error message, fix the error, and run the sudo hth-ctl reconfigure command again.

Next steps

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