Update the infrastructure agent

If you need to install the infrastructure agent for the first time, see the installation docs for Linux, Windows, or configuration management tools.

If you need to uninstall the infrastructure agent, see Uninstall the infrastructure agent.

Identify the infrastructure agent version

The infrastructure agent doesn't update itself automatically. To see if you have the latest agent version, see the infrastructure agent release notes.

To view the current infrastructure agent version for a host in the New Relic UI, use any of these options:

• Single hosts: See the agentVersion tag on any host entity, or look for its Agent version in the Infrastructure UI.
• Multiple hosts: Go to Infrastructure > Navigator and group reporting entities by agentVersion to see a list of active hosts per version.
• Query: Use the agentVersion attribute on any standard agent metric to generate a report. For example, the following NRQL query shows number of unique active hosts group by agent version:

  FROM SystemSample SELECT uniqueCount(hostname) 
  FACET agentVersion 
  LIMIT MAX

  Copy

To manually check the version on the host, you can log onto a server and run newrelic-infra --version, or the applicable command for your package manager. The directory where you'd run this differs between operating systems, but here are the default paths:

• Linux: /usr/bin/newrelic-infra
• Windows: C:\Program Files\New Relic\newrelic-infra\
• macOS: /usr/local/bin/newrelic-infra

Identify outdated agent versions from the UI

You'll first need to determine the latest version available from the agent release notes, we recommend running versions that are no older than three months when possible.

To identify active hosts that are running a version that's older than a given major.minor (for example, 1.45.0), you can run this NRQL query:

FROM SystemSample 
SELECT uniques(hostname) 
WHERE numeric(capture(agentVersion, '(?P<major>.[0-9]*).([0-9]*).([0-9]*)')) <= 1 
AND numeric(capture(agentVersion, '([0-9]*).(?P<minor>.[0-9]*).([0-9]*)')) <= 45
LIMIT MAX

Update the agent for installs using the package manager

If you used the default installation process, use your package manager to update the program and its dependencies to the latest version. Here are examples for some common systems:

$
sudo apt-get update && sudo apt-get install --only-upgrade newrelic-infra -y

$
sudo yum update newrelic-infra -y

$
sudo zypper -n update newrelic-infra

Update the agent for assisted and manual tarball installs

To update the agent, download the file again and follow the installation procedure for Linux (assisted or manual) or Windows (assisted or manual). This will overwrite your old installation.

Update the containerized version of the agent

Use the latest label to ensure that our Docker image is automatically updated.