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.
Important
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:
Download the packaged agent file or use the following command that automatically fetches a specific version of the agent, its checksum and verifies it after download. Replace
ARCH=amd64
with desired architecture (amd64, 386, arm64, arm) andV=1.27.4
with latest or specific version.bash$V=1.27.4 ARCH=amd64; echo "https://download.newrelic.com/infrastructure_agent/binaries/linux/${ARCH}/newrelic-infra_linux_${V}_${ARCH}.tar.gz" | { read url; wget "${url}"{,.sum}; shasum -a 256 --check ${url##*/}.sum; }From version
1.27.4
on, we provide thetar.gz
package GPG signature. You can check the signature procedure and instructions for verification in the infra-agent repository on GitHub.Unpack the file.
Make sure the file unpacks with the following structure:
newrelic-infra|-- config_defaults.sh|-- etc| |-- init_scripts| | |-- systemd| | | `-- newrelic-infra.service| | |-- sysv| | | `-- newrelic-infra| | `-- upstart| | `-- newrelic-infra| `-- newrelic-infra| `-- integrations.d|-- installer.sh|-- usr| `-- bin| |-- newrelic-infra| |-- newrelic-infra-ctl| `-- newrelic-infra-service`-- var|-- db| `-- newrelic-infra| |-- custom-integrations| |-- integrations.d| |-- LICENSE.txt| `-- newrelic-integrations|-- log| `-- newrelic-infra`-- run`-- newrelic-infraUpdate your license key in
config_defaults.sh
.Optional: Update any other environment parameters in the configuration file.
Execute
installer.sh
with admin rights.
The script automatically identifies your service manager. If it fails, it will prompt you to manually update it.
Did this doc help with your installation?
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 |
---|---|
Required at agent startup. | The agent home directory. Default:
|
Required at installation. | The path to the agent binary folder. Default:
|
Required at installation. | The agent configuration file's location. Default:
|
Only configuration option required at startup. | The infrastructure agent license key. |
Required at agent startup. | The location where the agent will log. Default:
|
Required at installation. | The privilege level for the agent. Possible values are Default:
|
Required at agent startup. | The location where the agent will place its PID file. Default:
|
Required at agent startup. | The directory containing the configuration files of the integrations. Default:
|
Required at installation time only when the running mode is set to either | The user that will run the agent binary. |
What's next?
You may also want to:
- Add custom attributes to annotate your infrastructure data.
- Connect your AWS account if your servers are hosted on Amazon EC2.
- Enable log forwarding.
- Add other infrastructure integrations to collect data from external services.
- Manually start, stop, restart, or check the agent status.