Esta guía explica cómo instalar Moodle por primera vez. Ahonda en detalles de algunos de los pasos, con la finalidad de cubrir una amplia variedad de pequeñas diferencias entre las opciones de los diversos servidores Web, de manera que este documento puede parecer largo y complicado. No se desanime por esto, normalmente yo instalo Moodle ¡en unos pocos minutos!
Tómese su tiempo y lea este documento cuidadosamente, esto le ahorrará tiempo después.
Moodle está desarrollado principalmente en Linux usando PHP, Apache y MySQL, y revisado regularmente con PostgreSQL y en en los entornos Windows XP y Mac OS X.
Lo único que necesitará es:
Sobre una plataforma Windows, la forma más rápida de satisfacer estos requisitos es descargar FoxServ, o EasyPHP que instalarán Apache, PHP, y MySQL por usted. Asegúrese de habilitar el módulo GD de manera que Moodle pueda procesar imágenes. Tendrá que editar php.ini y eliminar el comentario (;) de la siguiente línea: 'extension=php_gd.dll'. Es posible que también tenga que arreglar el directorio para session.save_path - en vez del que viene por defecto "/tmp", use un directorio de Windows tal como "c:/temp".
Sobre Mac OS X yo recomiendo el proyecto fink como forma de descargar paquetes fáciles de mantener. Si usted no se siente seguro con el uso de comandos en línea, entonces, Marc Liyanage's PHP Apache Module es la manera más sencilla de conseguir subir PHP y ejecutarlo en un nuevo servidor Mac OS X.
¡Si usted usa Linux u otro sistema Unix, entonces asumiré que usted ya se figura todo esto por sí mismo! ;-)
Existen dos formas de obtener Moodle, como un paquete comprimido y a través de CVS. Esto se explica con detalle en la página de descarga en http://moodle.com/.
Tras descargar y descomprimir el archivo, o revisar los archivos vía CVS, usted tendrá un directorio llamado "moodle", que contiene un número de archivos y carpetas.
Usted puede tanto colocar la carpeta completa en su directorio de documentos de su servidor Web, en cuyo caso el sitio estará localizado en http://yourwebserver.com/moodle, como copiar todos los contenidos directamente en el directorio principal de documentos del servidor web, en cuyo caso el sitio será simplemente http://yourwebserver.com.
A continuación hay un breve resumen de los contenidos de la carpeta Moodle, para ayudarle a orientarse:
config.php - El único archivo que necesita editar para
conseguir comenzar
version.php - Define la versión actual del código de
Moodle
index.php - La página principal del sitio
Moodle también necesita algo de espacio en su disco duro para almacenar los archivos que vayan a ser subidos, tales como la documentación de los cursos y las fotos de los usuarios.
Cree un directorio para esto en cualquier parte. Por seguridad, es mejor que este directorio no esté accesible directamente a través de la Web. La manera más sencilla de conseguir esto, es colocarlo FUERA del directorio Web, en caso contrario protéjalo creando un archivo en el directorio de datos llamado .htaccess, conteniendo la siguiente línea:
deny from all
Para asegurarse de que Moodle puede guardar los archivos subidos, en ese directorio, revise que el software del servidor Web (por ejemplo Apache) tiene permiso de escritura en ese directorio. En las máquinas Unix, esto significa establecer que el dueño del directorio sea algo como "nobody" o "apache".
En muchos servidores de alojamiento compartido, probablemente usted tendrá que restringir todo acceso a los archivos de su "grupo" (para prevenir que los clientes de otros sitios Web alojados allí vean o cambien sus archivos), pero proporcionar pleno acceso de lectura/escritura a cualquiera (lo que permitirá el servidor Web acceder a sus archivos). Hable con el administrador de su servidor si tiene algún problema al establecer esto de forma segura.
Tendrá que crear una base de datos vacía (Ej. Moodle) en su sistema de base de datos, junto con un usuario especial (Ej. "moodleuser") que tenga acceso a esa base de datos (y sólo a esa base de datos). Si quisiera podría usar la "ruta" de usuario, pero esto no es recomendable en un sistema de producción: si los "hackers" descubren la contraseña todo su sistema de base de datos estaría en peligro, en vez de sólo una base de datos.
Ejemplo de líneas de comando para 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
Ejemplo de líneas de comando para 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
(Para MySQL yo recomiendo vivamente el uso de phpMyAdmin para manejar su base de datos).
Desde la versión 1.0.8, Moodle soporta prefijos en las tablas, de manera que puede compartir de forma segura una base de datos con tablas desde otras aplicaciones.
En primer lugar, asegúrese de que su servidor Web está preparado para usar index.php como página por defecto (quizás además de, index.html, default.htm y así).
En Apache, esto se logra usando un parámetro DirectoryIndex en su archivo httpd.conf. El mío normalmente aparece como sigue:
DirectoryIndex index.php index.html index.htm
Tan sólo asegúrese de que index.php está en la lista (y preferiblemente al principio de la lista, por una cuestión de eficacia).
En segundo lugar, si usted está usando Apache 2, entonces debe activar la variable AcceptPathInfo, el cual permite a los scripts que sean pasados por argumentos como http://server/file.php/arg1/arg2. Esto es esencial para permitir que existan enlaces relativos entre sus recursos, y también proporciona un rendimiento mejorado para las personas que usan su sitio Moodle. Usted puede activar esto añadiendo estas líneas a su archivo httpd.conf.
AcceptPathInfo on
En tercer lugar, Moodle requiere que PHP tenga activadas una serie de opciones para funcionar. En la mayoría de los servidores éstas están activadas por defecto. Si embargo, algunos servidores PHP (y algunas de las más recientes versiones de PHP) pueden estar configurados de forma diferente. Estas están definidas en el archivo de configuración de PHP (normalmente llamado php.ini):
magic_quotes_gpc = On
magic_quotes_runtime = Off
file_uploads = On
short_open_tag = On
session.auto_start = Off
session.bug_compat_warn = Off
Si usted no tiene acceso en su servidor a httpd.conf o php.ini, o tiene Moodle en un servidor con otras aplicaciones que requieren una configuración diferente, entonces usted puede ANULAR todas las opciones por defecto.
Para hacer esto, necesita crear un archivo llamado .htaccess en el directorio principal de Moodle que contiene definiciones para estas opciones. Esto sólo funciona para servidores Apache y solo cuando están permitidas las anulaciones.
DirectoryIndex index.php index.html index.htm
<IfDefine APACHE2>
AcceptPathInfo on
</IfDefine>
php_value magic_quotes_gpc On
php_value magic_quotes_runtime Off
php_value file_uploads On
php_value short_open_tag On
php_value session.auto_start Off
php_value session.bug_compat_warn Off
También puede usted definir cosas como el tamaño máximo de los archivos que podrán subirse:
php_value upload_max_filesize 2M
php_value post_max_size 2M
La forma más sencilla de hacerlo es copiar el archivo de ejemplo que hay en lib/htaccess y editarlo de acuerdo con sus necesidades. Ese archivo contiene más instrucciones. Por ejemplo, en Unix:
cp lib/htaccess .htaccess
Ahora usted puede editar el archivo de configuración, config.php, usando un editor de textos. Este archivo es usado por todos los otros archivos en Moodle.
Para comenzar, haga una copia de config-dist.php y llámelo config.php. Hacemos esto para que su config.php no pueda ser sobrescrito en caso de que actualice Moodle más tarde.
Edite config.php para especificar los detalles de al base de datos que acaba de definir (incluyendo un prefijo de tabla, tenga en cuenta que esto lo EXIGE PostgreSQL), así como la dirección del sitio, el directorio archivos de sistema y el directorio de datos. El archivo config contiene instrucciones detalladas.
Para el resto de este documento de instalación vamos a asumir que su sitio está en: http://example.com/moodle
La página de administración debe estar ahora funcionando en: http://example.com/moodle/admin. Si intenta acceder a la página principal de su sitio se encontrará automáticamente en ella de todas maneras. La primera vez que acceda a la página de administración, se le presentará el acuerdo GPL que necesariamente tendrá que aceptar para poder continuar con la configuración.
(Moodle también intentará poner algunas cookies en su navegador. Si tiene configurado su navegador para avisarle antes de aceptar las cookies, entonces debe aceptar las cookies de Moodle, o Moodle no podrá funcionar de forma apropiada.)
Ahora Moodle empezará a preparar su base de datos y a crear tablas para almacenar los datos. En primer lugar, se crean las tablas principales de la base de datos. Verá una serie de declaraciones SQL seguidas de mensajes de estado (en color verde o rojo) parecidos a estos:
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
...y cosas así, seguidas de: Main databases set up successfully.
Si usted no ve esto, quiere decir que hay algún problema con la base de datos o las opciones de configuración que ha definido en config.php. Revise que PHP no esté restringido por un "safe mode" (A menudo los alojamientos Web comerciales tienen establecido el modo seguro). Puede revisar las variables PHP creando un pequeño archivo que contenga <? phpinfo() ?> y mirándolo con un navegador. Revise todo esto e intente entrar en la página de nuevo.
Desplácese a la parte de abajo de la página y presione el enlace "Continuar".
A continuación verá una página similar que establece todos las tablas requeridas por cada módulo de Moodle. Como antes, todas deben aparecer en verde.
Desplácese nuevamente a la parte de abajo de la página y seleccione el enlace "Continuar".
Ahora usted debe ver un formulario en el que puede definir más variables de configuración para su instalación, tales como el idioma por defecto, el host SMTP y cosas por el estilo. No se preocupe demasiado de tener todo correcto ahora, siempre podrá volver y editar esto más adelante usando la interfaz de administración. Desplácese a la parte de abajo de la página y seleccione el enlace "Guardar cambios".
Si (y sólo si) usted se encuentra atascado en esta página o en la siguiente, incapaz de continuar, entonces su servidor probablemente tiene lo que yo llamo el problema del "buggy referrer". Esto es fácil de arreglar: sólo tiene que editar su config.php y establecer la variable buggy_referrer como true, luego intente de nuevo entrar en la página.
La siguiente página es un formulario en el que usted puede definir parámetros para su sitio Moodle y la página principal, tales como el nombre, formato, descripción y ese tipo de cosas. Rellénelo (siempre podrá volver y cambiar esto después) y luego haga clic en "Guardar cambios".
Finalmente, se le pedirá que cree un usuario administrador de máximo nivel para el futuro acceso a la página de administración. Rellene los detalles con su propio nombre, dirección de correo electrónico, etc.; y haga clic en "Guardar cambios". No todos los campos son obligatorios, pero si olvida rellenar un campo importante se le avisará.
Asegúrese de recordar el nombre de usuario y contraseña que ha elegido para la cuenta de la administración, ya que serán necesarias para acceder a la página de administración en el futuro.
Una vez conseguido esto usted puede volver a la página principal de administración, que contiene una serie de enlaces dispuestos en un menú (estos elementos también aparecen en la página principal cuando usted entra como usuario administrador). Toda su gestión de administración futura puede ahora hacerse desde este menú, como por ejemplo:
Algunos módulos de Moodle requieren revisiones continuas para llevar a cabo tareas. Por ejemplo, Moodle necesita revisar los foros de discusión para poder enviar copias de los mensajes a las personas que están suscritas.
El script que hace todo esto está en el directorio admin, y se llama cron.php. Sin embargo, no puede funcionar por sí mismo, de manera que usted tiene que establecer un mecanismo en el que este script se ejecute regularmente (Ej., cada cinco minutos). Esto proporciona un "pulso" de manera que el script pueda llevar a cabo funciones en determinados períodos definidos para cada módulo.
Tenga en cuenta que al máquina que cronometra no tiene que ser necesariamente la misma en la que está corriendo Moodle. Por ejemplo, si usted tiene un servicio de alojamiento Web limitado que no tiene crono, usted puede elegir ejecutar el crono en otro servidor o en su ordenador personal. Lo que importa es que el archivo cron.php sea llamado cada cinco minutos o así.
Primero, pruebe que el script funcione siendo ejecutado directamente desde su navegador:
http://example.com/moodle/admin/cron.php
Ahora, usted necesita establecer alguna manera de ejecutar el script automáticamente y regularmente.
Usted puede llamar a la página desde una línea de comandos tal como hizo en el ejemplo de arriba. Por ejemplo, puede usar una utilidad Unix como 'wget':
wget -q -O /dev/null http://example.com/moodle/admin/cron.php
Advierta en este ejemplo que la salida se dispone fuera (en /dev/null).
Es lo mismo usando lynx:
lynx -dump http://example.com/moodle/admin/cron.php > /dev/null
Como alternativa puede usar una versión de PHP compilada para ejecutarse desde la línea de comandos. La ventaja de hacer esto es que las entradas a su servidor Web no se llenan con constantes solicitudes a cron.php. La desventaja es que necesitará tener acceso a una versión de línea de comandos de PHP.
/opt/bin/php /web/moodle/admin/cron.php
(Windows) C:\apache\php\php.exe C:\apache\htdocs\moodle\admin\cron.php
En un sistema Unix: Use cron. Edite las opciones de cron desde la línea de comandos usando "crontab -e" y añada una línea como la siguiente:
*/5 * * * * wget -q -O /dev/null http://example.com/moodle/admin/cron.php
En sistemas Windows: La manera más sencilla es usar mi aplicación moodle-cron-for-windows.zip que hace todo esto de forma muy fácil. También puede probar a usar la aplicación integrada en Windows "Scheduled Tasks".
Ahora que Moodle está funcionando de manera apropiada, usted puede crear un curso.
Seleccione "Crear un nuevo curso" desde la página "Admin" (o desde los enlaces de administración en la página principal).
Rellene el formulario, prestando especial atención al formato del curso. En este momento no tiene que preocuparse demasiado por los detalles, pues todo puede ser cambiado después por el profesor.
Seleccione el enlace "Guardar cambios", aparecerá un nuevo formulario en el que puede asignar profesores al curso. Desde este formulario sólo pueden añadirse cuentas de usuarios existentes, si quiere crear una nueva cuenta para un profesor debe pedirle al profesor que cree una cuenta él mismo (vea la página de entradas) o crear una para él usando la opción "añadir nuevo usuario" en la página Admin.
Una vez hecho esto, el curso está listo para ser personalizado y puede accederse a él a través del enlace "Cursos" en la página principal.
Para obtener más detalles sobre la creación de cursos, vea el "Manual del Profesor"
Version: $Id$