Cette traduction automatique est fournie pour votre commodité.
En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.
Le script interactif newrelic-install simplifie l'installation de l'application PHP dans New Relic. Il fonctionne avec plusieurs installations PHP ainsi qu'avec des installations dans des emplacements non standard. Son exécution permettra de :
L'emplacement du programme d'installation script dépend de la manière dont vous avez installé l'agent PHP New Relic .
Via le gestionnaire de paquets système : le script d'installation se trouve dans le répertoire /usr/bin .
Via une tarball: Le installation script se trouve dans le répertoire où vous avez extrait le tar fichier d'archive. Le script de la distribution tar inclut les étapes d'installation autrement gérées par le gestionnaire de paquets.
Travailler avec plusieurs installations PHP
Pour que newrelic-install détecte correctement plusieurs installations, assurez-vous que votre variable d'environnement PATH est correctement définie. Le script newrelic-install ne peut installer l'agent que pour les versions qu'il peut trouver.
If you want to...
Do this...
Spécifier des répertoires supplémentaires
Utilisez la variable d’environnement NR_INSTALL_PATH avec une liste séparée par des deux-points.
Remplacer NR_INSTALL_PATH et PATH
Spécifiez un ensemble de répertoires dans la variable d'environnement NR_INSTALL_PHPLIST sous forme de liste séparée par des deux-points. Ces répertoires doivent contenir soit la version en ligne de commande de PHP, soit le script php-config .
Invoquer le scriptdu programme d'installation
Le script a deux modes : installation et désinstallation. Si vous l'invoquez sans arguments, vous serez invité à sélectionner un mode.
Depuis la ligne de commande, exécutez le script à son emplacement :
Via le gestionnaire de paquets système : /usr/bin/newrelic-install
Via un répertoire d'archives tar : ./newrelic-install
Utiliser le mode d'installation
Suivez ce processus pour installer New Relic.
Appelez le mode d'installation en utilisant one de ces méthodes :
Exécutez newrelic-install avec l’option de ligne de commande install .
Exécutez newrelic-install sans options et sélectionnez l’option d’installation dans le menu principal lors de l’appel du script.
À la prompt, entrez votre New Relic . Cette clé sera insérée dans tous les fichiers INI créés pendant le reste du processus d'installation.
Si newrelic-install trouve plus d'une version de PHP, sélectionnez la version de PHP à utiliser. Vous ne verrez pas cet écran si le script ne trouve qu'une seule version de PHP.
Pour sélectionner une seule version, entrez le numéro indiquant la version que vous souhaitez utiliser.
Pour sélectionner plusieurs versions, entrez une liste de numéros séparés par des virgules ou des espaces.
Pour sélectionner toutes les versions répertoriées, entrez le mot-clé all.
Pour quitter le processus d’installation, entrez 0.
Pour chaque répertoire sélectionné, le script tentera d'installer l'agent à l'endroit approprié et signalera chaque tentative.
Important
Pour les installations PHP qui autorisent plusieurs fichiers .ini, le script d'installation copiera un fichier modèle à la place, si un fichier modifié n'est pas déjà installé. Notez les .ini fichiers que vous devrez modifier manuellement.
À partir de la version 4.0agent PHP, le programme d'installation ne fonctionnera pas correctement s'il détecte une seule version de PHP 5.1, qui est obsolète (2013). Si vous devez exécuter PHP 5.1, utilisez l'agent PHP version 3.9.5.13. Si vous avez besoin d'aide, obtenez de l'aide sur support.newrelic.com.
Si le daemon n'a pas été installé par le gestionnaire de paquets, installez le daemon.
S'il s'agit d'une mise à jour ou d'une réinstallation, le script fournit une prompt de confirmation avant d'écraser l'ancienne copie du daemon.
Si l'installation réussit, le script affichera ce message final :
New Relic is now installed on your system. Congratulations!
Pour activer l'agent PHP, redémarrez votre serveur Web.
Si vous exécutez PHP-FPM, vous devrez peut-être également redémarrer PHP-FPM séparément avant que l'agent ne soit actif.
Notez le nom et l’emplacement du fichier d’archive d’installation. Ce fichier sera situé à /tmp/nrinstall-nnnn.tar et contiendra à la fois le log d'installation et des informations système utiles pour aider le support technique New Relic en cas de dépannage.
Après avoir installé New Relic avec succès et redémarré votre serveur Web, vous pouvez commencer à collecter des données sur votre application. Après quelques minutes, les données commenceront à apparaître sur votre page APM Summary.
Pour affiner le fonctionnement de l' agent PHP et de daemon, consultez les options configuration PHP.
Utiliser le mode install_daemon
Pour installer le daemon sans l'agent, utilisez l'agent PHP 9.2 ou supérieur. Exécutez newrelic-install avec l’option de ligne de commande install_daemon .
Ceci est utile si le daemon s'exécute sur un hôte différent ou dans un conteneur différent de celui de l'application PHP. Par exemple, cela peut se produire avec l’installationagent sur un conteneur.
Ce document vous a-t-il aidé lors de votre installation ?
Dépannez votre installation PHP
Si vous rencontrez des problèmes lors du processus d'installation, consultez la section Aucune donnée n'apparaît et d'autres documents de dépannage avant de contacter New Relic pour obtenir de l'aide. Assurez-vous de joindre votre fichier d'archive à tout rapport de bogue, ainsi que la sortie de la fonction phpinfo() produite par votre serveur Web.
Mode de désinstallation
Vous pouvez désinstaller New Relic mais conserver les fichiers de configuration précieux (utiles lors de la mise à niveau), ou désinstaller définitivement New Relic de votre système.
Cette méthode est utile lorsque vous souhaitez désinstaller et mettre à niveau. La désinstallation ne supprime pas les fichiers de configuration importants, tels que votre fichier de configuration de daemon. De plus, il ne supprime aucun fichier newrelic.ini que vous avez modifié.
Pour désinstaller New Relic à l’aide du script d’installation, utilisez l’une de ces options :
Appelez newrelic-install avec l'option uninstall .
Exécutez newrelic-install sans options et sélectionnez l’option de désinstallation dans le menu principal lors de l’appel du script.
Pour désinstaller définitivement New Relic de votre système : appelez newrelic-install avec l'option purge .
Cela supprimera tous les fichiers de configuration et tous les liens créés au moment de l'installation. Cela n'affectera aucun paramètre de configuration placé dans des fichiers tels que php.in. De plus, cela ne supprimera pas le progiciel installé sur le système.