Tarball assisted install of Infrastructure for Linux

With the assisted install of the Infrastructure agent for Linux, you can make the changes you need to the installation script and configuration file we provide so you can adapt it to your environment.

Assisted install only works for the Systemd, Upstart, and SysV service managers. If you use any other service manager, proceed with the manual install.

Before installation, check the compatibility and requirements.

Install the agent

To install the agent:

  1. Download the packaged agent file.
  2. Unpack the file.
  3. Make sure the file unpacks with the following structure:
    unpacked-structure

    Once it's unpacked, access and edit the installation script installer.sh and the configuration file config_defaults.sh.

  4. Update your license key in config_defaults.sh.
  5. Optional: Update any other environment parameters in the configuration file.
  6. Execute installer.sh with admin rights.

The script automatically identifies your service manager. If it fails, it will prompt you to manually update it.

Configure your installation

The configuration file config_defaults.sh serves as a source of reference for all the configuration options. It contains the following environment parameters:

Variable Description

NRIA_AGENT_DIR

Required at agent startup.

The agent home directory.

Default:

/var/db/newrelic-infra/

NRIA_BIN_DIR

Required at installation.

The path to the agent binary folder.

Default:

/usr/local/bin

NRIA_CONFIG_FILE

Required at installation.

The agent configuration file's location.

Default:

/etc/newrelic-infra/yml

NRIA_LICENSE_KEY

Only configuration option required at startup.

The New Relic Infrastructure agent license key.

NRIA_LOG_FILE

Required at agent startup.

The location where the agent will log.

Default:

/var/run/newrelic-infra/newrelic-infra.log

NRIA_MODE

Required at installation.

The privilege level for the agent. Possible values are ROOT, PRIVILEGED or UNPRIVILEGED. For more info see our documentation on agent running modes.

Default:

ROOT

NRIA_PID_FILE

Required at agent startup.

The location where the agent will place its PID file.

Default:

/var/run/newrelic-infra/newrelic-infra.pid

NRIA_PLUGIN_DIR

Required at agent startup.

The directory containing the configuration files of the integrations.

Default:

/etc/newrelic-infra/integrations.d/

NRIA_USER

Required at installation time only when the running mode is set to either PRIVILEGED or UNPRIVILEGED.

The user that will run the agent binary.

What's next?

You may also want to:

For more help

Recommendations for learning more: