Démarrage du daemon PHP (avancé)

Sauf indication contraire, l'installation standard de l'agent PHP démarrera automatiquement le daemon s'il détecte qu'il n'est pas en cours d'exécution. La clé de licence est configurée pour l'agent dans un fichier PHP INI et peut être modifiée par répertoire ou par hôte virtuel. Le daemon est également configuré via le fichier de configuration de l'agent (INI).

Démarrage automatique de newrelic-daemon (mode agent)

Ce mode utilise les paramètres de votre fichier INI pour configurer le daemon. Il démarre également automatiquement le daemon si l'agent détecte que le daemon n'est pas déjà en cours d'exécution. C'est ce qu'on appelle parfois le « mode agent ».

En mode de démarrage automatique :

• La configuration du daemon et tous les autres paramètres globaux se trouvent dans votre fichier ini PHP global.
• L'agent démarre automatiquement le daemon à chaque démarrage (à chaque redémarrage d'Apache/PHP-FPM ou lorsque vous démarrez l'agent sur la ligne de commande).
• Écrivez les autorisations d'accès dans le fichier daemon de log control qui peut démarrer le daemon.
• L'en-tête de démarrage dans le fichier php-agent.log inclut « agent » pour indiquer le mode de démarrage automatique.

Pour utiliser le mode de démarrage de l’agent :

1. Assurez-vous que le daemon n'est pas en cours d'exécution en exécutant /etc/init.d/newrelic-daemon stop.
2. Assurez-vous que /etc/newrelic/newrelic.cfg n'existe pas . Si c'est le cas, déplacez-le ailleurs ou supprimez-le.
3. Modifiez votre fichier INI et définissez les options liées au daemon. Ces options sont également documentées dans le fichier modèle INI situé à /usr/lib/newrelic-php5/scripts/newrelic.ini.template.
4. Redémarrez votre serveur Web ou votre gestionnaire de processus PHP pour récupérer les nouveaux paramètres.

Sélection du mode manuel (externe)

En mode manuel, vous devez démarrer le daemon et le serveur Web pour démarrer l'agent. Ceci est également appelé mode « externe ». Voici quelques exemples de raisons pour lesquelles vous souhaiterez peut-être utiliser le mode manuel au lieu du mode de démarrage automatique :

• Vous gérez un site multi-locataire où chaque client a le contrôle de son propre service Web. Vous ne souhaitez pas que tous les locataires exécutent leur propre copie privée du daemon. Par conséquent, en fournir une qui est démarrée au démarrage du système et partagée entre tous les locataires, vous utilisez mieux les ressources de votre système. Chaque client peut fournir sa propre clé de licence privée dans ses fichiers INI (ou vous fournissez la clé de licence sur une base d'hôte virtuel).
• Vous souhaitez conserver la possibilité d'arrêter le daemon sans affecter les temps de disponibilité de votre serveur Web. Ce mode garantit que si vous devez arrêter le daemon, il restera arrêté jusqu'à ce que vous redémarriez le système ou que vous le redémarriez explicitement.
• Vous voulez que le daemon s'exécute en tant que root (ou un autre utilisateur avec les autorisations appropriées) afin que le fichier de log ne soit pas exposé à quiconque sauf root ou un utilisateur spécial. Le fichier de log daemon a le potentiel, bien que faible, de contenir des données sensibles.
• Vous êtes plus à l'aise avec le service daemon démarré par un script d'initialisation traditionnel.

Démarrage manuel newrelic-daemon

En mode de démarrage manuel (ou externe) :

• La configuration du daemon est dans newrelic.cfg.
• Le daemon démarre soit au démarrage du système, soit en exécutant son script de démarrage.
• Le fichier de log et les permissions du fichier de configuration contrôlent quel utilisateur peut démarrer et arrêter le daemon.
• L'en-tête de démarrage dans le fichier php-agent.log inclut init pour indiquer le mode de démarrage manuel.

Si votre fichier de configuration de daemon se trouve à /etc/newrelic/newrelic.cfg, l'agent ne tente pas de démarrer automatiquement le daemon. Si vous avez déplacé ce fichier et souhaitez toujours utiliser cette méthode de démarrage, ajoutez ce qui suit à votre fichier INI global : newrelic.daemon.dont_launch = 3.

Si vous souhaitez utiliser cette méthode de démarrage externe :

1. Aller à :

   bash

   Copier

   $
   cp /etc/newrelic/newrelic.cfg.template /etc/newrelic/newrelic.cfg

2. Modifiez /etc/newrelic/newrelic.cfg et ajustez les valeurs requises.

3. Exécutez /etc/init.d/newrelic-daemon restart.

4. Redémarrez votre serveur Web ou votre gestionnaire de processus PHP afin de récupérer les nouveaux paramètres.