Instal·lació del Moodle

Esta guia explica com instal·lar el Moodle per primera vegada. Detalla bastant alguns dels passos per tal de prendre en consideració les xicotetes diferències segons el tipus de servidor web. És per això que el document pot semblar llarg i complicat, però no vos preocupeu, generalment el Moodle es configura en uns minuts.

Llegiu tot el document amb atenció: vos estalviarà temps després.

Seccions d'este document:

  1. Requisits
  2. Baixada
  3. Estructura del lloc
  4. Creació del directori de dades
  5. Creació de la base de dades
  6. Comprovació dels paràmetres del servidor web
  7. Edició del config.php
  8. Pàgina d'administració
  9. Configuració del cron
  10. Creació d'un curs nou

 

1. Requisits

El Moodle es desenrotlla primordialment en Linux utilitzant Apache, MySQL i PHP (el que de vegades es coneix com a plataforma LAMP), però també es verifica regularment amb PostgreSQL i en els sistemes operatius Windows XP, Mac OS X i Netware 6.

Els requisits del Moodle són els següents:

  1. Un programari de servidor web. La majoria de la gent utilitza Apache, però el Moodle ha de funcionar perfectament amb qualsevol servidor que tinga PHP, com ara IIS en plataformes Windows.
  2. El llenguatge de seqüències PHP (versió 4.1.0 o posterior), amb els paràmetres següents:
    • Biblioteca GD activada, amb suport per a formats JPG i PNG.
    • Biblioteca zlib activada (si voleu fer servir les funcions de còpia de seguretat i restauració en Windows).
    • Suport per a sessions activat.
    • Càrrega de fitxers activada.
    • El mode segur ha d'estar desactivat (consulteu en els fòrums de moodle.org els problemes causats pel mode segur).
  3. Un servidor de bases de dades: MySQL o PostgreSQL tenen suport complet i es recomana el seu ús. Altres bases de dades tindran suport total en versions futures.

Molts servidors web oferixen per defecte estes funcionalitats. Si heu contractat un servidor que no les té, pregunteu al servici tècnic i plantegeu-vos la possibilitat de canviar de servidor.

Si voleu executar el Moodle en el vostre ordinador i tot això vos sembla una mica descoratjador, feu una ullada a esta guia: Instal·lació d'Apache, MySQL i PHP. Proporciona instruccions pas a pas per a instal·lar estos programaris en les plataformes més populars.

 

2. Baixada

Hi ha dos maneres d'obtindre el Moodle: en un paquet comprimit o per mitjà del CVS. Les dos s'expliquen fil per randa en la pàgina de baixada del Moodle: http://moodle.org/download/

Després de baixar i desempaquetar el fitxer, o revisar els fitxers via CVS, tindreu un directori anomenat "Moodle" que contindrà un nombre de fitxers i carpetes.

Podeu col·locar la carpeta completa en el directori de documents del vostre servidor web, en este cas el lloc quedarà situat en una adreça http://servidor.com/moodle, o podeu copiar tot el contingut directament en el directori arrel de documents del servidor web, en este cas el lloc serà simplement http://servidor.com.

 

3. Estructura del lloc

Heus ací, com a orientació, un resum ràpid dels continguts de la carpeta Moodle:

config-dist.php - Després fareu una còpia d'este fitxer i la guardareu amb el nom config.php. Este serà l'ÚNIC fitxer que vos caldrà editar per a començar.
version.php - Definix la versió present del codi del Moodle.
index.php - La pàgina inicial del lloc.

 

4. Creació del directori de dades

El Moodle necessita un poc d'espai al disc dur per a emmagatzemar els fitxers que es pengen, p. ex. els documents d'un curs o les fotos dels usuaris.

Creeu un directori en qualsevol part del servidor. Per seguretat és millor que este directori NO siga accessible directament via web. La manera més fàcil de fer-ho és situar-lo FORA del directori del web. Si no ho feu així, podeu protegir-lo creant, dins del mateix directori de dades, un fitxer anomenat .htaccess que continga esta línia:

deny from all
AllowOverride None

Per a assegurar-vos que el Moodle pot guardar fitxers en este directori, comproveu que el programari del servidor (p. ex. Apache) té permís d'escriptura en este directori. En màquines Unix açò significa establir el propietari del directori per a ser semblant a "nobodyú" o "apache".

En un servidor compartit, probablement haureu de restringir l'accés als fitxers al vostre "grup" (per a evitar que els propietaris d'altres servidors virtuals allojats en el mateix ordinador puguen veure o modificar els vostres fitxers) i alhora donar accés total de lectura/escriptura als altres usuaris (de manera que el servidor web puga accedir-hi). Parleu amb el vostre servici tècnic si teniu problemes.

 

5. Creació de la base de dades

Heu de crear una base de dades buida (p. ex. "moodle") en el vostre servidor de bases de dades, junt amb un usuari especial (p. ex. "moodleuser") que tinga accés a esta base de dades (i només a esta base de dades). Podeu utilitzar l'usuari "root" si voleu, però no és aconsellable: si algú descobrira la contrasenya estaria en perill tot el servidor de bases de dades, en lloc d'una sola base de dades.

Exemple de línia d'ordes de MySQL:

   # mysql -u root -p
   > CREATE DATABASE moodle; 
   > GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.* 
           TO moodleuser@localhost IDENTIFIED BY 'yourpassword'; 
   > quit 
   # mysqladmin -p reload

Exemple de línia d'ordes de PostgreSQL:

   # su - postgres
   > psql -c "create user moodleuser createdb;" template1
   > psql -c "create database moodle;" -U moodleuser template1
   > psql -c "alter user moodleuser nocreatedb;" template1

(Amb MySQL s'aconsella l'ús de phpMyAdmin per a gestionar les bases de dades amb una interfície web).

A partir de la versió 1.0.8, el Moodle permet usar un prefix en les taules, de manera que es pot compartir una base de dades amb altres aplicacions sense cap problema.

 

6. Comprovació dels paràmetres del servidor web

En primer lloc, aseegureu-vos que el servidor web està configurat per a utilitzar index.php com a pàgina per defecte (a més a més, probablement, d'index.html, default.htm i altres).

En Apache, això es fa per mitjà d'una directiva DirectoryIndex en el fitxer de configuració httpd.conf. Una cosa així:

DirectoryIndex index.php index.html index.htm 

Només cal que vos assegureu que index.php figura en la llista (preferiblement al capdavant, per eficiència).

En segon lloc, si esteu utilitzant Apache 2, hauríeu d'activar la variable AcceptPathInfo, que permet passar arguments als programes, així: http://servidor/fitxer.php/arg1/arg2. Això és essencial per al funcionament dels enllaços relatius entre els vostres recursos i, per tant, facilita la faena dels vostres usuaris. Podeu activar esta opció afegint estes línies al fitxerhttpd.conf:

AcceptPathInfo on 

En tercer lloc, el Moodle necessita per a funcionar que estiguen activats un nombre de paràmetres del PHP. En la majoria de servidors estos paràmetres són activats per defecte. Tanmateix, alguns servidors (i algunes versions recents de PHP) poden usar paràmetres diferents. Aleshores cal definir-los en el fitxer de configuració del PHP (generalment anomenat php.ini):

magic_quotes_gpc = 1    (preferible, però no necessari)
magic_quotes_runtime = 0    (necessari)
file_uploads = 1
session.auto_start = 0
session.bug_compat_warn = 0

Si no teniu accés a l'httpd.conf i al php.ini del vostre servidor, o si altres aplicacions del mateix servidor necessiten paràmetres diferents, no vos preocupeu podeu definir els paràmetres en el directori del Moodle.Per a fer-ho, heu de crear un fitxer anomenat .htaccess en el directori principal del Moodle que continga les definicions d'estos paràmetres. Però això només funcionarà en servidors Apache que permeten Overrides.

DirectoryIndex index.php index.html index.htm

<IfDefine APACHE2>
     AcceptPathInfo on
</IfDefine>

php_flag magic_quotes_gpc 1
php_flag magic_quotes_runtime 0
php_flag file_uploads 1
php_flag session.auto_start 0
php_flag session.bug_compat_warn 0

També podeu definir la grandària màxima dels fitxers que es pengen:

LimitRequestBody 0
php_value upload_max_filesize 2M
php_value post_max_size 2M
     

La via més fàcil és copiar el fitxer de mostra lib/htaccess i editar-lo adequadament a les vostres necessitats. Conté instruccions addicionals. Per exemple, en l'intèrpret d'ordes d'Unix:

cp lib/htaccess .htaccess

 

7. Edició del config.php

Ara podeu crear i editar el fitxer de configuració, config.php, usant un editor de text. Este fitxer és utilitzat per tots els altres fitxers del Moodle.

Per a començar feu una còpia de config-dist.php i anomeneu-la config.php. Fem això a fi de no sobreescriure el vostre config.php més avant quan actualitzeu la versió del Moodle.

Editeu config.php per a especificar els detalls de la base de dades que acabeu de definir (inclòs el prefix de les taules: un requisit necessari en el cas de PostgreSQL) i també l'adreça del lloc, el directori del sistema de fitxers i el directori de dades. Dins del fitxer de configuració trobareu instruccions i exemples.

Tot seguit, la resta de la instal·lació es fa per mitjà d'una interfície web. En avant suposarem que el vostre lloc és: http://exemple.com/moodle

 

8. Pàgina d'administració

La pàgina d'administració hauria d'estar en funcionament en l'adreça: http://example.com/moodle/admin. Si intenteu anar a la pàgina inicial del lloc també anireu a parar allò automàticament. La primera vegada que accediu a la pàgina d'administració se vos presentarà un contracte GPL "empaquetat" que heu d'acceptar abans de prosseguir la configuració.

(el Moodle també intentarà definir algunes galletesb en el vostre navegador. Si teniu configurat el navegador de manera que vos permeta triar si accepteu les galletesb, aleshores obligatòriament heu d'acceptar les galletes del Moodle, o si no el Moodle no funcionarà correctament.)

Ara el Moodle començarà a configurar la base de dades i a crear taules per a emmagatzemar les dades. Primer es creen les taules principals de la base de dades. Heu de veure una llista de declaracions SQL seguides de missatges d'estat (en verd o en roig) amb un aspecte semblant a este:

CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category int(10) unsigned NOT NULL default '0', password varchar(50) NOT NULL default '', fullname varchar(254) NOT NULL default '', shortname varchar(15) NOT NULL default '', summary text NOT NULL, format tinyint(4) NOT NULL default '1', teacher varchar(100) NOT NULL default 'Teacher', startdate int(10) unsigned NOT NULL default '0', enddate int(10) unsigned NOT NULL default '0', timemodified int(10) unsigned NOT NULL default '0', PRIMARY KEY (id)) TYPE=MyISAM

SUCCESS

etc., seguit de: La base de dades s'ha actualitzat amb èxit.

Si no veieu això, aleshores segurament hi ha hagut alguna problema amb la base de dades o amb els paràmetres de configuració definits en el config.php. Comproveu que el PHP no s'està executant en un "mode segur" (Safe Mode) restringit (els servicis d'allotjament comercials de vegades activen el mode segur). Podeu revisar les variables del PHP creant un xicotet fitxer que continga <? phpinfo() ?> i examinant l'eixida amb el navegador. Comproveu tot això i torneu a provar la pàgina d'administració.

Desplaceu-vos fins al capdavall de la pàgina i premeu l'enllaç "Continua".

Tot seguit veureu una pàgina semblant que configura totes les taules requerides per cada mòdul del Moodle. Igual que abans, tots els missatges ha de ser verds.

Desplaceu-vos fins al capdavall de la pàgina i premeu l'enllaç "Continua".

Ara heu de veure un formulari en el qual podeu definir més variables de configuració de la vostra instal·lació, com ara l'idioma per defecte, el servidor STMP, etc. No cal que vos preocupeu per encertar-ho tot ara: podeu tornar-hi i editar estos valors més tard utilitzant la interfície d'administració. Desplaceu-vos fins al capdavall i feu clic en "Guarda els canvis".

Si (i només si) vos quedeu encallats en esta pàgina, sense possibilitats de seguir avant, aleshores probablement el vostre servidor té el problema anomenat "buggy referrer". És fàcil d'arreglar: només cal que desactiveu el paràmetre "secureforms" i proveu-ho una altra vegada.

La pàgina següent és un formulari en el qual podeu definir paràmetres del vostre lloc Moodle i de la pàgina inicial, p. ex. el nom, el format, la descripció, etc. Ompliu estos paràmetres (podreu tornar-hi i canviar-los en qualsevol moment) i premeu "Guarda els canvis".

Finalment, se vos demanarà que creeu un usuari d'administració de nivell alt per a accedir en el futur a les pàgines d'administració. Escriviu el vostre nom, adreça electrònica, etc. i feu clic en "Guarda els canvis". No tots els camps són obligatoris, però si vos en deixeu algun d'important se vos tornarà a demanar que l'ompliu.

Assegureu-vos de recordar el nom d'usuari i la contrasenya que trieu per al compte de l'usuari d'administració, ja que en avant els necessitareu, només podreu accedir a la pàgina d'administració usant este compte.

(Si per algun motiu s'interromp la instal·lació, o hi ha un error de sistema d'algun tipus que vos impedix connectar-vos amb el compte d'administració, generalment podreu connectar-vos amb el nom d'usuari per defecte "admin" i la contrasenya "admin".)

Una vegada enllestit el procés d'instal·lació, se vos conduirà a la pàgina inicial del vostre lloc. Fixeu-vos en els enllaços d'administració que apareixen davall a l'esquerra (també apareixen en una pàgina d'administració a banda): estos elements només són visibles perquè esteu connectat com a usuari d'administració. Tota l'administració del Moodle es pot fer utilitzant este menú, per exemple:

 

9. Configuració del cron

Alguns mòduls del Moodle necessiten fer comprovacions regularment per a realitzar diferents tasques. Per exemple, el Moodle ha de revisar els fòrums de debats per a enviar còpies dels missatges per correu a les persones que s'hi han subscrit.

La seqüència que fa tot això es troba en el directori admin i s'anomena cron.php. Però no es pot executar per si mateixa, per tant heu de configurar un mecanisme que l'execute periòdicament (p. ex. cada cinc o deu minuts). Això proporciona una mena de "batec" per tal que la seqüència puga realitzar funcions en els períodes definits en cada mòdul.

Tingue en compte que la màquina que executa el cron no cal que siga la mateixa que està executant el Moodle. Per exemple, si utilitzeu un servici d'allotjament de web limitat que no té cron, aleshores podríeu triar d'executar el cron en un altre servidor o a l'ordinador de casa. L'únic que compta és que es cride el fitxer cron.php file regularment.

La càrrega d'esta seqüència no és molt alta, per tant generalment un interval de 5 minuts és raonable, però si això vos preocupa podeu augmentar-lo a 15 minuts o fins i tot 30 minuts. És millor que no siga un període de temps molt prolongat, ja que retardar els correus pot alentir l'activitat dins del curs.

Primer, comproveu que la seqüència funciona executant-la directament des del navegador:

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

Ara, heu de configurar alguna manera d'executar la seqüència automàticament i regularment.

Execució de la seqüència des de la línia d'ordes

Podeu cridar la pàgina des de la línia d'ordes igual que heu fet adés en l'exemple. Per exemple, podeu fer servir una utilitat d'Unix com ara 'wget':

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

Tingueue en compte que en este exemple l'eixida es llança (a /dev/null).

El mateix amb lynx:

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

Alternativament, podríeu utilitzar una versió autònoma de PHP, compilada per a executar-se en la línia d'ordes. L'avantatge de fer-ho així és que els registres del servidor web no s'omplin amb peticions constants del cron.php. L'inconvenient és que heu de tindre accés a una versió de línia d'ordes del PHP.

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

(Windows) C:\apache\php\php.exe C:\apache\htdocs\moodle\admin\cron.php

Execució automàtica de la seqüència cada 5 minuts

En sistemes Unix: utilitzeu el cron. Editeu els paràmetres del cron des de la línia d'ordes amb "crontab -e" i afegiu una línia com esta:

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

Generalment l'orde "crontab" vos portarà a l'editor 'vi'. Entreu en "mode inserció" prement "i", llavors escriviu la línia de dalt i eixiu del mode inserció prement ESC. Guardeu i eixiu teclejant ":wq", o eixiu sense guardar amb ":q!" (sense les cometes).

En sistemes Windows: el camí més fàcil és utilitzar este paquet: moodle-cron-for-windows.zip que fa molt senzill tot això. També podeu explorar la característica de "Tasques programades" integrada en Windows.

En un servidor web allotjat externament: el vostre tauler de control pot tindre una pàgina que vos permeta programar processos del cron. Pregunteu al servici tècnic.

10. Creació d'un curs nou

Ara que el Moodle funciona correctament ja podeu crear un curs.

Seleccioneu "Afig un curs nou" en la secció de cursos de la pàgina d'administració.

Ompliu formulari, aneu amb compte amb el format del curs. No cal que vos preocupeu gens pels detalls en este moment, ja que el professorat del curs podrà modificar-ho tot més avant.

Premeu "Guarda els canvis" i anireu a un altre formulari en el qual podreu assignar professors i professores al curs. En este formulari només podeu seleccionar comptes ja existents: si voleu crear un compte de professor nou, demaneu al professor que el cree ell mateix (en la pàgina d'entrada), o creeu-lo vosaltres per mitjà de l'opció "Afig un usuari nou" de la pàgina d'administració.

Després d'això el curs ja es podrà personalitzar i serà accessible en l'enllaç quot;Cursos" de la pàgina inicial.

Per a més informació sobre creació de cursos, consulteu el "Manual del professorat ".