Añadiendo Gestores de Eventos (Alojamiento Linux)

Pongamos, por ejemplo, que creamos un gestor de evento para el evento 'creación de cuenta de cliente'. El gestor aceptará un nombre de cliente y las credenciales del cliente desde 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 # information on the event date and time

/usr/bin/id >> /tmp/event_handler.log # information on the user, on behalf of which the script was executed (to ensure control)

echo "client created" >> /tmp/event_handler.log # information on the created client account

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_handler.log


Este script imprime información en un archivo para que así podamos controlar su ejecución (no podemos introducir información en stdout/stderr, ya que el script se ejecute 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.
  2. Haga clic en Añadir Nuevo Gestor de Eventos. Aparecerá la página de configuración de gestores de evento.
  3. Seleccione el evento al que desea añadir un gestor en el menú Evento.
  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 diferentes prioridades (un valor superior corresponde a una prioridad más elevada).

  5. Seleccione el usuario de sistema, en nombre del cual se ejecutará el gestor (usuario "root", por ejemplo).
  6. 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.
  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, se sustituirán con el nombre y nombre de usuario del cliente creado respectivamente. En la siguiente sección le mostramos la lista completa de variables disponibles. Tenga en cuenta que en el caso de operaciones de eliminación no se definen las variables del 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 '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_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 nuevos gestores.

Si desea consultar la lista completa de plantillas de parámetro que puede usar cuando configure en gestor de eventos, consulte la Guía de Administración Avanzada de Parallels Plesk Panel, que encontrará en el sitio Web de Parallels.