Cron

Alguns mòduls del Moodle necessiten comprovar si han de tirar endavant les tasques. Per exemple, el Moodle necessita comprovar els fòrums per si cal enviar còpies dels missatges enviats per la gent que hi ha subscrita.

L'escript que fa aquesta feina és al directori d'administració, i s'anomena cron.php. De totes maneres, no pot arrencar sol, i cal establir el mecanisme perquè l'escript treballi regularment (per exemple, cada cinc o deu minuts). Així se li proporciona una mena de "marcapassos" que farà que l'escript faci aquesta feina en períodes definits per cada mòdul. Aquesta mena de mecanisme es coneix com a servei cron.

L'escript cron.php revisa tots els directoris de mòduls cercant fitxers cron.php i els executa. Aquests fitxers poden contenir funcions de neteja, de correu electrònic o qualsevol feina que calgui per treballar de forma regular. Per exemple, el cron activa el sistema per fer les còpies de seguretat de cursos el dia i hora especificats als paràmetres d'administració. També activa els mòduls de missatgeria o els de les notificacion s de missatges als fòrums, però quan el cron s'activa no s'executen totes les accions. Algunes funcions, com ara les d'anul·lació d'inscripcions per desús, o l'eliminació de còpies antigues de fitxers de registre, que treballen més rarament. El fitxer cron.php té una secció que executarà aquestes tasques fonamentals aproximadament una vegada de cada cinc que el cron funcioni.

Penseu que la màquina que farà treballar el cron no cal que sigui la mateixa que la que té el Moodle. Per exemple, si teniu un servei web hostatjat limitat que no us permet tenir un servei cron, aleshores haureu de fer córrer el cron en un altre servidor o al vostre ordinador. Es tracta que el cron.php hagi d'actuar regularment.

La càrrega d'aquest escript no ha de ser gaire alta, i 5 minunts marquen un ritme normalment raonable, però si us ha de portar problemes, podeu reduir el període a 15 o 30 minuts. És millor no allargar gaire el període, perquè demorar la sortida de correu pot alentir l'activitat dins dels cursos. Recordeu que la sortida del correu també espera que s'acabi el temps marcat d'edició d'un missatge per enviar-lo.

Primerament, comproveu que l'escript treballa correctament fent-li una crida directa des del navegador: http://exemple.com/moodle/admin/cron.php

Si el cron el crida des de la línia de comandes qualsevol usuari identificat al Moodle, crearà un entorn temporal d'administració, a fi de fer córrer i més tard tornar a l'entorn de l'usuari. Podreu inhabilitat l'execució des de la línia de comandes desactivant la secció corresponent al fitxer cron.php.

Ara cal preparar-lo perquè l'escript s'executi automàticament i regular.

En sistemes Windows

Hi ha dues maneres de configurar el cron.php del Moodle en sistemes Windows:

• Utilitzar el Paquet Cron del Moodle. La manera més senzilla çonsisteix a utilitzar aquest paquet moodle-cron-for-windows.exe que resol l'assumpte amb la instal·lació d'un servei Windows. Carregueu-lo i no us en torneu a preocupar! :-)

• Utilitzeu una Tasca planificada. Si, d'altra banda, teniu algun problema amb el paquet cron-moodle-per_a-windows, podeu fer servir wget per al Windows o el php des de la línia de comandes i preparar una tasca planificada. Podeu seguir aquests passos:

Podeu utilitzar el php.exe (binari de línia de comandes) que s'instal·la a la carpeta php (per exemple, a c:\php), o el wget. Fixeu-vos que obtindreu un rendiment millor si feu servir l'opció del php.exe. Si voleu fer servir el wget, descarregueu-ne una versió compilada per al Windows a la pàgina del wget per a Windows de Heiko Herolds (http://xoomer.virgilio.it/hherold/) o a la pàgina del wget per a Windows de Bart Puype (http://users.ugent.be/~bpuype/wget/). Si feu servir la versió de Heiko Herold, copieu tots els fitxers .DLL al directori C:\Windows\system32. Copieu el fitxer wget.exe a c:\windows (així assegurareu que el wget arrencarà sempre que calgui).

1. Preparació d'una Tasca planificada.
   1. Aneu a Inicia >> Tauler de control >> Tasques planificades >> Addició d'una tasca planificada
   2. Feu clic a "Endavant" per iniciar l'assistent:
   3. Feu clic al botó "Navega..." i aneu fins al fitxer c:\php\php.exe o c:\windows\wget.exe i feu clic a "Obre"
   4. Introduïu "Cron del Moodle" com a nom de la tasca i seleccioneu "Diàriament" com a planificació. Feu clic a "Endavant"
   5. Seleccioneu "12:00" com a hora d'inici, Fes aquesta tasca "Cada dia" i avui com a data d'inici. Feu clic a "Endavant".
   6. Introduïu el nom d'usuari i el mot de pas de l'usuari que ha d'engegar la tasca (no cal que sigui un compte privilegiat). No escrigueu malament el mot de pas. Feu clic a "Endavant".
   7. Marqueu el quadre de verificació "Obre les propietats avançades per a aquesta tasca quan faci clic a Final" i feu clic a "Final"
   8. Al diàleg que apareix, escriviu el que segueix al quadre d'edició "Executar:" :

      c:\windows\wget.exe -q -O NUL http://el_meu_lloc_moodle/moodle/admin/cron.php

      o

      c:\php\php.exe -f c:\moodle\admin\cron.php

      Canvieu "c:\moodle" amb el camí al directori moodle o "el_meu_lloc_moodle" amb el nom del vostre lloc.
      
      
   9. Feu clic a la pestanya "Programa" i allà al botó "Opcions avançades ...".
   10. Marqueu el quadre de selecció "Repeteix la tasca" i establiu "Cada: " a 5 minuts, i "Fins a: " a "Durada" i escriviu "23" a hores i "59" a minuts.
   11. Feu clic a "D'acord" i haureu acabat.
2. Comprovació de la tasca planificada. Podeu comprovar si la tasca planificada pot fer la feina programada fent un clic amb el botó dret i triant "Executa". Si tot està ben lligat, veureu momentàniament com s'obre una finestra DOS mentre el wget/php executa i porta a la pàgina del cron i desapareix. Si recupereu la finestra amb la llista de tasques planificades, podreu veure la "Darrer temps d'execució" (en una visualització per Detall) que reflecteix el moment actual i que la darrera columna mostra "0x0" (tot ha anat bé). Si qualsevol d'aquests valors és diferent, aleshores hauríeu de revisar els paràmetres de la tasca.

---

Per estalviar-vos tot el procés descrit anteriorment, també podeu utilitzar el paquet paquete moodle-cron-for-windows.exe que hauria d'instal·lar automàticament el servei Windows.

En serveis web hostatjats

El tauler de control web del servidor deu tenir una pàgina que us permeti preparar aquest procés del cron.

Si us trobeu amb el CPanel, entreu i cerqueu el títol "Avançat" (Advanced) a la pàgina. Feu clic a Cron Jobs -> Advanced (unix style). Escriviu el que segueix al cron per activar-lo cada 30 minuts.

Email address for output: correu@el_meu_domini.com
Minute:*/30
Hour:*
Day:*
Month:*
Weekday:* 
Command: wget -q -O /dev/null http://www.el_meu_domini.com/moodle/admin/cron.php

Feu clic a Desa els canvis (Commit Changes). Comproveu que arriba el correu al vostre ordinador. Aquí en teniu un exemple:

En altres sistemes, cerqueu un botó anomenat "Tasques del Cron" (Cron jobs). Des d'aquí podreu establir les comandes Unix tal com es presenten una mica més avall.

La línia de comandes Unix

Hi ha diversos programes de comandes que es poden fer servir per activar la pàgina des de la línia de comandes. I possiblement cada servidor en té algun, però no tots.

Per exemple, es pot fer servir una utilitat del Unix anomenada 'wget':

wget -q -O /dev/null http://example.com/moodle/admin/cron.php

Fixeu-vos que la sortida d'aquest exemple es deixaria com a brossa (cap a /dev/null).

Alguns usuaris del Moodle han observat que 'wget' falla algunes vegades. Especialment si teniu problemes amb dipòsits de correu que no s'hagin enviat regularment cada dia a tots els usuaris. Una comanda alternativa per resoldre el problema és:

php http://example.com/moodle/admin/cron.php

El mateix fent servir el lynx:

lynx -dump http://example.com/moodle/admin/cron.php > /dev/null

En aquest exemple la sortida també es deixaria com a brossa (cap a /dev/null).

Com una alternativa, podríeu fer servir una versió compilada del PHP perquè s'executés des de línia de comandes. L'avantatge de fer-ho d'aquesta manera és que els registres del servidor no s'emplenarien de requestes constants al cron.php. El desavantatge és que cal un accés a la versió de línia de comandes del PHP.

/opt/bin/php /web/moodle/admin/cron.php

Ús del programa crontab al Unix

L'únic que fa el CPanel és proporcionar una interfície web a una utilitat Unix que s'anomena crontab. Si teniu una línia de comandes podeu preparar el crontab directament amb la comanda:

crontab -e

i afegint una de les comandes anteriors, com ara:

*/30 * * * * wget -q -O /dev/null http://example.com/moodle/admin/cron.php

Les primeres cinc entrades són del temps que caldrà executar la comanda, seguides de la comanda per executar. Els asterisc és un comodí que vol dir qualsevol moment. A l'exemple anterior es diu que s'executi la comanda wget -q -O /dev/null... cada 30 minuts (*/30), cada hora (*), cada dia del mes (*), cada mes (*), cada dia de la setmana (*).

• Un manualet bàsic del crontab
• Versió en línia de la pàgina man

Per a principiants, "EDITOR=nano crontab -e" permetrà editar el crontab amb l'ajut de l'editor nano editor. Ubuntu fa servir per defecte el nano.

Normalment, la comanda "crontabe -e" us obre l'editor 'vi'. Passareu al mode d'edició prement la tecla "i" i immediatament podreu escriure la línia d'abans, finalment sortiu prement ESC. I desareu i sortireu escrivint ":wq", o sortir sense desar amb ":q!" (sense les cometes). Aquí trobareu una introducció a l'editor 'vi'.

Vegeu també

• la discussió al fòrum Using Moodle Cron - can someone give me a quick confirmation of function?