Tapahtumakäsittelijöiden lisääminen

1. Siirry kohtaan Työkalut ja asetukset

2. Napsauta

3. Valitse ”Tapahtuma”-luettelosta tapahtuma, joka käynnistää käsittelijän.

4. Määritä kohdassa ”Prioriteetti” käsittelijän suoritusprioriteetti valitsemalla se luettelosta tai kirjoittamalla mukautettu numero kenttään. Prioriteetti on tärkeä, jos määrität useita käsittelijöitä yhdelle tapahtumalle. Tässä tapauksessa käsittelijät käynnistyvät prioriteettinsa mukaan laskevassa järjestyksessä (tapahtuma käynnistää ensin korkeimman prioriteetin omaavan käsittelijän, seuraavaksi toiseksi korkeimman ja niin edelleen).

5. Valitse ”Käyttäjä”-luettelosta järjestelmän käyttäjä, jonka puolesta käsittelijä suoritetaan.

   Muista: Palvelimen järjestelmänvalvoja voi luoda tapahtumakäsittelijöitä, jotka suoritetaan palvelimella käyttäjän root puolesta. Jos haluat rajoittaa root-tilin käyttöä, luo tyhjä tiedosto nimellä

6. Kirjoita ”Komento”-kenttään shell-skriptin tai .bat-tiedoston polku, joka sisältää komennot, jotka suoritetaan aina, kun tapahtumakäsittelijä käynnistyy (esimerkiksi /usr/local/psa/bin/script.sh tai C:\Windows\Temp\script.bat).

   Muista: Varmista, että skriptilläsi on suoritusoikeus. Voit tehdä sen suorittamalla seuraavan komennon: chmod 755 <script.sh>

7. Napsautau00a0**OK**.

Tapahtumaparametrien välittäminen

Aina kun tapahtumakäsittelijä käynnistyy, se välittää tapahtumaan liittyviä tietoja (”Tapahtumaparametrit”) (välitettävät tiedot riippuvat kyseisestä tapahtumakäsittelijästä). Esimerkiksi ”Toimialue luotu” -tapahtumakäsittelijä välittää seuraavat parametrit:

• Äskettäin luodun toimialueen nimi.

• Äskettäin luodun toimialueen GUID.

• Uuden toimialueen omistavan asiakastilin GUID.

Kukin parametri välitetään ympäristömuuttujana, jota voit käyttää shell-skriptissäsi tai .bat-tiedostossasi seuraavasti:

Plesk Windowsille

Käytä .bat-tiedostossasi paikanvaraajaa %N (esimerkiksi ”%1”) ja lisää halutun ympäristömuuttujan nimi vastaavaan paikkaan komennon loppuun tapahtumakäsittelijän asetuksissa. Seuraavassa esimerkissä

paikanvaraaja ”%1” korvataan ympäristömuuttujan ”NEW_DOMAIN_NAME” arvolla, ja ”%2” korvataan arvolla ”NEW_DOMAIN_GUID”. Jos käytät ”%3” .bat-tiedostossa, sitä ei korvata millään, koska komennon jälkeen määritettiin vain kaksi ympäristömuuttujan nimeä.

Täydellisen luettelon tapahtumaparametreista ja niihin liittyvistä ympäristömuuttujien nimistä kullekin tapahtumakäsittelijälle löydät täältä.

Viitteeksi, tässä on kaksi esimerkkiskriptiä tapahtumalle ‘Asiakastili luotu’:

• (Plesk Linuxille) test-handler.sh

  #!/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 "customer created" >> /tmp/event_handler.log # information on the created customer account
  echo "name: ${NEW_CONTACT_NAME}" >> /tmp/event_handler.log # customer's name
  echo "login: ${NEW_LOGIN_NAME}" >> /tmp/event_handler.log # customer's username in Plesk
  echo "--------------" >> /tmp/event_handler.log
  

• (Plesk Windowsille) test-handler.bat

  echo "--------------" >> c:\windows\temp\event_handler.log
  rem information on the event date and time
  date /T   >> c:\windows\temp\event_handler.log
  rem information on the created customer account
  echo "customer created" >> c:\windows\temp\event_handler.log
  rem customer's name
  echo "name: %1"       >> c:\windows\temp\event_handler.log
  rem customer's username in Plesk
  echo "login: %2"      >> c:\windows\temp\event_handler.log
  echo "--------------" >> c:\windows\temp\event_handler.log
  

Jos kirjaudut

• (Plesk Linuxille)

  Fri Mar 16 15:57:25 NOVT 2007
  uid=0(root) gid=0(root) groups=0(root)
  customer created
  name: John Doe
  login: john_doe
  

• (Plesk Windowsille)

  Mon March 15 21:46:34 NOVT 2010
  customer created
  name: John Doe
  login: john_doe
  

Tapahtumakäsittelijöiden muokkaaminen ja poistaminen

Voit nähdä luettelon tällä hetkellä aktiivisista tapahtumakäsittelijöistä siirtymällä kohtaan Työkalut ja asetukset > Tapahtumanhallinta. Täältä voit myös muokata ja poistaa tapahtumakäsittelijöitä:

• Voit muokata tapahtumakäsittelijää napsauttamalla sen nimeä, tekemällä haluamasi muutokset ja napsauttamalla OK.

• Voit poistaa tapahtumakäsittelijän valitsemalla vastaavan valintaruudun ja napsauttamalla Poista.

Tapahtumakäsittelijöiden käyttäminen WP Toolkitin kanssa

WP Toolkitin toiminnot käynnistävät Plesk-tapahtumia, ja järjestelmänvalvojat voivat liittää skriptinsä käyttämällä tavallisia tapahtumakäsittelijöitä.

WP Toolkit käynnistää tavallisia Plesk-tapahtumia aina, kun se suorittaa tiettyjä toimintoja. Tietoja tapahtumakäsittelijöiden tarkastelusta, muokkaamisesta ja poistamisesta on kohdassa Tapahtumakäsittelijöiden muokkaaminen ja poistaminen.