agent PHP installation: PHP non standard (avancé)

Si vous utilisez une installation PHP non standard, suivez cette procédure pour installer correctement New Relic. Ceci est courant dans les cas où le programme d'installation par défaut ne trouve pas votre installation PHP (par exemple, si vous avez PHP auto-compilé ou une stack PHP autonome).

Exigences

Utilisez la version en ligne de commande de PHP (php -i) ou regardez la sortie de phpinfo() pour déterminer :

• La version de l'extension PHP (20090626, 20100525, 20121212, 20131226, 20151012 ou 20160303)
• Le répertoire d'installation de l'extension ou du module
• Que votre version de PHP ait été compilée ou non avec le support ZTS (Zend Thread Safety)

Les options ZTS s'appliquent uniquement aux versions 9.17 et antérieures de l'agent PHP. ZTS n'est pas disponible pour les versions PHP 9.18 ou supérieures.

Utilisez le script de ligne de commande newrelic-install (recommandé)

1. Dirigez New Relic vers le bon répertoire en utilisant l’une de ces options :

   Ajoutez votre emplacement PHP à votre PATH

   Le script d'installation doit pouvoir trouver votre ligne de commande php ou php-config. Vous pouvez ajouter le répertoire qui contient ces programmes à votre PATH actuel.

   Définir le NR_INSTALL_PATH

   Il peut s'agir d'une liste de répertoires séparés par des deux points pour l'installation de PHP en plus de ceux de votre PATH. Assurez-vous que ces répertoires contiennent php ou php-config. Par exemple:

   bash

   Copier

   $
   NR_INSTALL_PATH=/u/php/5.3/bin; export NR_INSTALL_PATH
   $
   newrelic-install

   Définir le NR_INSTALL_PHPLIST

   Facultatif : utilisez une liste séparée par deux points pour définir les emplacements exacts (répertoires) dans lesquels effectuer la recherche. Cette option ignorera PATH et NR_INSTALL_PATH. Par exemple:

   bash

   Copier

   $
   NR_INSTALL_PHPLIST=/usr/local/bin:u/php/5.3/bin; export NR_INSTALL_PHPLIST
   $
   newrelic-install

2. Appelez le script newrelic-install depuis son répertoire. En fonction de votre serveur et de vos chemins, le script d'installation peut trouver d'autres versions de PHP sur votre système. Sélectionnez votre version spécifique dans la liste.

Pour plus d'informations, voir le script d'installation PHP.

Installer New Relic manuellement

Si vous ne souhaitez pas utiliser le script d'installation, vous pouvez effectuer une installation entièrement manuelle. Assurez-vous de rassembler des informations sur votre installation PHP. Vous pouvez consulter et obtenir les valeurs appropriées à partir de votre phpinfo(). Créez ensuite et liez ou copiez les fichiers à leur emplacement manuellement.

Récupérer les paramètres installation depuis phpinfo()

Si ce processus ne fonctionne pas pour vous, vous pouvez obtenir les informations correctes auprès de votre phpinfo() et transmettre les paramètres appropriés à votre système en tant que variables d'environnement.

Utilisez ces informations pour exécuter les commandes suivantes pour installer le module PHP. Assurez-vous d'ajuster les valeurs de l'exemple à vos paramètres réels.

$
NRBASEDIR=/usr/lib/newrelic-php5; export NRBASEDIR
$
    MODULEDIR=/usr/lib/php/modules; export MODULEDIR
$
    ARCH=x64; export ARCH
$
    PHPAPI=20090626; export PHPAPI
$
    PHPZTS="-zts"; export PHPZTS
$
    rm -f $MODULEDIR/newrelic.so
$
    ln -s $NRBASEDIR/agent/$ARCH/newrelic-${PHPAPI}${PHPZTS}.so \
>
      $MODULEDIR/newrelic.so

configurationmanuelle

L'étape suivante est la configuration.

1. Copiez le $NRBASEDIR/scripts/newrelic.ini.template dans le répertoire à partir duquel votre installation PHP lit les fichiers de configuration supplémentaires et renommez-le newrelic.ini.

   Pour déterminer la destination, regardez votre sortie phpinfo() pour l'élément, appelé Scan this dir for additional .ini files. Si le répertoire répertorié est (none), ajoutez les paramètres de ce fichier à vos fichiers de configuration PHP répertoriés (généralement php.ini).

2. Remplacez le paramètre de clé de licence dans votre fichier newrelic.ini par votre clé de licence. Modifiez également les autres sessions selon vos besoins (par exemple, newrelic.appname).

3. Copiez $NRBASEDIR/daemon/newrelic-daemon.$architecture vers /usr/bin/newrelic-daemon.

   Selon votre système, $architecture sera soit x86 soit x64.

4. Redémarrez votre répartiteur/serveur Web.

5. Vérifiez que votre site fonctionne correctement. Si ce n’est pas le cas, supprimez newrelic.ini ou le newrelic.so que vous avez créé et redémarrez votre répartiteur/serveur Web pour restaurer l’ancienne opération.

6. Examinez les fichiers logs de votre serveur Web/répartiteur (pas newrelic) pour vous aider à déterminer le problème. Si vous avez encore besoin d'aide, obtenez de l'aide sur support.newrelic.com.

Vérifier l'installation

Vérifiez que l'agent est installé après le redémarrage, en examinant la page phpinfo() pour une section newrelic . S'il semble que l'agent a été installé avec succès, vérifiez votre système pour vérifier que deux processus newrelic-daemon sont en cours d'exécution :

• Pour les systèmes basés sur RedHat :

  bash

  Copier

  $
  ps -aef | grep newrelic-daemon

• Pour les systèmes basés sur Debian :

  bash

  Copier

  $
  ps aux | grep newrelic-daemon

Générez du trafic sur votre application, puis attendez trois à cinq minutes pour que les résultats arrivent sur votre page APM Summary .