Upgrade to Datadog Agent v7
New announcements from Dash: Incident Management, Continuous Profiler, and more! New announcements from Dash!

Upgrade to Datadog Agent v7

Agent v7 only supports Python 3 custom checks. Check if your custom checks are Python 3 compatible before upgrading to Agent 7.

From Agent v6 to Agent v7

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 in order to upgrade your Agent from version 6 to version 7:

PlatformCommand
Amazon LinuxDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
CentOSDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
DebianDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
FedoraDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
Red HatDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
UbuntuDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
SUSEDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
  1. Download the Datadog Agent installer.
  2. Run the installer (as Administrator) by opening datadog-agent-7-latest.amd64.msi.
  3. Follow the prompts, accept the license agreement, and enter your Datadog API key.
  4. When the install finishes, you are given the option to launch the Datadog Agent Manager.

Note: Links to all available versions of the Windows Installer are provided in JSON format.

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 in order to upgrade your Agent from version 6 to version 7:

DD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_mac_os.sh)"

From Agent v5 to Agent v7

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 and DD_UPGRADE="true" in order to upgrade your Agent from version 5 to version 7. The Agent v7 installer can automatically convert v5 configurations during the upgrade:

PlatformCommand
Amazon LinuxDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
CentOSDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
DebianDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
FedoraDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
Red HatDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
UbuntuDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
SUSEDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
  1. Upgrade your Agent to version 6 following the manual upgrade process.
  2. Follow the From Agent v6 to Agent v7 upgrade instructions.

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 and DD_UPGRADE="true" in order to upgrade your Agent from version 5 to version 7. The Agent v7 installer can automatically convert v5 configurations during the upgrade:

DD_UPGRADE="true" DD_AGENT_MAJOR_VERSION=7 bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_mac_os.sh)"

Note: The upgrade process won’t automatically move custom Agent checks. This is by design as Datadog cannot guarantee full backwards compatibility out of the box. See the Python 3 Custom Check Migration guide to discover how to migrate your custom check from Python 2 to Python 3.

Further Reading

Additional helpful documentation, links, and articles: