Downgrade the Agent to a Prior Minor Version

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

For DEB or RPM packages of the Datadog Agent, find the instructions below to downgrade the Datadog Agent to a prior minor version.

To downgrade the Datadog Agent to a prior major version, follow the instructions on the dedicated page.

Notes:

  • These instructions only work for Datadog Agent version 6.x and above.
  • The instructions below for configuration management tools only work with the latest major version of these tools: v4.x for the Chef cookbook, v3.x for the Puppet module, and v4.x for the Ansible role. If you are using a prior version, see the documentation for that version on the tools’ repositories: Chef cookbook v3.x, Puppet module v2.x, or Ansible role v3.x.

Debian/Ubuntu

CLI

sudo apt-get update && sudo apt-get install --allow-downgrades datadog-agent=1:X.Y.Z-1

Note: If the option --allow-downgrades doesn’t exist for your apt version, you can use --force-yes instead.

Configuration management tools

node["datadog"]["agent_version"] = "1:X.Y.Z-1"
node["datadog"]["agent_package_action"] = "install"
node["datadog"]["agent_allow_downgrade"] = true
class { 'datadog_agent':
      ...
      agent_version => "1:X.Y.Z-1",
}

Add the following attributes in your playbook:

datadog_agent_version: "1:X.Y.Z-1"
datadog_agent_allow_downgrade: yes

RHEL/CentOS/Amazon Linux

CLI

sudo yum clean expire-cache metadata && sudo yum downgrade datadog-agent-X.Y.Z-1

Configuration management tools

Set the following attributes on your nodes:

node["datadog"]["agent_version"] = "X.Y.Z-1"
node["datadog"]["agent_package_action"] = "install"
node["datadog"]["agent_allow_downgrade"] = true
class { 'datadog_agent':
      ...
      agent_version => "X.Y.Z-1",
}

Add the following attributes in your playbook (on CentOS, this only works with Ansible 2.4+):

datadog_agent_version: "X.Y.Z-1"
datadog_agent_allow_downgrade: yes

SUSE

CLI

sudo zypper --no-gpg-check refresh datadog && sudo zypper install --oldpackage datadog-agent-1:X.Y.Z-1

Configuration management tools

Set the following attributes on your nodes:

node["datadog"]["agent_version"] = "1:X.Y.Z-1"
node["datadog"]["agent_package_action"] = "install"
node["datadog"]["agent_allow_downgrade"] = true

Datadog’s module doesn’t support SUSE.

Add the following attributes in your playbook:

datadog_agent_version: "1:X.Y.Z-1"
datadog_agent_allow_downgrade: yes