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 /plesk_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 and $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éé. Vous trouverez la liste complète des variables disponibles dans la section suivante. 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 panneau de contrôle Plesk 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 que vous pouvez utiliser lorsque vous paramétrez un gestionnaire d'événements, se reporter au Guide Administrateur avancé du panneau de contrôle Plesk disponible sur le site Web de Parallels.