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