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 :
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).
/usr/local/psa/bin/test-handler.sh
.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.