Event handlers toevoegen (Linux-hosting)

Laten we bijvoorbeeld een event handler toevoegen voor het event 'aanmaken cliëntaccount'. De handler accepteert een cliëntnaam en de aanmeldgegevens van de cliënt vanuit de omgevingsvariabelen. Om het makkelijk te maken zullen we een shellscript gebruiken met de naam test-handler.sh. Dit bestand ziet er als volgt uit:

#!/bin/bash

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

/bin/date >> /tmp/event_handler.log # informatie over de datum en tijd van het event

/usr/bin/id >> /tmp/event_handler.log # informatie over de gebruiker namens wie het script is uitgevoerd (om controle te verzekeren)

echo "client created" >> /tmp/event_handler.log # informatie over het aangemaakte cliëntaccount

echo "naam: ${NIEUWE_CONTACTNAAM}" >> /tmp/event_handler.log # naam van de cliënt

echo "gebruikersnaam: ${NIEUWE_GEBRUIKERSNAAM}" >> /tmp/event_handler.log # gebruikersnaam van de cliënt

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


Dit script schrijft een aantal gegevens naar een bestand, zodat we de uitvoering kunnen controleren (we kunnen geen informatie wegschrijven naar stdout/stderr, aangezien het script op de achtergrond wordt uitgevoerd).

Laten we ervan uitgaan dat ons script zich bevindt in de map /plesk_installatiemap/bin (bijvoorbeeld). Laten we deze registreren door via Plesk Panel een event handler aan te maken:

  1. Ga naar Home > Event Manager.
  2. Klik Nieuwe Event Handler Toevoegen. De pagina voor het instellen van een event handler verschijnt:
  3. Selecteer in het menu Event het event waaraan u een handler wilt toewijzen.
  4. Selecteer de prioriteit voor het uitvoeren van de handler, of geef een aangepaste waarde op. Om dit te doen, selecteert u aangepast in het menu Prioriteit en voert u vervolgens de juiste waarde in.

    Wanneer u verschillende handlers toewijst aan één enkel event, dan kunt u, door verschillende prioriteiten toe te kennen, de volgorde aangeven waarin de handlers moeten worden uitgevoerd; hogere waarden komen overeen met een hogere prioriteit.

  5. Selecteer de systeemgebruiker namens welke de handler zal worden uitgevoerd (bijvoorbeeld de gebruiker "root").
  6. In het invoerveld Opdracht geeft u de opdracht op die moet worden uitgevoerd wanneer het geselecteerde event plaats vindt. In ons voorbeeld is dit /usr/local/psa/bin/test-handler.sh.
  7. Klik OK.

Opmerking. In het script hebben we de variabelen $NEW_CONTACT_NAME en $NEW_LOGIN_NAME opgegeven. Tijdens de uitvoering van de handler zullen deze worden vervangen door de naam en gebruikersnaam van de cliënt die is aangemaakt. De gehele lijst met beschikbare variabelen wordt in de volgende sectie weergegeven. Houdt u er rekening mee dat bij verwijderingsopdrachten de variabelen van het type $NEW_xxx niet zijn ingesteld. En bij aanmaakopdrachten zullen de parameters van het type $OLD_xxx niet zijn ingesteld.

Nu kunt u zich bij Parallels Plesk Panel aanmelden en een nieuwe cliënt aanmaken, waarbij u de waarde 'Een of andere cliënt' opgeeft in het veld Contactnaam en 'een_of_andere_client' in het veld Gebruikersnaam. De handler zal worden aangeroepen en de volgende records zullen worden toegevoegd aan het bestand /tmp/event_handler.log:

Fri Mar 16 15:57:25 NOVT 2007

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

cliënt aangemaakt

naam: Een of andere cliënt

gebruikersnaam: een_of_andere_client

Als u nog één of een aantal extra handlers wilt opgeven, herhaal dan de bovenstaande acties.

Voor een volledige lijst van de parametersjablonen die kunnen worden gebruikt bij het instellen van eventhandlers, zie de (Engelstalige) handleiding Parallels Plesk Panel Advanced Administration Guide, die beschikbaar is vanaf de website van Parallels.