Fedora

Basic Agent Usage for Fedora

Overview

This page outlines the basic features of the Datadog Agent for Fedora. If you haven’t installed the Agent yet, instructions can be found in the Datadog Agent Integration documentation.

Note: Fedora 26 and above are supported.

Commands

In Agent v6, the service manager provided by the operating system is responsible for the Agent lifecycle, while other commands must be run via the Agent binary directly. In Agent v5, almost everything is done via the service manager.

Note: If service is not available on your system, use:

• upstart-based systems: initctl
• systemd-based systems: systemctl

Learn more about Service lifecycle commands

Configuration

Troubleshooting

Working with the embedded Agent

The Agent contains an embedded Python environment at /opt/datadog-agent/embedded/. Common binaries such as python and pip are contained within /opt/datadog-agent/embedded/bin/.

See the instructions on how to add packages to the embedded Agent for more information.

Switch between Agent v5 and v6

Upgrade to Agent 6

A script is available to automatically install or upgrade to the new Agent. It sets up the package repositories and installs the Agent package for you. When upgrading, the import tool also searches for an existing datadog.conf from a prior version, and converts Agent and Check configurations according to the new v6 format.

One-step install

Upgrade

The Agent v6 installer can automatically convert v5 configurations during the upgrade:

DD_UPGRADE=true bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-agent/master/cmd/agent/install_script.sh)"

Note: The import process won’t automatically move custom Agent checks. This is by design as we cannot guarantee full backwards compatibility out of the box.

Fresh install

This is very similar to the upgrade method above, except instead of specifying the upgrade flag, you must supply your API key. This method will also work on Agent v5 machines, however the existing configuration will not be converted.

DD_API_KEY=YOUR_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-agent/master/cmd/agent/install_script.sh)"

Manual install

1. Set up Datadog’s Yum repo on your system by creating /etc/yum.repos.d/datadog.repo with the contents:

   [datadog]
   name=Datadog, Inc.
   baseurl=https://yum.datadoghq.com/stable/6/x86_64/
   enabled=1
   gpgcheck=1
   gpgkey=https://yum.datadoghq.com/DATADOG_RPM_KEY.public

2. Update your local Yum repo and install the Agent:

   sudo yum makecache
   sudo yum remove datadog-agent-base
   sudo yum install datadog-agent
   

3. Copy the example configuration into place and plug in your API key:

   sudo sh -c "sed 's/api_key:.*/api_key: <YOUR_API_KEY>/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"

4. Restart the Agent

   sudo systemctl restart datadog-agent.service
   

Downgrade to Agent v5

1. Remove the Agent v6 repository and ensure that the stable repo is present:

   rm  /etc/yum.repos.d/datadog.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

2. 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
   

3. Restart the Agent:

   • For systemd-based systems:

     sudo systemctl restart datadog-agent
     

   • For upstart-based systems:

     sudo /etc/init.d/datadog-agent restart
     

Uninstall the Agent

sudo yum remove datadog-agent

Further Reading