Ikoula - Solutions d'Hebergement : Domaines, Packs, Serveurs...
ikoula.com
  A Propos
  Technologies
  Emploi 
  Espace Presse
  Support 
Connexion   FR|EN

Live Help
Petites Entreprises >
  Moyennes & Grandes Entreprises >
  Developpeurs & Revendeurs >
 
 

Menu principal
Accueil Support
Ouvrir un Ticket
Historique des tickets
Explorer base de connaissances
Etat du reseau

Login
 Login:
 Password:

Base de connaissance


(Entrez les mots cles separes par des espaces. Par exemple: produit garantie information)

Infogérance avec Ikoula

Anti-Spam

R1Soft
Base de connaissances
Utiliser le gestionnaire d'événements
Top : Serveur Dédié : Serveur Dédié Linux : Serveur Linux Plesk : Manuel Administrateur : Configurez votre système

ID de l'article: 001717
Note: 0.0 / 5.0 (0 votes)
Lu: 782

Probleme
Utiliser le gestionnaire d'événements

Solution
Le gestionnaire d'événements est destiné à vous aider à organiser l'échange de données entre Plesk et des systèmes externes. Il fonctionne de la façon suivante : créez un script qui s'exécutera lors d'un événement donné du panneau de contrôle, puis créez un gestionnaire d'événements qui déclenchera le traitement de l'événement. Vous pouvez affecter plusieurs gestionnaires à un seul événement.

IMPORTANT

L'administrateur de Plesk peut créer les gestionnaires d'événements qui seront exécutés sur le serveur au nom de l'utilisateur root. Si vous souhaitez restreindre l'utilisation du compte root, créez un fichier vide nommé root.event_handler.lock dans /usr/local/psa/var/.

Ajouter un gestionnaire d'événements

Créons par exemple un gestionnaire d'événements pour l'événement 'création d'un compte client'. Le gestionnaire prend comme premier paramètre le nom du client et comme second paramètre le login du client. Pour plus de simplicité nous utilisons un script de 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 la date et l'heure de l'événement
/usr/bin/id           >> /tmp/event_handler.log # information sur l'utilisateur, au nom duquel le script a été exécuté (pour garantir le contrôle)
echo "client created" >> /tmp/event_handler.log # information sur le compte client créé
echo "name: $1"       >> /tmp/event_handler.log # nom du client
echo "login: $2"      >> /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 est situé dans le répertoire /usr/local/psa/bin/ (par exemple). Enregistrons-le en créant un gestionnaire d'événements via le panneau de contrôle:

  1. Sélectionnez le raccourci Serveur dans le volet de navigation.

  2. Dans la page d'administration du serveur cliquez sur l'icône Gestionnaire d'événements. La page du gestionnaire d'événements s'ouvre.

  3. Sélectionnez l'icône Nouveau gestionnaire d'événements. La page des propriétés du gestionnaire d'événements s'ouvre :

  4. Choisissez l'événement auquel vous voulez affecter un gestionnaire dans la liste déroulante 'Evénements'.

  5. Choisissez le degré de priorité pour l'exécution du gestionnaire ou indiquez une valeur de votre choix. Pour cela, sélectionnez 'Personnalisée' dans la liste déroulante 'Priorité' puis tapez la valeur dans le champ. Remarque : 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).

  6. Sélectionnez l'utilisateur système au nom duquel le gestionnaire sera exécuté.

  7. Dans le champ 'Commande' entrez la commande devant s'exécuter quand l'événement sélectionné se produit. Dans notre exemple, c'est la commande /usr/local/psa/bin/test-handler.sh <new_contact_name> <new_login_name>.

  8. Cliquez sur OK.

Remarque

Dans la commande, nous avons écrit les paramètres entre crochets obliques <new_contact_name> et <new_login_name>. Avant que le gestionnaire ne soit lancé, ces paramètres seront remplacés par le nom et le login du client créé. La liste complète des paramètres disponibles est donnée à la section suivante. Souvenez-vous que pour les opérations de suppression, les paramètres de type new_xxx contiennent une chaîne vide. Et suite pour les opérations de création, les paramètres de type old_xxx contiennent une chaîne vide.

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 'Contact name', et 'some_client' dans le champ 'Login', le gestionnaire sera appelé et les enregistrements suivants seront ajoutés au journal /tmp/event_handler.log :

--------------
	Sat Jun 26 21:46:34 NOVT 2004
	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.

Supprimer des gestionnaires d'événements

Pour supprimer un ou plusieurs gestionnaire(s) d'événements, cochez les cases correspondantes dans la liste puis cliquez sur 'Supprimer la sélection'.

Templates de paramètres existants pour gestionnaires d'événements

Les templates de paramètres qu'il est possible d'utiliser pour configurer un gestionnaire d'événements sont indiqués dans le tableau ci-dessous.

Tableau 2.1.

Nom du composant/descriptionParamètres de la ligne de commandeCommentaires
Ancienne valeur du composantNouvelle valeur du composant
Pour la 'Création d'un compte client', 'Mise à jour d'un compte client' et 'Suppression d'un compte client'
Nom de loginold_login_namenew_login_nameobligatoire
Nom du contactold_contact_namenew_contact_nameobligatoire
Sociétéold_company_namenew_company_name
Téléphoneold_phonenew_phone
Faxold_faxnew_fax
E-mailold_emailnew_email
Adresseold_addressnew_address
Villeold_citynew_city
Département/régionold_state_provincenew_state_province
Code postalold_postal_zip_codenew_postal_zip_code
Paysold_countrynew_country
Pour la 'Création de domaine', 'Mise à jour de domaine' 'Suppression de domaine'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Pour la 'Création de sous-domaine', 'Mise à jour de sous-domaine' 'Suppression de sous-domaine'
Nom du sous-domaineold_subdomain_namenew_subdomain_nameobligatoire
Nom du domaine parentold_domain_namenew_domain_nameobligatoire
Compte FTPold_system_user_typenew_system_user_type
Nom de login de l'administrateur du sous-domaineold_system_usernew_system_user
Quota de disque durold_hard_disk_quotanew_hard_disk_quota
Support SSIold_ssi_supportnew_ssi_support
Support PHPold_php_supportnew_php_support
Support CGIold_cgi_supportnew_cgi_support
Support Perlold_mod_perl_supportnew_mod_perl_support
Support Pythonold_mod_python_supportnew_mod_python_support
Support ColdFusionold_coldfusion_supportnew_coldfusion_support
Apache : support ASPold_apache_asp_supportnew_apache_asp_support
Support SSLold_ssl_supportnew_ssl_support
Pour la 'Création d'hébergeur physique', 'Mise à jour d'hébergeur physique'
Nom du domaineold_domain_namenew_domain_nameobligatoire
ADRESSE IPold_ip_addressnew_ip_address
Type d'IPold_ip_typenew_ip_type
Utilisateur systèmeold_system_usernew_system_user
Mot de passe utilisateur systèmeold_system_user_passwordnew_system_user_password
Accès shellold_system_shellnew_system_shell
Support FPold_fp_supportnew_fp_support
Support FP-SSLold_fpssl_supportnew_fpssl_support
Composition FPold_fp_authoringnew_fp_authoring
Login administrateur FPold_fp_admin_loginnew_fp_admin_login
Mot de passe administrateur FPold_fp_admin_passwordnew_fp_admin_password
Support SSIold_ssi_supportnew_ssi_support
Support PHPold_php_supportnew_php_support
Support CGIold_cgi_supportnew_cgi_support
Support Mod Perlold_mod_perl_supportnew_mod_perl_support
Support Apache ASPold_apache_asp_supportnew_apache_asp_support
Support SSLold_ssl_supportnew_ssl_support
Statistiques Webold_web_statisticsnew_web_statistics
Documents d'erreurs personnalisésold_apache_error_documentsnew_apache_error_documents
Quota de disque durold_hard_disk_quotanew_hard_disk_quota
Pour la 'Suppression d'un hébergement physique'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Pour la 'Création d'une adresse de courrier électronique', 'Suppression d'une adresse de courrier électronique'
Adresse de courrier électroniqueold_mailnamenew_mailnameobligatoire (au format mailname@domain)
Pour la 'Mise à jour d'une adresse de courrier électronique'
Adresse de courrier électroniqueold_mailnamenew_mailnameobligatoire (au format mailname@domain)
Boîte aux lettresold_mailboxnew_mailbox
Mot de passeold_passwordnew_password
Quota de boîte aux lettresold_mailbox_quotanew_mailbox_quota
Redirectionold_redirectnew_redirect
Adresse de la redirectionold_redirect_addressnew_redirect_address
Groupe de messagerieold_mail_groupnew_mail_group
Répondeurs automatiquesold_autorespondersnew_autoresponders
Accès au panneau de contrôle des utilisateurs de messagerieold_mail_controlpanel_accessnew_mail_controlpanel_access
Pour la 'Suppression d'un utilisateur Web'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Nom de l'utilisateur Webold_webuser_namenew_webuser_nameobligatoire
Pour la 'Création d'un utilisateur Web', 'Mise à jour d'un utilisateur Web'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Nom de l'utilisateur Webold_webuser_namenew_webuser_nameobligatoire
Mot de passe de l'utilisateur Webold_webuser_passwordnew_webuser_password
Support SSIold_ssi_supportnew_ssi_support
Support PHPold_php_supportnew_php_support
Support CGIold_cgi_supportnew_cgi_support
Support Mod Perlold_mod_perl_supportnew_mod_perl_support
Support Mod Pythonold_mod_python_supportnew_mod_python_support
Support Apache ASPold_apache_asp_supportnew_apache_asp_support
Quota de disque durold_hard_disk_quotanew_hard_disk_quota
Pour la 'Mise à jour des limites pour le client'
Nom du contactold_contact_namenew_contact_nameobligatoire
Nombre maximum de domainesold_maximum_domainsnew_maximum_domains
Espace disque maximumold_maximum_disk_spacenew_maximum_disk_space
Trafic maximumold_maximum_trafficnew_maximum_traffic
Nombre maximum d'utilisateurs Webold_maximum_webusersnew_maximum_webusers
Nombre maximum de bases de donnéesold_maximum_databasesnew_maximum_databases
Nombre maximum de boîtes aux lettresold_maximum_mailboxesnew_maximum_mailboxes
Quota de boîte aux lettresold_maximum_mailbox_quotanew_maximum_mailbox_quota
Nombre maximum de redirections de courrierold_maximum_mail_redirectsnew_maximum_mail_redirects
Nombre maximum de groupes de messagerieold_maximum_mail_groupsnew_maximum_mail_groups
Nombre maximum de répondeurs automatiquesold_maximum_mail_autorespon dersnew_maximum_mail_autorespon ders
Nombre maximum de listes de diffusionold_maximum_mail_listsnew_maximum_mail_lists
Nombre maximum d'applications Javaold_maximum_tomcat_web_appli cationsnew_maximum_tomcat_web_appli cations
Date d'expirationold_expiration_datenew_expiration_date
Pour la 'Mise à jour des limites du domaine'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Espace disque maximumold_maximum_disk_spacenew_maximum_disk_space
Trafic maximumold_maximum_trafficnew_maximum_traffic
Nombre maximum d'utilisateurs Webold_maximum_webusersnew_maximum_webusers
Nombre maximum de bases de donnéesold_maximum_databasesnew_maximum_databases
Nombre maximum de boîtes aux lettresold_maximum_mailboxesnew_maximum_mailboxes
Quota de boîte aux lettresold_maximum_mailbox_quotanew_maximum_mailbox_quota
Nombre maximum de redirections de courrierold_maximum_mail_redirectsnew_maximum_mail_redirects
Nombre maximum de groupes de messagerieold_maximum_mail_groupsnew_maximum_mail_groups
Nombre maximum de répondeurs automatiquesold_maximum_mail_autorespon dersnew_maximum_mail_autorespon ders
Nombre maximum de listes de diffusionold_maximum_mail_listsnew_maximum_mail_lists
Nombre maximum d'applications Javaold_maximum_tomcat_web_appli cationsnew_maximum_tomcat_web_appli cations
Date d'expirationold_expiration_datenew_expiration_date
Pour la 'Création d'une liste de diffusion', 'Mise à jour d'une liste de diffusion' et 'Suppression d'une liste de diffusion'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Nom de la liste de diffusionold_mail_list_namenew_mail_list_nameobligatoire
Liste de diffusion activéeold_mail_list_enablednew_mail_list_enabled
Pour les événements 'Utilisateur du panneau de contrôle s'est connecté' et 'Utilisateur du panneau de contrôle s'est déconnecté',
Nom du contactold_contact_namenew_contact_name
Pour la 'Mise à jour du compte de l'administrateur du domaine'
Autoriser l'accès à l'administrateur du domaineold_allow_domain_user_accessnew_allow_domain_user_access
Nom de loginold_login_namenew_login_nameobligatoire
Nom du domaineold_domain_namenew_domain_nameobligatoire
Nom du contactold_contact_namenew_contact_name
Sociétéold_company_namenew_company_name
Téléphoneold_phonenew_phone
Faxold_faxnew_fax
E-mailold_emailnew_email
Adresseold_addressnew_address
Villeold_citynew_city
Département/régionold_state_provincenew_state_province
Code postalold_postal_zip_codenew_postal_zip_code
Paysold_countrynew_country
Pour l'Installation d'une application', la 'Reconfiguration d'une application' et 'Désinstallation d'une application'
Nom du pack d'applicationsold_site_application_package_ namenew_site_application_package_ nameobligatoire
Type de domaine (domaine ou sous-domaine)old_site_application_domain_typenew_site_application_domain_typeobligatoire
Chemin d'installation (httpdocs ou httpsdocs)old_site_application_directorynew_site_application_directoryobligatoire
Chemin d'installation dans le répertoire de destinationold_site_application_installation_ prefixnew_site_application_installation_ prefixobligatoire
Pour l'Installation d'un pack d'applications' et la 'Désinstallation d'un pack d'applications'
Nom du pack d'applicationsold_site_application_package_ namenew_site_application_package_ nameobligatoire
Pour 'Arrêt, démarrage ou redémarrage du service'
Serviceold_servicenew_serviceobligatoire
Pour la 'Création, modification ou suppression d'une adresse IP'
Adresse IPold_ip_addressnew_ip_addressobligatoire
Masque IPold_ip_masknew_ip_mask
Interfaceold_interfacenew_interface
Type d'IPold_ip_typenew_ip_type
Pour la 'Création, modification ou suppression d'un transfert'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Type de transfertold_forwarding_typenew_forwarding_type
URLold_urlnew_url
Pour la 'Modification des informations sur l'administrateur'
Nom de loginold_login_namenew_login_nameobligatoire
Nom du contactold_contact_namenew_contact_name
Sociétéold_company_namenew_company_name
Numéro de téléphoneold_phonenew_phone
Faxold_faxnew_fax
E-mailold_emailnew_email
Adresseold_addressnew_address
Villeold_citynew_city
Département/régionold_state_provincenew_state_province
Code postalold_postal_zip_codenew_postal_zip_code
Paysold_countrynew_country
Pour l'Installation, reconfiguration et désinstallation d'une application'
Nom de l'applicationold_package_namenew_package_nameobligatoire
Pour la 'Mise à jour du statut du client'
Nom du contactold_contact_namenew_contact_nameobligatoire
Nom de loginold_login_namenew_login_nameobligatoire
Statutold_statusnew_status
Pour la 'Mise à jour des préférences du client'
Nom du contactold_contact_namenew_contact_nameobligatoire
Nom de loginold_login_namenew_login_nameobligatoire
Taille de la pageold_lines_per_pagenew_lines_per_page
Skin d'interfaceold_interface_skinnew_interface_skin
Pour la 'Modification du pool d'adresses IP du client'
Nom du contactold_contact_namenew_contact_nameobligatoire
Adresse IPold_ip_addressnew_ip_addressobligatoire
Statutold_statusnew_status
Pour l'événement 'Limite d'espace disque atteinte pour le compte client'
Espace disque maximumold_maximum_disk_spacenew_maximum_disk_spaceobligatoire
Pour l'événement 'Limite de trafic atteinte pour le compte client'
Limite du traficold_maximum_trafficnew_maximum_traffic
Pour la 'Modification du statut du domaine'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Statut du domaineold_statusnew_status
Pour la 'Mise à jour de la zone DNS pour le domaine'
Nom du domaineold_domain_namenew_domain_nameobligatoire
Pour l'événement 'Espace disque maximum atteint pour un domaine'
Espace disque maximumold_maximum_disk_spacenew_maximum_disk_space
Pour l'événement 'Limite de trafic atteinte pour un domaine'
Limite du traficold_maximum_trafficnew_maximum_traffic
Pour la 'Mise à jour de la clé de licence'
Numéro de la clé de licenceold_licensenew_licenseobligatoire
Type de la clé de licence (Plesk, supplémentaire)old_license_typenew_license_type
Nom de la clé de licence (pour les clés supplémentaires)old_license_namenew_license_name

Note
Avez vous trouve cet article utile?

Articles lies
Utiliser le gestionnaire de fichiers
Utiliser le gestionnaire de fichiers