Ajouter les gestionnaires d'événements (pour l'hébergement Linux)

Créons par exemple un gestionnaire d'événements pour l'événement 'création d'un compte client'. Le gestionnaire acceptera un nom de client et le login du client à partir des variables de l'environnement. Pour plus de simplicité, nous utilisons un script shell appelé test-handler.sh et qui se présente comme suit :

#!/bin/bash

echo "--------------" >> /tmp/event_handler.log

/bin/date >> /tmp/event_handler.log # informations sur l'heure et la date de l'événement

/usr/bin/id >> /tmp/event_handler.log # informations sur l'utilisateur, au nom duquel le script a été exécuté (pour garantir un certain contrôle)

echo "client created" >> /tmp/event_handler.log # informations sur le compte client créé

echo "name: ${NEW_CONTACT_NAME}" >> /tmp/event_handler.log # nom du client

echo "login: ${NEW_LOGIN_NAME}" >> /tmp/event_handler.log # login du client

echo "--------------" >> /tmp/event_handler.log


Ce script imprime quelques informations dans un fichier pour qu'il soit possible de contrôler son exécution (il n'est pas possible d'exporter des informations dans stdout/stderr, car le script est exécuté en arrière-plan).

Supposons que notre script se trouve dans le répertoire /parallels_plesk_panel_installation_directory/bin (par exemple). Enregistrons-le en créant un gestionnaire d'événements via le panneau de contrôle :

  1. Allez dans Accueil > Gestionnaire d'événements (dans le groupe Logs & Statistiques).
  2. Cliquez sur Nouv. gestionnaire d'événements. La page des propriétés du gestionnaire d'événements s'ouvre.
  3. Choisissez l'événement auquel vous voulez affecter un gestionnaire dans la menu Evénements.
  4. Choisissez le degré de priorité pour l'exécution du gestionnaire ou indiquez une valeur de votre choix. Pour ce faire, sélectionnez 'Personnalisée' dans le menu Priorité puis tapez la valeur dans le champ.

    Quand vous affectez plusieurs gestionnaires à un seul événement, vous pouvez préciser l'ordre d'exécution des gestionnaires, en configurant des priorités différentes (une plus grande valeur correspond à une priorité plus élevée).

  5. Sélectionnez l'utilisateur du système au nom duquel le gestionnaire sera exécuté (utilisateur "root", par exemple).
  6. Dans la zone de saisie Commande entrez la commande devant s'exécuter quand l'événement sélectionné se produit. Dans notre exemple, il s'agit de /usr/local/psa/bin/test-handler.sh.
  7. Cliquez sur OK.

Remarque : Dans le script, nous avons indiqué les variables $NEW_CONTACT_NAME et $NEW_LOGIN_NAME. Au cours de l'exécution du gestionnaire, elles seront remplacées respectivement par le nom et le login du client créé. La liste complète des variables est indiquée dans le Guide d'administration avancée (anglais) de Parallels Plesk Panel disponible à partir du site Web de Parallels.

Vous devez garder à l'esprit qu'avec les opérations de suppression, les variables de type $NEW_xxx ne sont pas définies. De même pour les opérations de création, les paramètres de type $OLD_xxx ne sont pas définis.

Maintenant, si vous vous connectez à votre Parallels Plesk Panel et créez un nouveau client en indiquant comme valeur 'Some client' dans le champ Nom du contact, et 'some_client' dans le champ Login, le gestionnaire sera appelé et les enregistrements suivants seront ajoutés au journal /tmp/event_handler.log :

Vend 16 Mars 15:57:25 NOVT 2007

uid=0(root) gid=0(root) groups=0(root)

client created

name: Some client

login: some_client

Si vous voulez indiquer un voire plusieurs gestionnaire(s) supplémentaire(s), répétez les étapes ci-dessus.

Pour une liste complète des templates de paramètres qui peuvent être utilisés lors de la configuration d'un gestionnaire d'événements, reportez-vous au Guide de l'administration avancée de Parallels Plesk Panel disponible à partir du site Web de Parallels.