### Añadiendo Gestores de Evento

Por ejemplo, vayamos a crear un gestor de evento para el evento 'creación de cuenta de cliente'. El gestor aceptará un nombre de cliente y el nombre de usuario del cliente desde variables del entorno. Para simplificarlo usaremos un shell-script denominado `test-handelr.sh` que tiene la siguiente apariencia:

#!/bin/bash

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

/bin/date >> /tmp/event_handelr.log # información de la fecha y hora del evento

/usr/bin/id >> /tmp/event_handelr.log # información del usuario, en nombre del cual se ejecuta el script (para garantizar el control)

echo "client created" >> /tmp/event_handelr.log # información de la cuenta de cliente creada

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

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

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

Este script imprime alguna información en un archivo para que se puede controlar su ejecución (no podemos introducir información en stdout/stderr ya que el script se ejecuta en modo de fondo).

Supongamos que su script está ubicado en el directorio `/plesk_installation_directory/bin`. Lo registramos creando un gestor de evento a través del panel de control:

1. En el panel de navegación haga clic en el acceso directo de Servidor.
2. Haga clic en el icono Administrador de Eventos dentro del grupo Panel de Control.
3. Haga clic en el icono Añadir Nuevo Gestor de Evento r. Aparecerá la página de configuración del gestor de evento:
4. Seleccione el evento a asignar al gestor dentro de la casilla desplegable Evento.
5. Seleccione la prioridad de la ejecución del gestor o indique un valor personalizado. Para ello, vaya a la lista desplegable Prioridad e introduzca el valor deseado.

   Cuando se asignan múltiples gestores a un único evento, puede indicar la secuencia de ejecución del gestor ajustando las diferentes prioridades (un valor superior corresponde a una prioridad más elevada).

6. Seleccione el usuario de sistema, en nombre del cual se ejecutará el gestor (usuario "root", por ejemplo).
7. En el campo de entrada Comando indique un comando a ejecutarse para el evento seleccionado. En nuestro ejemplo es `/usr/local/psa/bin/test-handler.sh`.
8. Haga clic en OK.

Nota: En el script, hemos indicado las variables $NEW_CONTACT_NAME y $NEW_LOGIN_NAME. Mientras se ejecuta el gestor, se sustituirán con el nombre y nombre de usuario del cliente creado respectivamente. En la siguiente sección se ofrece la lista completa de variables disponibles. Debe tener en cuenta que eliminando operaciones, no se configuran las variables$NEW_xxx. Con las operaciones de creación no se configuran los parámetros del tipo $OLD_xxx.

Si ahora accede al panel de control Plesk, crea un nuevo cliente e indica el valor 'Algún Cliente' en el campo Nombre de Contacto y 'some_client' en el campo Nombre de Usuario, se invocará al gestor y se añadirán los siguientes registros en `/tmp/event_handelr.log`:

Fri Mar 16 15:57:25 NOVT 2007

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

cliente creado

nombre: Algún cliente

nombre de usuario: some_client

Si desea indicar uno o más gestores, repita la operación para cada uno de los nuevos gestores.

Las plantillas de parámetro que pueden usarse cuando se configura un nuevo gestor de evento se muestran en la tabla siguiente:

Tabla. Plantillas Disponibles de Parámetro de Gestor de Evento

Nombre del componente y descripción | Nombre de la variable de entorno | Notas | Notas
Valor usado anteriormente | Valor nuevo | Para los eventos 'Cuenta de Cliente Creada', 'Cuenta de Cliente Actualizada', 'Cuenta de Cliente eliminada' | Nombre de usuario
old_login_name | new_login_name | requerido | requerido | Nombre de contacto
old_contact_name | new_contact_name | requerido | requerido | Nombre de la Empresa
old_company_name | new_company_name |  |  | Teléfono
old_phone | new_phone |  |  | Fax
old_fax | new_fax |  |  | E-mail
old_email | new_email |  |  | Dirección
old_address | new_address |  |  | Ciudad
old_city | new_city |  |  | Estado/Provincia
old_state_province | new_state_province |  |  | Código Postal
old_postal_zip_code | new_postal_zip_code |  |  | País
old_country | new_country |  |  | Para los eventos 'Dominio creado', 'Dominio Actualizado', 'Dominio eliminado' | Para los eventos 'Dominio creado', 'Dominio Actualizado', 'Dominio eliminado'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Para los eventos 'Subdominio creado', 'Subdominio actualizado', 'Subdominio eliminado' | Para los eventos 'Subdominio creado', 'Subdominio actualizado', 'Subdominio eliminado'
Nombre de Subdominio | old_subdomain_name | new_subdomain_name | requerido | requerido
Nombre de Dominio Padre | old_domain_name | new_domain_name | requerido | requerido
cuenta FTP | old_system_user_type | new_system_user_type |  |
Nombre de usuario del administrador del Subdominio | old_system_user | new_system_user |  |
Cuota de disco duro | old_hard_disk_quota | new_hard_disk_quota |  |
Soporte SSI | old_ssi_support | new_ssi_support |  |
Soporte PHP | old_php_support | new_php_support |  |
Soporte CGI | old_cgi_support | new_cgi_support |  |
Soporte Perl | old_mod_perl_support | new_mod_perl_support |  |
Soporte Python | old_mod_python_support | new_mod_python_support |  |
Soporte ColdFusion | old_coldfusion_support | new_coldfusion_support |  |
Apache:: soporte ASP | old_apache_asp_support | new_apache_asp_support |  |
Soporte SSL | old_ssl_support | new_ssl_support |  |
Para los eventos 'Alias de dominio creado, actualizado, eliminado, zona DNS eliminada' | Para los eventos 'Alias de dominio creado, actualizado, eliminado, zona DNS eliminada'
Nombre del alias de dominio | OLD_DOMAIN_ALIAS_NAME | NEW_DOMAIN_ALIAS_NAME | requerido | requerido
Alias de dominio activado o desactivado | old_status | new_status |  |
Servicio web para alias de dominio activado o desactivado | OLD_DOMAIN_ALIAS_WEB | NEW_DOMAIN_ALIAS_WEB |  |
Servicio de correo para alias de dominio activado o desactivado | OLD_DOMAIN_ALIAS_MAIL | NEW_DOMAIN_ALIAS_MAIL |  |
Soporte para acceder a aplicaciones web en java para visitantes del alias de dominio (activado o desactivado) | OLD_DOMAIN_ALIAS_TOMCAT | NEW_DOMAIN_ALIAS_TOMCAT |  |
Para los eventos 'Alojamiento Físico creado', Alojamiento Físico Actualizado' | Para los eventos 'Alojamiento Físico creado', Alojamiento Físico Actualizado'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Dirección IP | old_ip_address | new_ip_address |  |
Tipo IP | old_ip_type | new_ip_type |  |
Usuario de Sistema | old_system_user | new_system_user |  |
Contraseña del usuario de sistema | old_system_user_password | new_system_user_password |  |
Acceso Shell | old_system_shell | new_system_shell |  |
Soporte FP | old_fp_support | new_fp_support |  |
Soporte FP-SSL | old_fpssl_support | new_fpssl_support |  |
FP Authoring | old_fp_authoring | new_fp_authoring |  |
Nombre de usuario admin FP | old_fp_admin_login | new_fp_admin_login |  |
Contraseña Admin FP | old_fp_admin_password | new_fp_admin_password |  |
Soporte SSI | old_ssi_support | new_ssi_support |  |
Soporte PHP | old_php_support | new_php_support |  |
Soporte CGI | old_cgi_support | new_cgi_support |  |
Soporte Perl | old_mod_perl_support | new_mod_perl_support |  |
Soporte Apache ASP | old_apache_asp_support | new_apache_asp_support |  |
Soporte SSL | old_ssl_support | new_ssl_support |  |
Estadísticas Web | old_web_statistics | new_web_statistics |  |
Documentos de Error Personalizados | old_apache_error_documents | new_apache_error_documents |  |
Cuota de disco duro | old_hard_disk_quota | new_hard_disk_quota |  |
Para el evento 'Alojamiento Físico Eliminado' | Para el evento 'Alojamiento Físico Eliminado'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Para los eventos 'Nombre de correo creado', 'nombre de correo eliminado' | Para los eventos 'Nombre de correo creado', 'nombre de correo eliminado'
Nombre de correo | old_mailname | new_mailname | requerido (en formato mailname@domain) | requerido (en formato mailname@domain)
Para el evento 'Nombre de correo actualizado' | Para el evento 'Nombre de correo actualizado'
Nombre de correo | old_mailname | new_mailname | requerido (en formato mailname@domain) | requerido (en formato mailname@domain)
Buzón de Correo | old_mailbox | new_mailbox |  |
Contraseña | old_password | new_password |  |
Cuota de buzón de Correo | old_mailbox_quota | new_mailbox_quota |  |
Remitir | old_redirect | new_redirect |  |
Dirección de Redireccionamiento | old_redirect_address | new_redirect_address |  |
Grupo de Correo | old_mail_group | new_mail_group |  |
Autorespondedores | old_autoresponders | new_autoresponders |  |
Acceso al Panel de Control del Usuario de Correo | old_mail_controlpanel_access | new_mail_controlpanel_access |  |
Para el evento 'usuario Web eliminado' | Para el evento 'usuario Web eliminado'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Nombre del Usuario Web | old_webuser_name | new_webuser_name | requerido | requerido
Para los eventos 'usuario Web creado', 'usuario Web actualizado' | Para los eventos 'usuario Web creado', 'usuario Web actualizado'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Nombre del Usuario Web | old_webuser_name | new_webuser_name | requerido | requerido
Contraseña del usuario web | old_webuser_password | new_webuser_password |  |
Soporte SSI | old_ssi_support | new_ssi_support |  |
Soporte PHP | old_php_support | new_php_support |  |
Soporte CGI | old_cgi_support | new_cgi_support |  |
Soporte Perl | old_mod_perl_support | new_mod_perl_support |  |
Soporte Python | old_mod_python_support | new_mod_python_support |  |
Soporte Apache ASP | old_apache_asp_support | new_apache_asp_support |  |
Cuota de disco duro | old_hard_disk_quota | new_hard_disk_quota |  |
Para el evento 'Límites de Cliente actualizados' | Para el evento 'Límites de Cliente actualizados'
Nombre de contacto | old_contact_name | new_contact_name | requerido | requerido
Número máximo de Dominios | old_maximum_domains | new_maximum_domains |  |
Cantidad Máxima de Espacio de Disco | old_maximum_disk_space | new_maximum_disk_space |  |
Cantidad Máxima de Tráfico | old_maximum_traffic | new_maximum_traffic |  |
Número Máximo de Usuarios Web | old_maximum_webusers | NEW_MAXIMUM_WEBUSERS |  |
Número Máximo de Bases de Datos | OLD_MAXIMUM_DATABASES | NEW_MAXIMUM_DATABASES |  |
Número Máximo de Buzones de Correo | OLD_MAXIMUM_MAILBOXES | NEW_MAXIMUM_MAILBOXES |  |
Cuota de buzón de Correo | OLD_MAXIMUM_MAILBOX_QUOTA | NEW_MAXIMUM_MAILBOX_QUOTA |  |
Número Máximo de Redireccionadores de Correo | OLD_MAXIMUM_MAIL_REDIRECTS | NEW_MAXIMUM_MAIL_REDIRECTS |  |
Número Máximo de Grupos de Correo | OLD_MAXIMUM_MAIL_GROUPS | NEW_MAXIMUM_MAIL_GROUPS |  |
Número Máximo de Autorespondedores de Correo | OLD_MAXIMUM_MAIL_AUTORESPONDERS | NEW_MAXIMUM_MAIL_AUTORESPONDERS |  |
Número Máximo de Listas de Correo | OLD_MAXIMUM_MAIL_LISTS | NEW_MAXIMUM_MAIL_LISTS |  |
Número máximo de aplicaciones java | OLD_MAXIMUM_TOMCAT_WEB_APPLICATIONS | NEW_MAXIMUM_TOMCAT_WEB_APPLICATIONS |  |
Fecha de Expiración | OLD_EXPIRATION_DATE | NEW_EXPIRATION_DATE |  |
Para el evento 'Límites de Dominio actualizados' | Para el evento 'Límites de Dominio actualizados'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Cantidad Máxima de Espacio de Disco | old_maximum_disk_space | new_maximum_disk_space |  |
Cantidad Máxima de Tráfico | old_maximum_traffic | new_maximum_traffic |  |
Número Máximo de Usuarios Web | old_maximum_webusers | NEW_MAXIMUM_WEBUSERS |  |
Número Máximo de Bases de Datos | OLD_MAXIMUM_DATABASES | NEW_MAXIMUM_DATABASES |  |
Número Máximo de Buzones de Correo | OLD_MAXIMUM_MAILBOXES | NEW_MAXIMUM_MAILBOXES |  |
Cuota de buzón de Correo | OLD_MAXIMUM_MAILBOX_QUOTA | NEW_MAXIMUM_MAILBOX_QUOTA |  |
Número Máximo de Redireccionadores de Correo | OLD_MAXIMUM_MAIL_REDIRECTS | NEW_MAXIMUM_MAIL_REDIRECTS |  |
Número Máximo de Grupos de Correo | OLD_MAXIMUM_MAIL_GROUPS | NEW_MAXIMUM_MAIL_GROUPS |  |
Número Máximo de Autorespondedores de Correo | OLD_MAXIMUM_MAIL_AUTORESPONDERS | NEW_MAXIMUM_MAIL_AUTORESPONDERS |  |
Número Máximo de Listas de Correo | OLD_MAXIMUM_MAIL_LISTS | NEW_MAXIMUM_MAIL_LISTS |  |
Número máximo de aplicaciones java | OLD_MAXIMUM_TOMCAT_WEB_APPLICATIONS | NEW_MAXIMUM_TOMCAT_WEB_APPLICATIONS |  |
Fecha de Expiración | OLD_EXPIRATION_DATE | NEW_EXPIRATION_DATE |  |
Para los eventos 'Lista de correo creada', 'Lista de correo actualizada', 'Lista de Correo eliminada' | Para los eventos 'Lista de correo creada', 'Lista de correo actualizada', 'Lista de Correo eliminada'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Nombre de la Lista de Correo | OLD_MAIL_LIST_NAME | NEW_MAIL_LIST_NAME | requerido | requerido
Lista de Correo activada | OLD_MAIL_LIST_ENABLED | NEW_MAIL_LIST_ENABLED |  |
Para los eventos 'Usuario de Panel de Control Conectado', 'Usuario de Panel de Control Desconectado' | Para los eventos 'Usuario de Panel de Control Conectado', 'Usuario de Panel de Control Desconectado'
Nombre de contacto | old_contact_name | new_contact_name |  |
Para el evento 'Cuenta de Administrador de Dominio actualizada' | Para el evento 'Cuenta de Administrador de Dominio actualizada'
Permitir acceso al administrador de dominio | OLD_ALLOW_DOMAIN_USER_ACCESS | NEW_ALLOW_DOMAIN_USER_ACCESS |  |
Nombre de usuario | old_login_name | new_login_name | requerido | requerido
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Nombre de contacto | old_contact_name | new_contact_name |  |
Nombre de la Empresa | old_company_name | new_company_name |  |
Teléfono | old_phone | new_phone |  |
Fax | old_fax | new_fax |  |
E-mail | old_email | new_email |  |
Dirección | old_address | new_address |  |
Ciudad | old_city | new_city |  |
Estado/Provincia | old_state_province | new_state_province |  |
Código Postal | old_postal_zip_code | new_postal_zip_code |  |
País | old_country | new_country |  |
Para los eventos 'Aplicación de Sitio instalada', 'Aplicación de Sitio reconfigurada', ' Aplicación de Sitio desinstalada' | Para los eventos 'Aplicación de Sitio instalada', 'Aplicación de Sitio reconfigurada', ' Aplicación de Sitio desinstalada'
Nombre del paquete de aplicación de sitio | old_package_name | new_package_name | requerido | requerido
Tipo de dominio (dominio o subdominio) | OLD_DOMAIN_TYPE | NEW_DOMAIN_TYPE | requerido | requerido
Ruta de instalación (httpdocs o httpsdocs) | OLD_DIRECTORY | NEW_DIRECTORY | requerido | requerido
Ruta de instalación dentro del directorio de destino | OLD_INSTALLATION_PREFIX | NEW_INSTALLATION_PREFIX | requerido | requerido
Para los eventos 'Paquete de aplicación de sitio instalado', 'Paquete de aplicación de sitio desinstalado' | Para los eventos 'Paquete de aplicación de sitio instalado', 'Paquete de aplicación de sitio desinstalado'
Nombre del paquete de aplicación de sitio | old_package_name | new_package_name | requerido | requerido
Para los eventos 'Servicio detenido, iniciado o reiniciado' | Para los eventos 'Servicio detenido, iniciado o reiniciado'
Servicio | OLD_SERVICE | NEW_SERVICE | requerido | requerido
Para los eventos 'Dirección IP creada, cambiada o eliminada' | Para los eventos 'Dirección IP creada, cambiada o eliminada'
Dirección IP | old_ip_address | new_ip_address | requerido | requerido
Máscara IP | old_ip_mask | new_ip_mask |  |
Interfaz | old_interface | new_interface |  |
Tipo IP | old_ip_type | new_ip_type |  |
Para los eventos 'Reenvío creado, cambiado o eliminado' | Para los eventos 'Reenvío creado, cambiado o eliminado'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Tipo de Reenvío | old_forwarding_type | new_forwarding_type |  |
URL | old_url | new_url |  |
Para el evento 'Información del administrador modificada' | Para el evento 'Información del administrador modificada'
Nombre de usuario | old_login_name | new_login_name | requerido | requerido
Nombre de contacto | old_contact_name | new_contact_name |  |
Nombre de la Empresa | old_company_name | new_company_name |  |
Teléfono | old_phone | new_phone |  |
Fax | old_fax | new_fax |  |
E-mail | old_email | new_email |  |
Dirección | old_address | new_address |  |
Ciudad | old_city | new_city |  |
Estado/Provincia | old_state_province | new_state_province |  |
Código Postal | old_postal_zip_code | new_postal_zip_code |  |
País | old_country | new_country |  |
Para los eventos 'Aplicación de Sitio instalada, reconfigurada, desinstalada' | Para los eventos 'Aplicación de Sitio instalada, reconfigurada, desinstalada'
Nombre de la Aplicación de Sitio | old_package_name | new_package_name | requerido | requerido
Para los eventos 'Estado de cliente actualizado' | Para los eventos 'Estado de cliente actualizado'
Nombre de contacto | old_contact_name | new_contact_name | requerido | requerido
Nombre de usuario | old_login_name | new_login_name | requerido | requerido
Estado | old_status | new_status |  |
Para los eventos 'Preferencias del Cliente actualizadas' | Para los eventos 'Preferencias del Cliente actualizadas'
Nombre de contacto | old_contact_name | new_contact_name | requerido | requerido
Nombre de usuario | old_login_name | new_login_name | requerido | requerido
Tamaño de la página | OLD_LINES_PER_PAGE | NEW_LINES_PER_PAGE |  |
Skin de Interfaz | old_interface_skin | new_interface_skin |  |
Para el evento 'Inventario de IP de clientes modificado' | Para el evento 'Inventario de IP de clientes modificado'
Nombre de contacto | old_contact_name | new_contact_name | requerido | requerido
Dirección IP | old_ip_address | new_ip_address | requerido | requerido
Estado | old_status | new_status |  |
Para el evento 'Límite de espacio de disco alcanzado para la cuenta del cliente' | Para el evento 'Límite de espacio de disco alcanzado para la cuenta del cliente'
Nombre de contacto | old_contact_name | new_contact_name | requerido | requerido
Límite de Espacio de Disco | old_maximum_disk_space | new_maximum_disk_space | requerido | requerido
Para los eventos 'Límite de tráfico alcanzado para la cuenta del cliente' | Para los eventos 'Límite de tráfico alcanzado para la cuenta del cliente'
Nombre de contacto | old_contact_name | new_contact_name | requerido | requerido
Límite de tráfico | old_maximum_traffic | new_maximum_traffic |  |
Para los eventos 'Estado de dominio modificado' | Para los eventos 'Estado de dominio modificado'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Estado del dominio | old_status | new_status |  |
Para el evento 'Zona DNS actualizada para el dominio' | Para el evento 'Zona DNS actualizada para el dominio'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Para el evento 'Límite de espacio de disco alcanzado para el dominio' | Para el evento 'Límite de espacio de disco alcanzado para el dominio'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Límite de Espacio de Disco | old_maximum_disk_space | new_maximum_disk_space |  |
Para el evento 'Límite de tráfico alcanzado para el dominio' | Para el evento 'Límite de tráfico alcanzado para el dominio'
Nombre del dominio | old_domain_name | new_domain_name | requerido | requerido
Límite de tráfico | old_maximum_traffic | new_maximum_traffic |  |
Para el evento 'Actualización de Clave de licencia' | Para el evento 'Actualización de Clave de licencia'
Número de Clave de licencia | old_license | new_license | Requerido | requerido
Tipo de clave de licencia (Plesk, adicional) | old_license_type | new_license_type |  |
Nombre de la clave de licencia (para claves adicionales) | old_license_name | new_license_name |  |