Install for Ubuntu and Debian (New Relic Servers)

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

To install Infrastructure on Ubuntu or Debian, see Install Infrastructure for Linux.

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.

Using apt

This is the recommended method for New Relic installation and maintenance.

Step Notes
1.

Configure the New Relic apt repository.

echo 'deb http://apt.newrelic.com/debian/ newrelic non-free' | sudo tee /etc/apt/sources.list.d/newrelic.list

This command adds deb http://apt.newrelic.com/debian/ newrelic non-free to /etc/apt/sources.list.d/newrelic.list. It creates the file if it does not exist.
This step only needs to be done once on each system.

2.

Trust the New Relic GPG key.

This step is required to register New Relic as an authenticated source where apt-get will look for new packages. To get the New Relic public apt-key from global key servers, run the following command as root:

wget -O- https://download.newrelic.com/548C16BF.gpg | apt-key add -

Note: If you do not run this command as root, you may see an error message about the public key. If this occurs, include sudo in the command:

wget -O- https://download.newrelic.com/548C16BF.gpg | sudo apt-key add -
3.

Update the local package list.

Execute the following command as root:

apt-get update
4.

Install Servers for Linux.

Execute the following command as root:

apt-get install newrelic-sysmond

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

5.

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.

6.

Start nrsysmond.

Execute the startup command as root:

  • If you use systemd (common in Ubuntu 15.04 and higher or Debian 8 and higher), use:

    systemctl start newrelic-sysmond
  • If you use init.d (older versions of Ubuntu and Debian), use:

    /etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully.

7.

Optional: Enable Docker.

To view your server in the UI, from the New Relic menu bar select Servers > (selected server).

Using dpkg (manual installation)

If you use this method, you will need to manually install updates. That is why the apt solution described above is the preferred method for Servers for Linux installation and maintenance.

Step Notes
1.

Copy the URL for the package download.

Navigate to the appropriate URL for your architecture and copy the full 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:

dpkg -i newrelic-sysmond_X.X.X.X_i386.deb

64-bit:

dpkg -i newrelic-sysmond_X.X.X.X_amd64.deb
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 startup command as root:

  • If you use systemd (common in Ubuntu 15.04 and higher or Debian 8 and higher), use:

    systemctl start newrelic-sysmond
  • If you use init.d (older versions of Ubuntu and Debian), use:

    /etc/init.d/newrelic-sysmond start

Verify that a message indicates that nrsysmond has started successfully.

6.

Optional: Enable Docker.

To view your server in the UI, from the New Relic menu bar select Servers > (selected server).

Using the tarball

If apt or dpkg do 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 apt: apt-get remove newrelic-sysmond
    • If using dpkg: dpkg -r newrelic-sysmond
  2. When the uninstall process finishes, restart your app server or web server.
  3. Wait a few minutes, then verify that no data is being reported for that server in New Relic Servers.

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.