Añadiendo Gestores de Eventos (Alojamiento Linux)

Pongamos, por ejemplo, que creamos un gestor de eventos para el evento 'creación de cuenta de cliente'. El gestor aceptar un nombre de cliente y las credenciales del cliente desde las variables de entorno. Por motivos de simplicidad, usaremos un shell-script denominado test-handler.sh que tiene la siguiente apariencia:

#!/bin/bash

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

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

/usr/bin/id >> /tmp/event_handler.log # información sobre el usuario en cuyo nombre se ha ejecutado el script (para garantizar control)

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

echo "name: ${NEW_CONTACT_NAME}" >> /tmp/event_handler.log # nombre del cliente

echo "login: ${NEW_LOGIN_NAME}" >> /tmp/event_handler.log # nombre de usuario del cliente

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


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

Supongamos que nuestro script se encuentra en el directorio /parallels_plesk_panel_installation_directory/bin (por ejemplo). Lo registramos creando un gestor de evento a través del panel de control:

  1. Vaya a Inicio > Administrador de Eventos (en el grupo Registros y Estadísticas).
  2. Haga clic en Añadir Gestor de Eventos Nuevo. Aparecerá la página de configuración de gestores de evento.
  3. En el menú Evento, seleccione el evento al que desea añadir un gestor.
  4. Seleccione la prioridad de la ejecución del gestor o indique un valor personalizado. Para ello, vaya al menú 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 distintas prioridades (un valor superior corresponde a una prioridad ms elevada).

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

Nota: En el script, hemos indicado las variables $NEW_CONTACT_NAME y $NEW_LOGIN_NAME. Durante la ejecución del gestor, estas variables serán reemplazadas por el nombre y el nombre de usuario del cliente creado. En la Guía de Administración Avanzada de Parallels Plesk Panel, encontrará la lista completa de todas las variables disponibles. Puede descargar esta guía en el sitio Web de Parallels (en inglés).

Tenga en cuenta que en el caso de operaciones de eliminación, no se definen las variables de tipo $NEW_xxx. En las operaciones de creación, no se definen los parámetros de tipo $OLD_xxx.

Si ahora accede a Parallels Plesk Panel, crea un nuevo cliente e indica el valor 'Some Client' 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 a /tmp/event_handler.log:

Fri Mar 16 15:57:25 NOVT 2007

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

client created

name: Some client

login: some_client

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

Si desea consultar la lista completa de plantillas de parámetros que puede usar cuando configure en gestor de eventos, consulte la Guía de Administración Avanzada de Parallels Plesk Panel, disponible en el sitio Web de Parallels (en inglés).