Control-M for dbt

The dbt (Data Build Tool) job is a cloud-based computing platform that enables you to develop, test, schedule, document, and analyze data models.

Control-M for dbt enables you to do the following:

  • Execute dbt jobs and override the predefined dbt job commands.
  • Manage dbt credentials in a secure connection profile.
  • Connect to any dbt endpoint.
  • Integrate dbt jobs with other Control-M jobs into a single scheduling environment.
  • Monitor the status, results, and output of dbt jobs in the Monitoring domain.
  • Attach an SLA job to your dbt jobs.
  • Introduce all Control-M capabilities to Control-M for dbt including advanced scheduling criteria, complex dependencies, Resource Pools, Lock Resources, and variables.
  • Run 50 dbt jobs simultaneously per Agent.

Control-M for dbt Compatibility

The following table lists the prerequisites that are required to use the dbt plug-in, each with its minimum required version.

Control-M Application Integrator9.0.20.201
Control-M Web9.0.20.200
Control-M Automation API9.0.20.250

Control-M for dbt is supported on Control-M Web and Control-M Automation API, but not on Control-M client.

To download the required installation files for each prerequisite, see Obtaining Control-M Installation Files.

Setting up Control-M for dbt

This procedure describes how to deploy the dbt plug-in, create a connection profile, and define a dbt job in Control-M Web and Automation API.


Integration plug-ins released by BMC require an Application Integrator installation at your site. However, these plug-ins are not editable and you cannot import them into Application Integrator. To deploy these integrations to your Control-M environment, you import them directly into Control-M using Control-M Automation API.

Before You Begin

Verify that Automation API is installed, as described in Automation API Installation.


  1. Create a temporary directory to save the downloaded files.

  2. Download the dbt plug-in from the Control-M for dbt download page in the EPD site.
  3. Install the dbt plug-in via one of the following methods:
    • (9.0.21 or higher) Use the Automation API Provision service:
      1. Log in to the Control-M/EM Server machine as an Administrator and store the downloaded zip file in the one of the following locations (within several minutes, the job type appears in Control-M Web):
        • Linux: $HOME/ctm_em/AUTO_DEPLOY
        • Windows: <EM_HOME>\AUTO_DEPLOY
      2. Log in to the Control-M/Agent machine and run the provision image command, as follows:
        • Linux: ctm provision image DBT_plugin.Linux
        • Windows: ctm provision image DBT_plugin.Windows
    • ( or lower) Use the Automation API Deploy service, as described in deploy jobtype.
  4. Create a dbt connection profile in Control-M Web or Automation API, as follows:
  5. Define a dbt job in Control-M Web or Automation API, as follows:


To remove this plug-in from an Agent, follow the instructions in Removing a Plug-in. The plug-in ID is DBT042023.

Was this page helpful? Yes No Submitting... Thank you