Skip to content

Latest commit

 

History

History
91 lines (70 loc) · 2.92 KB

downgrade.md

File metadata and controls

91 lines (70 loc) · 2.92 KB
Raw

Downgrade back to Agent 5

This guide assumes you upgraded to the beta using our upgrade guide

We have been careful to keep the legacy configurations in place to ease the the downgrade process should you decide you do not wish to continue trying the beta.

Linux

Debian Flavored Systems

Set up apt so it can download through https
sudo apt-get update
sudo apt-get install apt-transport-https
Remove Beta Repo and Ensure the stable repo is present
sudo rm /etc/apt/sources.list.d/datadog-beta.list
[ ! -f /etc/apt/sources.list.d/datadog.list ] &&  echo 'deb https://apt.datadoghq.com/ stable main' | sudo tee /etc/apt/sources.list.d/datadog.list
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 382E94DE
Update apt and downgrade the agent
sudo apt-get update
sudo apt-get remove datadog-agent
sudo apt-get install datadog-agent

Red Hat Flavored Systems

Remove the Beta Yum repo from your system:
rm /etc/yum.repos.d/datadog-beta.repo
[ ! -f /etc/yum.repos.d/datadog.repo ] && echo -e '[datadog]\nname = Datadog, Inc.\nbaseurl = https://yum.datadoghq.com/rpm/x86_64/\nenabled=1\ngpgcheck=1\npriority=1\ngpgkey=https://yum.datadoghq.com/DATADOG_RPM_KEY.public\n       https://yum.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public' | sudo tee /etc/yum.repos.d/datadog.repo
Update your local yum cache and downgrade the agent
sudo yum clean expire-cache metadata
sudo yum check-update
sudo yum remove datadog-agent
sudo yum install datadog-agent

Back-sync configurations and AutoDiscovery templates (optional)

If you have made any changes to your configurations or templates, you might want to sync these back for agent 5.

Note: please beware that if you have made any changes to your configurations to support new agent6-only options, these will not work anymore with agent5.

Back-sync custom checks (optional)

If you made any changes or added any new custom checks while testing Agent 6 you might want to enable them back on Agent 5. Note: you only need to copy back checks you changed.

sudo -u dd-agent -- cp /etc/datadog-agent/checks.d/<check>.py /etc/dd-agent/checks.d/

Restart the agent

# Systemd
sudo systemctl restart datadog-agent
# Upstart
sudo /etc/init.d/datadog-agent restart

Clean out /etc/datadog-agent (optional)

sudo -u dd-agent -- rm -rf /etc/datadog-agent/

Windows

Run the agent installer package for the latest 5.x version, instructions can be found in the Datadog agent integration page.

MacOS

  1. Stop the Agent with the systray app, if it's running
  2. Exit the systray app
  3. Uninstall the Datadog Agent application
  4. Install the Agent 5 DMG package using your preferred installation method