Install for RedHat and CentOS (New Relic Servers)

For the latest, most advanced host monitoring, check out New Relic Infrastructure.

To install Infrastructure on Amazon Linux, CentOS, or RHEL see Install Infrastructure for Linux.

Recommendation: To install Servers for Linux, run the commands in this procedure as root.

Servers for Linux does not require root access to run. However, if you are using RedHat (.rpm) or Debian (.deb), they typically require root access to install, because they write to protected directories and interact with the system package databases. If you want to install as a non-root user, follow the instructions for other Linux operating systems.

 

[video link] For an overview of Servers for Linux installation, watch this video (about 3 minutes). View more videos and tutorials at learn.newrelic.com.

Using yum

This is the recommended method for Servers for Linux installation and maintenance.

Step Notes
1.

Configure the Servers for Linux yum repository.

Tell rpm about the New Relic repository by running one of the following commands as root. (This step only needs to be done once on each system.)

32-bit:

rpm -Uvh https://yum.newrelic.com/pub/newrelic/el5/i386/newrelic-repo-5-3.noarch.rpm

64-bit:

rpm -Uvh https://yum.newrelic.com/pub/newrelic/el5/x86_64/newrelic-repo-5-3.noarch.rpm
2.

Install Servers for Linux.

Execute the following command as root:

yum install newrelic-sysmond

If you see a warning about your license key at this point, ignore it.

3.

Configure your New Relic license key.

Your license key appears in the Account Information section of your New Relic Account settings. Execute the following command as root. (This step only needs to be done once on each system.)

nrsysmond-config --set license_key=YOUR_LICENSE_KEY

Optional: You can set the license_key configuration setting directly in /etc/newrelic/nrsysmond.cfg instead.

4.

Start nrsysmond.

Execute the following command as root:

/etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully, or refer to the troubleshooting instructions.

5.

Optional: Enable Docker.

To view your server statistics being reported: From the New Relic menu bar, select Servers > (selected server) > Overview.

Using rpm

Step Notes
1.

Copy the URL for the package download.

Navigate to the appropriate URL for your architecture and copy the URL for the latest newrelic-sysmond package:

2.

Download the package.

Run the following wget command, replacing https://LINK_TO_PACKAGE with the full URL of the package:

wget -L https://LINK_TO_PACKAGE
3.

Install Servers for Linux.

Run the appropriate command as root, replacing X.X.X.X with the current version:

32-bit:

rpm -i newrelic-sysmond-X.X.X.X-1.i386.rpm

64-bit:

rpm -i newrelic-sysmond-X.X.X.X-1.x86_64.rpm
4.

Configure your New Relic license key.

Your license key appears in the Account Information section of your New Relic Account settings. Execute the following command as root. (This step only needs to be done once on each system.)

nrsysmond-config --set license_key=YOUR_LICENSE_KEY

Optional: You can set the license_key configuration setting directly in /etc/newrelic/nrsysmond.cfg instead.

5.

Start nrsysmond.

Execute the following command as root:

/etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully, or refer to the troubleshooting instructions.

6.

Optional: Enable Docker.

To view your server statistics being reported: From the New Relic menu bar, select Servers > (selected server) > Overview.

Using the tarball

If yum or rpm does not work with your server configuration, you can install from the binary tarball. See Servers installation: Other Linux.

Uninstalling

To uninstall Servers for Linux:

  1. Execute one of the following commands as root:

    • If using yum: yum remove newrelic-sysmond
    • If using rpm: rpm -ev newrelic-sysmond
  2. When the uninstall process finishes, wait a few minutes and then verify no data is being reported to New Relic by checking that the health status is gray for servers listed on the Servers index.

For more help

Additional documentation resources include:

Discuss New Relic Servers in the New Relic Online Technical Community! Troubleshoot and ask questions, or discuss Servers for Linux or Servers for Windows in detail.

If you need additional help, get support at support.newrelic.com.