Skip to content

Commit

Permalink
Removing duplicated documentation (#4132)
Browse files Browse the repository at this point in the history
  • Loading branch information
Pierre Guceski authored Sep 12, 2019
1 parent cc4ccbf commit 81b0e2a
Showing 1 changed file with 1 addition and 89 deletions.
90 changes: 1 addition & 89 deletions docs/agent/downgrade.md
Original file line number Diff line number Diff line change
@@ -1,91 +1,3 @@
# Downgrade back to Agent 5

This guide assumes you upgraded to the Agent v6 using our [upgrade guide][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](#linux)
* [Windows](#windows)
* [MacOS](#macos)

## Linux

#### Debian Flavored Systems

##### Set up apt so it can download through https
```shell
sudo apt-get update
sudo apt-get install apt-transport-https
```

##### Remove Beta Repo and Ensure the stable repo is present
```shell
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 A2923DFF56EDA6E76E55E492D3A80E30382E94DE
```

##### Update apt and downgrade the agent
```shell
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:
```shell
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\nrepo_gpgcheck=0\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
```shell
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.
```shell
sudo -u dd-agent -- cp /etc/datadog-agent/checks.d/<check>.py /etc/dd-agent/checks.d/
```

#### Restart the agent
```shell
# Systemd
sudo systemctl restart datadog-agent
# Upstart
sudo /etc/init.d/datadog-agent restart
```

#### Clean out /etc/datadog-agent (optional)
```shell
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](https://app.datadoghq.com/account/settings#agent/windows).

## 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

[upgrade-guide]: upgrade.md
Instructions to downgrade your Agent from version 6 to version 5 can be found in the [Datadog public documentation](https://docs.datadoghq.com/agent/faq/agent-downgrade/).

0 comments on commit 81b0e2a

Please sign in to comment.