newrelic-install script simplifies installing New Relic for PHP. It works with multiple PHP installations as well as installations in non-standard locations. Running it will:
- Copy the correct PHP modules into place.
- Install sample
- Configure the New Relic proxy daemon.
Be sure to review the information about working with multiple installations and non-standard locations before running the script.
Find the installer script
The installer script location depends on how you installed the New Relic PHP agent.
- Via system package manager: The installation script is in the
- Via a tarball: The installation script is in the directory where you extracted the tar archive file. The script in the tar distribution includes installation steps otherwise handled by the package manager.
Work with multiple PHP installations
newrelic-install to correctly detect multiple installations, ensure your
PATH environment variable is correctly set. The
newrelic-install script can only install the agent for versions it can find.
|If you want to...||Do this...|
|Specify additional directories||Use the
||Specify a set of directories in the
Invoke the installer script
From the command line, run the script at its location:
Via system package manager:
Via a tar archive directory:
Use install mode
As of PHP agent version 4.0, the installer will not work properly if it detects a single version of PHP if that version is PHP 5.1, which is deprecated. If you must run PHP 5.1, use PHP agent version 188.8.131.52. If you need help, get support at support.newrelic.com.
Follow this process to install New Relic.
- 1. Invoke install mode.
Invoke install mode by using one of these methods:
installcommand line option.
newrelic-installwith no options and select the install option from the main menu when invoking the script.
- 2. Provide your New Relic license key.
At the prompt, enter your New Relic license key. This key will be inserted into any INI files created during the rest of the installation process.
- 3. Select which PHP version to use if applicable.
newrelic-installfinds more than one version of PHP, select which version of PHP to use. You will not see this screen if the script only found a single version of PHP.
Example: The menu shows seven options:
1) /usr/bin 2) /usr/local/php/5.2.16/bin 3) /usr/local/php/5.2.16-zts/bin 4) /usr/local/php/5.3.4/bin 5) /usr/local/php/5.3.4-zts/bin 6) /usr/local/php/5.4.19-zts/bin 7) /usr/local/php/5.5.4-zts/bin 0) Exit Select (1-7, 0 to exit, or all):
At the menu, use any of these options:
- To select only one version, enter the number indicating the version you want to use.
- To select multiple versions, enter a comma- or space-separated list of numbers.
- To select every version listed, enter the keyword
- To exit the installation process, Enter
For each directory selected, the script will attempt to install the agent in the proper place and report on each attempt.
For PHP installations that allow multiple .ini files, the install script will copy a template file into place, if a modified one is not already installed. Make a note of the .ini files you will need to modify manually.
- 4. Install the daemon if applicable.
If the daemon was not installed by the package manager, install the daemon.
If this is an update or reinstall, the script provide a confirmation prompt before overwriting the old copy of the daemon.
If installation is successful, the script will show this final message:
New Relic is now installed on your system. Congratulations!
- 5. Restart your web server.
To activate the PHP agent, restart your web server.
If you are running PHP-FPM, you may also need to restart PHP-FPM separately before the agent will be active.
- 6. Note your archive file.
Note the name and location of the install archive file. This file will be located at /tmp/nrinstall-nnnn.tar and will contain both the install log and useful system information to help New Relic Technical Support with troubleshooting.
- 7. Fine-tune your configuration.
After you install New Relic successfully and restart your web server, you can begin gathering data about your applications. After a few minutes, data will begin to appear on your New Relic APM Overview page.
To fine-tune operation of both the PHP agent and daemon, review the PHP configuration options.
Use install-daemon mode
Requires PHP agent 9.2 or higher.
To install the daemon without the agent, run
newrelic-install with the
install_daemon command line option. This may be useful if the daemon is running on a different host or in a different container than the PHP application (as may happen with agent install on containers).
Troubleshoot PHP installation
If there were problems with the installation process, or if no data appears in New Relic APM, review the PHP troubleshooting procedures before contacting New Relic for support. Be sure to attach your archive file to any bug report, as well as the output of the
phpinfo() function produced by your web server.
Use uninstall mode
You can uninstall New Relic but keep valuable config files (useful when upgrading), or permanently uninstall New Relic from your system.
- Uninstall and keep config files.
This method is useful when you want to uninstall and upgrade. To uninstall New Relic using the install script, use either of these options:
newrelic-installwith no options, and select the uninstall option from the main menu when invoking the script.
The uninstall does not remove important configuration files, such as your daemon configuration file. Also, it does not remove any
newrelic.inifiles that you have modified.
- Permanently uninstall New Relic.
To permanently uninstall New Relic from your system: Invoke
This will remove all the configuration files and any links created at installation time. This will not affect any configuration parameters that might have been placed in files such as
php.in. Also, this will not remove the software packages installed on the system.