Zip assisted install of the infrastructure agent for Windows

With the assisted install of the infrastructure agent for Windows, you can make the changes you need to the installation script we provide so you can adapt it to your environment. Before installation, make sure to check the compatibility and requirements.

Install the agent

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.

To install the agent:

Download the packaged agent file.
Unpack the file.
Make sure the file unpacks with the following structure:
Once it's unpacked, access and edit the installation PowerShell script installer.ps1.
Update your license key.
Optional: Update any other parameters.
Execute installer.ps1 with admin rights.

Configure your installation

Important

Make sure any custom folder defined in the installation settings has permissions limitations properly defined. The infrastructure agent might execute any integration defined in the NRIA_PLUGIN_DIR directory with Administrator permissions.

You can configure the following parameters during the assisted install for Windows:

Variable	Description
`NRIA_AGENT_DIR` Required at agent startup.	The agent home directory. Default: `C:\Program Files\New Relic\newrelic-infra`
`NRIA_APP_DATA_DIR`	This configures the data directory to store inventory and other agent files. Default: `C:\%ProgramData%\New Relic\newrelic-infra`
`NRIA_CONFIG_FILE` Required at installation.	The agent configuration file's location. Default: `C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml`
`NRIA_LICENSE_KEY` Only configuration option required at startup.	The New Relic license key.
`NRIA_LOG_FILE` Required at agent startup.	The location where the agent will log. Default: `C:\Program Files\New Relic\newrelic-infra\newrelic-infra.log`
`NRIA_OVERWRITE`	By default and for security reasons, Windows does not install a service if there's another service with the same name already installed. To bypass this check, make sure this setting `NRIA_OVERWRITE` is `TRUE`. Default: `TRUE`
`NRIA_PLUGIN_DIR` Required at agent startup.	The directory containing the configuration files of the integrations. Default: `C:\Program Files\NewRelic\newrelic-infra\inregrations.d`
`NRIA_SERVICE_NAME`	This provides the name for the Windows service.

Variable

Description

NRIA_AGENT_DIR

Required at agent startup.

The agent home directory.

Default:

C:\Program Files\New Relic\newrelic-infra

NRIA_APP_DATA_DIR

This configures the data directory to store inventory and other agent files.

Default:

C:\%ProgramData%\New Relic\newrelic-infra

NRIA_CONFIG_FILE

Required at installation.

The agent configuration file's location.

Default:

C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml

NRIA_LICENSE_KEY

Only configuration option required at startup.

The New Relic license key.

NRIA_LOG_FILE

Required at agent startup.

The location where the agent will log.

Default:

C:\Program Files\New Relic\newrelic-infra\newrelic-infra.log

NRIA_OVERWRITE

By default and for security reasons, Windows does not install a service if there's another service with the same name already installed. To bypass this check, make sure this setting NRIA_OVERWRITE is TRUE.

Default:

TRUE

NRIA_PLUGIN_DIR

Required at agent startup.

The directory containing the configuration files of the integrations.

Default:

C:\Program Files\NewRelic\newrelic-infra\inregrations.d

NRIA_SERVICE_NAME

This provides the name for the Windows service.

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.
Add other New Relic infrastructure integrations to collect data from external services.
Manually start, stop, restart, or check the agent status.