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.
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.
Important
As of version 1.4.0, the infrastructure agent package includes the additional newrelic-infra-ctl
binary, which is used to help troubleshoot a running agent. Although this binary is not required to execute the agent, we recommend to add it in your path. See our docs for more information.
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.