Skip to content

Upgrade to Agent 5.x

Jump to bottom
Remi Hakim edited this page Aug 18, 2014 · 9 revisions

Summary

What is Datadog Agent 5.0.0 ?

Datadog Agent 5.0.0 is the latest major version of the Datadog Agent. Its main improvement being that it will be self-contained. All dependencies required by the Agent to run will be part of the package.

What issues will it solve ?

  • Conflicts with dependencies (Tornado, Supervisor, Check dependencies: MysqlDB, Postgres....)
  • On Centos 5, there is no forwarder which can create some issues (such as no proxy support for Dogstatsd). This will be solved
  • Full support of Fedora Core
  • Up-to-date dependencies

What will break ?

  • If you were using a custom check that needed python dependencies you will have to reinstall them using the bundled pip: * sudo /opt/datadog-agent/embedded/bin/pip install YOUR_DEPENDENCY

  • Configuring checks in datadog.conf for checks.d is deprecated and won't work anymore. Please configure your checks by editing the yaml files in the conf.d directory.

  • See the full Changelog here: https://github.com/DataDog/dd-agent/blob/master/CHANGELOG.md

How to install or update automatically?

  • Run this script (make sure to replace "YOUR_API_KEY" by your actual API key):
DD_API_KEY=YOUR_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

How to install with chef?

  • Use the beta branch of our omnibus cookbook by editing your Berksfile to point to it:
cookbook 'datadog', :git => 'https://github.com/datadog/chef-datadog.git', :ref => "omnibus"

How to install from source?

  • Run this script (make sure to replace "YOUR_API_KEY" by your actual API key):
DD_API_KEY=YOUR_API_KEY sh -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/setup_agent.sh)"

How to upgrade/install step by step ?

  • On Debian/Ubuntu (All versions/All architectures):
    • Edit /etc/apt/sources.list.d/datadog.list to include the following: * 
           deb     http://apt.datadoghq.com/ stable main
    • Run: 
           sudo apt-get update
     
     sudo apt-get install datadog-agent
  • On RHEL/CentOS

    • If you are running RHEL 5/Centos 5, follow these extra steps:

      • Uninstall datadog-agent-base: *

            sudo yum remove datadog-agent-base

      • Edit /etc/dd-agent/datadog.conf and comment out the following line:

           dogstatsd_target: https://app.datadoghq.com/

        should be:

           # dogstatsd_target: https://app.datadoghq.com/

    • If you are running on an i386/i686 architecture, edit your /etc/yum.repos.d/datadog.repo to include the following:

          [datadog]
    name = Datadog, Inc. 
    baseurl = http://yum.datadoghq.com/rpm/i386/
    enabled=1
    gpgcheck=0

    • If you are running an x86_64/amd64 architecture edit your /etc/yum.repos.d/datadog.repo to include the following:

          [datadog]
    name = Datadog, Inc. 
    baseurl = http://yum.datadoghq.com/rpm/x86_64/
    enabled=1
    gpgcheck=0

    • Update/Install the Agent: *

          sudo yum install datadog-agent

Support

If you have any questions/remarks please ping us:

Getting the agent

Getting help

Agent design

Contributing

Clone this wiki locally