Currently the New Relic Platform Installer (NPI) tool supports the following plugins (expect this list to grow rapidly):
- New Relic MySQL Plugin - Java
- New Relic Memcached Plugin - Java
- New Relic Wikipedia (Example) Plugin - Java
- 3Legs Varnish Plugin - Java
- 3Legs Cassandra Plugin - Java
- 3Legs JMX Remote Plugin - Java
- New Relic WIkipedia (Example) Plugin - .NET
- New Relic MS SQL Plugin - .NET
The New Relic Platform Team is very excited and thankful for the community’s engagement in helping provide the rich ecosystem we have today. That said, we are always looking for areas to improve your experiences. In scouring through the feedback we have received through forums, reviews, and social media, we have realized that installation of plugins is a constant point of friction. How do I get it on my machine? How do I configure it? How do I keep it running? These are all questions we are hoping to address with the introduction of the New Relic Platform Installer (npi), a simple, light-weight command line tool that will help you to easily download, configure and manage New Relic Platform Plugins.
This is where you come in! Simply follow the instructions below to get a plugin up and running on your machine with the npi tool, and then let us know what you think by posting to our forums! Bear in mind, this is an early release so the tool only supports a small subset of the plugins we intend to support down the road. We look forward to hearing your feedback and thank you as always for helping us improve the New Relic Platform!
Step 1: Downloading the NPI Tool:
Simply copy and paste one of the following commands into your terminal (replacing ‘YOUR_LICENSE_KEY’ with your New Relic License Key) to download the npi tool to the directory “$HOME/newrelic-npi”. This will NOT affect your path, or download any global external dependencies:
** Note ** You can optionally prepend ‘PREFIX=[directory]’ or ‘DEFAULTUSER=[username]’ to configure the location the NPI tool will be installed and the default user plugins will be run as respectively.
Linux – Debian/Ubuntu
LICENSE_KEY=YOUR_KEY_HERE bash -c "$(curl -sSL https://download.newrelic.com/npi/release/install-npi-linux-debian-x86.sh)"
LICENSE_KEY=YOUR_KEY_HERE bash -c "$(curl -sSL https://download.newrelic.com/npi/release/install-npi-linux-debian-x64.sh)"
Linux – Red Hat/CentOS
LICENSE_KEY=YOUR_KEY_HERE bash -c "$(curl -sSL https://download.newrelic.com/npi/release/install-npi-linux-redhat-x86.sh)"
LICENSE_KEY=YOUR_KEY_HERE bash -c "$(curl -sSL https://download.newrelic.com/npi/release/install-npi-linux-redhat-x64.sh)"
Linux – Generic
LICENSE_KEY=YOUR_KEY_HERE bash -c "$(curl -sSL https://download.newrelic.com/npi/release/install-npi-linux-x86.sh)"
LICENSE_KEY=YOUR_KEY_HERE bash -c "$(curl -sSL https://download.newrelic.com/npi/release/install-npi-linux-x64.sh)"
- Windows and OSX are currently supported but have a slightly more manual setup process:
- Navigate to: http://download.newrelic.com/npi/release/ and download the latest archive for your system.
- Extract the archive to a location of your choosing.
- Run the following commands to configure the New Relic Platform installer to use your license key:
npi config set license_key <YOUR_LICENSE_KEY>
Step 2: Downloading Plugins:
We currently only support a subset of our plugins all of which require either Java or .NET to be installed on the box they are running on (the NPI tool does not install any runtime dependencies).
The NPI tool has two different workflows, the first is a simple interactive flow that will walk you through the installation; the second is a series of individual commands that give you granularity over each step of the installation and can be easily integrated into other scripts or workflows:
Installing with the interactive walkthrough:
The ‘install’ command will guide you through the installation process:
// Gets a list of available plugins to install with this tool ./npi available // Walks you through the installation of a plugin ./npi install <plugin_id>
Installing with individual commands:
You can always run ‘./npi --help’ from the directory where the tool was installed ("$HOME/newrelic-npi") to see a full list of commands currently supported. The following is an example session:
// Display a list of commands and flags that can be used to tailor your workflow ./npi --help // Show plugins currently on your machine ./npi list // Set your license key if you did not already in the installation process ./npi config set license_key <LICENSE_KEY> // Gets a list of available plugins to install with this tool ./npi available // Download a plugin to your machine ./npi fetch <plugin_id> // Copy license key and open the plugin configuration file in a text editor ./npi prepare <plugin_id> // Start a plugin in the foreground to ensure everything is working ./npi start <plugin_id> --foreground // * ADMIN REQUIRED * Set the plugin to run as a background process and start it ./npi add-service <plugin_id> --start
Step 3: Provide Feedback:
We are using the New Relic forums to gather feedback from you on the NPI tool to make things as simple as possible. All you’ll need to do is create a post with your feedback under the “Platform Installer” category. Anything you’d like us to know, we’d like to hear (e.g. the tool is easy or hard to use, the experience is confusing, the command names do not make sense to you) it will all help us plan the next steps for this project!
Thank you for taking the time!
New Relic Platform Team