Install on-host integrations built by New Relic

This document explains how to install New Relic Infrastructure integrations. These procedures apply only to on-host integrations built by New Relic, and not to New Relic's cloud integrations.

On-host integrations are available only with Infrastructure Pro. For more subscription details, see the Infrastructure product page.

Verify compatibility and requirements

Before you install an integration, see the documentation for your integration and check the compatibility and requirements.

Install with apt (Debian or Ubuntu)

On-host integrations are available only with Infrastructure Pro.

To install an Infrastructure on-host integration with apt:

  1. If you do not already have New Relic Infrastructure, install the Infrastructure agent for your operating system.
  2. From the command line, run:

    sudo apt-get update
  3. Run the following command, where INTEGRATION_FILE_NAME represents a specific integration's file name, which can be found in the integration's documentation.

    sudo apt-get install INTEGRATION_FILE_NAME
    
  4. Follow additional installation procedures for a specific on-host integration.

Install with yum (Amazon Linux, CentOS, or RHEL)

On-host integrations are available only with Infrastructure Pro.

To install the Infrastructure integration package with yum:

  1. If you do not already have New Relic Infrastructure, install the Infrastructure agent for your operating system.
  2. From the command line, run:

    sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-infra'
  3. Run the following command, where INTEGRATION_FILE_NAME represents a specific integration's file name, which can be found in an integration's documentation.

    sudo yum install INTEGRATION_FILE_NAME
    
  4. Follow additional installation procedures for a specific on-host integration.

Install with Zypper (SLES)

On-host integrations are available only with Infrastructure Pro.

To install an Infrastructure integration with Zypper:

  1. If you do not already have New Relic Infrastructure, install the Infrastructure agent for your operating system.
  2. From the command line, run:

    sudo zypper -n ref -r newrelic-infra
  3. Run the following command, where INTEGRATION_FILE_NAME represents a specific integration's file name, which can be found in an integration's documentation.

    sudo zypper -n install INTEGRATION_FILE_NAME
    
  4. Follow additional installation procedures for a specific on-host integration.

Update the agent

To keep your on-host integration up to date with New Relic Infrastructure, follow standard procedures to update the on-host integration package.

For more help

Recommendations for learning more: