-
Notifications
You must be signed in to change notification settings - Fork 812
Upgrade Notes
NOTE: This page is now deprecated. Please see https://github.com/DataDog/dd-agent/blob/master/CHANGELOG.md for details on the latest agent version.
This page details additional notes about Datadog agent versions.
- From 3.4.1 and newer, simply upgrade using your package manager.
- From 3.4.0 and older, see instructions for 3.4.x below.
The 3.4.x saw a change in the Datadog Agent packaging. Previously the agent was shipped as two or three packages, depending on your operating system.
On operating systems that only shipped python 2.4 (e.g Centos 5, Debian Lenny), we required the installation of datadog-agent-base. Upon installation the dependency datadog-agent-lib was also installed.
On newer operating systems that shipped python 2.6 (e.g. Ubuntu Lucid, Centos 6) we required the installation of datadog-agent, which in turn brought datadog-agent-base and datadog-agent-lib.
With 3.4.1 having multiple packages in no longer required. datadog-agent and datadog-agent-base are still current but they are mutually exclusive.
As of 3.4.1, you should only have to install one Datadog package per machine:
- On python-2.4 OSes, install
datadog-agent-base - On python-2.6 and greater OSes, install
datadog-agent.
This split unfortunately had some bugs and caused some upgrading issues for some users. This section notes those cases and provides workarounds. In particular:
If you get an error running apt-get upgrade, usually running it a second time is enough to fix it. If that is insufficient run:
sudo apt-get remove datadog-agent datadog-agent-base datadog-agent-lib
sudo apt-get install datadog-agent # (or -base in case of python 2.4)
and then re-install the appropriate package datadog-agent-base (python-2.4) or datadog-agent (python-2.6).
We no longer install all datadog agent packages on a machine, so users who install with this method need to just install the package of their choice, that is to say:
sudo apt-get install datadog-agent # <-- python 2.6
# *** OR ***
sudo apt-get install datadog-agent-base # <-- python 2.4
If you get an error during the upgrade, please run
sudo yum remove datadog-agent datadog-agent-base datadog-agent-lib -y
Then re-install the appropriate datadog-agent or datadog-agent-base.
Apologies for any confusion caused with this release. And thanks for your patience and the incredibly helpful bug reports.