Install and configure P4 Search for P4 DAM

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

P4 DAM uses P4 Search to search and automatically tag assets.

You must install and configure P4 Search before deploying P4 DAM manually on-premises or in the cloud.

Step 1: Install P4 Search

Follow all installation steps in Install and configure P4 Search in the P4 Search Documentation.

Do not skip the steps to deploy the Elasticsearch plugin p4search-filter. P4 DAM will not work without it.

When you configure P4 DAM, you need the following information from P4 Search. Note this information during installation for future reference.

  • P4 Search server location
  • User and ticket

Step 2: Configure P4 Search

After installation, configure all P4 Search services. See Configuring P4 Search services in the P4 Search Documentation.

Make sure the following configurables are set for P4 DAM.

com.perforce.p4search.index.tags=dam_tag,dam_autotag
com.perforce.p4search.index.thumbnail=true

Image auto-tagging

If you want to use auto-tagging for P4 DAM assets, configure it. See Auto-tagging of images in the in the P4 Search Documentation.

Extension configuration

Enable all extensions. See Extension configuration in the P4 Search Documentation.

Step 3: Perform the initial index of the P4 Server

See Indexing P4 Search in the P4 Search Documentation.

Indexing the entire P4 database can take a long time to complete. When performing the initial index, you should limit indexing based on depot path, user, or changelist number range. Contact Perforce Support for help determining the best way to perform the initial index if you are unsure.

Step 4: Connect P4 DAM to P4 Search

Configure P4 DAM to use data indexed by P4 Search into Elasticsearch. You must have a running Elasticsearch instance and P4 Search configured to connect to the Elasticsearch instance.

Use the TeamHub admin UI to configure P4 DAM.

  1. Log in to the Perforce TeamHub administrator UI. See Logging in to the TeamHub admin UI.

  2. Click P4 DAM.

    The Configure P4 DAM page opens.

  3. In the P4 Search section, verify that P4 Search is configured correctly. The URL should be displayed. Click Status to view the connection status for various components required for P4 Search.

  4. In the P4 DAM configuration for Elasticsearch in P4 Search section, click Configure.

    P4 DAM retrieves the values it needs from P4 Search and they are displayed. Green checkmarks indicate the values match in P4 DAM and P4 Search. The values are also automatically written to the hth.json configuration file. See Perforce TeamHub configuration. Click Status to refresh the values.

Keep in mind that if the P4 Search configuration changes, you need to repeat these steps to update the values in P4 DAM.