Instalación de moodle 1.9

Saltar a: navegación, buscar

Nota: Pendiente de ACTUALIZAR esta traducción respecto a la página original en inglés (ver enlace hacia English en el cuadro abajo a la derecha).     (otras páginas pendientes)

Nota: Esta documentación aplica para Moodle 1.9; si Usted desea ver la documentación para Moodle 2.x vaya a Instalación de moodle.


Moodle 1.9


La mayoría de los servicios de alojamiento web (hosting) soportan todo esto por defecto. Si ha contratado los servicios de alguno de los pocos servicios de alojamiento web que no soportan estas características, pregúnteles por qué no lo hacen y considere la posibilidad de trasladar su sistema a otro sitio.

Si quiere instalar Moodle en su propio ordenador y todo esto le parece un poco complicado, entonces vea nuestra guía para Instalar Apache, MySQL y PHP. Le proporcionará instrucciones paso a paso para instalar estos programas en las plataformas más utilizadas.

Requerimientos adicionales:

  • Librería GD y librería FreeType 2 para poder construir los gráficos de los registros de Moodle.
  • mbstring - es requerido para manipular cadenas de caracteres multi-byte (iconv también es recomendable para Moodle 1.6).
  • la extensión mysql si va a utilizar la base de datos MySQL. En algunas distribuciones de Linux (principalmente RedHat) se trata de un paquete opcional.
  • la extensión pgsql si va a utilizar una base de datos PostgreSQL.
  • la extensión zlib es necesaria si va a utilizar las funcionalidades zip/unzip.
  • otras extensiones PHP podrían ser necesarias dependiendo de las funcionalidades opcionales de Moodle que vayan a ser utilizadas, especialmente las relacionadas con autenticación y matriculación (p. ej. la extensión LDAP).


Estructura del sitio

Puede saltarse sin problemas esta sección, pero en ella encontrará un breve resumen de los contenidos del directorio Moodle, para ayudarle a orientarse:

config.php - contiene la configuración fundamental. Este archivo no viene con Moodle - usted lo creará.
install.php - el script que ejecutará para crear el archivo config.php.
version.php - define la versión actual del código de Moodle.
index.php - la página principal del sitio.
admin/ - Código para administrar todo el servidor.
auth/ - Módulos para la autenticación de usuarios.
blocks/ - Módulos para los pequeños bloques laterales contenidos en muchas páginas.
calendar/ - Código para manejar y mostrar eventos de calendario.
course/ - Código para presentar y gestionar los cursos.
doc/ - Documentación de ayuda de Moodle. (Por ejemplo esta página).
files/ - Código para presentar y gestionar los archivos cargados.
lang/ - Textos en diferentes idiomas, un directorio por idioma.
lib/ - Librerías del código fundamental de Moodle.
login/ - Código para manejar las entradas y creación de cuentas.
mod/ - Todos los módulos de los cursos de Moodle.
pix/ - Gráficos genéricos del sitio.
theme/ - Paquetes de temas/pieles para cambiar la apariencia del sitio.
user/ - Código para mostrar y gestionar los usuarios.

Ejecutar el script de instalación para crear config.php

Para ejecutar el script de instalación (install.php), sólo tiene que acceder a la dirección URL de su instalación Moodle usando un navegador web, o simplemente acceder a http://suservidor/install.php directamente.

(El instalador tratará de establecer una sesión de cookies. Si se encuentra con una ventana de aviso en su navegador, asegúrese de aceptar esa cookie).

Moodle detectará la configuración necesaria y le guiará a través de algunas pantallas para ayudarle a crear el archivo de configuración llamado config.php. Al final del proceso, Moodle intentará escribir el archivo en el lugar apropiado, pero si esto no fuera posible puede presionar un botón para bajarlo desde el instalador y después subirlo dentro del directorio principal de Moodle en el servidor.

Al mismo tiempo, el instalador comprobará las características de su servidor y le sugerirá cómo resolver cualquier problema. Para la mayoría de las cuestiones habituales estas sugerencias deberían ser suficientes, pero si se queda atascado, mire abajo para encontrar más información sobre algunas cuestiones comunes que le deberían ayudar para poder continuar.

Configuración general del servidor web

Lo primero que debe hacer es establecer la configuración en su servidor web para usar index.php como página inicial (quizá además de index.html, default.htm, etc.). En Apache, esto se hace usando un parámetro DirectoryIndex en su archivo httpd.conf. Habitualmente aparece de esta forma:

     DirectoryIndex index.php index.html index.htm 

Sólo asegúrese de que index.php está en la lista (y preferiblemente al principio de la lista, por razones de eficiencia).

En segundo lugar, si está utilizando Apache 2, debería de habilitar la variable AcceptPathInfo, la cual permite que se puedan pasar argumentos a los scripts como http://servidor/archivo.php/arg1/arg2. Esto es esencial para permitir vínculos relativos entre sus recursos, y también proporciona una mejora de rendimiento en la utilización de su sitio web Moodle. Puede habilitar esto añadiendo estas líneas a su archivo httpd.conf:

     AcceptPathInfo on 

En tercer lugar, Moodle necesita tener activada una determinada configuración en su instalación PHP para funcionar. La mayoría de las opciones de configuración están establecidas por defecto. Sin embargo, algunos servidores PHP (y algunas de las versiones más recientes de PHP) pueden tener una configuración diferente. Estas opciones se definen en el archivo de configuración de PHP (normalmente llamado php.ini):

     magic_quotes_gpc = 0
     magic_quotes_runtime = 0    (necesario)
     file_uploads = 1
     session.auto_start = 0
     session.bug_compat_warn = 0

Si no tiene acceso a los archivos httpd.conf o php.ini en su servidor, o tiene Moodle en un servidor con otras aplicaciones que requieren una configuración diferente, no se preocupe, aún puede suplantar la configuración por defecto.

Para hacer esto necesita crear un archivo llamado .htaccess en el directorio principal de Moodle que contenga líneas como las que siguen. Esto sólo funciona en servidores Apache y únicamente cuando la funcionalidad Overrides ha sido permitida en la configuración principal.

     DirectoryIndex index.php index.html index.htm
     
     <IfDefine APACHE2>
          AcceptPathInfo on
     </IfDefine>
     
     php_flag magic_quotes_gpc 0
     php_flag magic_quotes_runtime 0
     php_flag file_uploads 1
     php_flag session.auto_start 0
     php_flag session.bug_compat_warn 0

También puede hacer cosas como definir el tamaño máximo para los archivos subidos:

     LimitRequestBody 0
     php_value upload_max_filesize 2M
     php_value post_max_size 2M

Lo más fácil es copiar el archivo de ejemplo localizado en lib/htaccess y editarlo para adecuarlo a sus necesidades (en su interior encontrará más instrucciones). Por ejemplo, en un intérprete de comandos de Unix:

     cp lib/htaccess .htaccess

Crear una base de datos

Necesitará crear una base de datos vacía (por ejemplo "moodle") en su sistema de base de datos, junto con un usuario especial (por ejemplo "moodleuser") que tenga acceso a esa base de datos (y sólo a esa base de datos). Si quisiera podría usar el usuario "root", pero esto no es recomendable en un sistema en 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.

Tenga en mente que Moodle no funciona bien con el ajuste "STRICT_TRANS_TABLES" de MySQL 5.x. Así que si esta es su base de datos deberá editar el fichero de configuración (my.ini en Windows o my.cnf en Linux/Unix) y comentar (o borrar) dicha opción. Necesitará reiniciar MySQL después de efectuar el cambio.

Si está utilizando un servicio de hosting, probablemente tendrá un panel de control que le permitirá crear su base de datos.

El sistema Cpanel es uno de los más populares entre ellos. Para crear una base de datos con Cpanel:

  1. Haga click en el icono "Bases de datos MySQL".
  2. Escriba "moodle" en el campo base de datos y haga click en "Añadir Base de Datos".
  3. Escriba un usuario y contraseña (no uno que use en cualquier sitio) en el campo respectivo y haga click en "Añadir Usuario".
  4. Ahora utilice el botón "Añadir Usuario a la Base de Datos" para dar a esta nueva cuenta de usuario "TODOS" los derechos en la nueva base de datos.
  5. Note que el nombre de usuario y el nombre de la base de datos pueden estar prefijados por su nombre de cuenta en su Cpanel. Cuando introduzca esta información en el instalador de Moodle utilice los nombres completos.

Si tiene acceso a la línea de comandos de Unix puede hacer estas mismas cosas escribiendo comandos.

Ejemplo de líneas de comando para MySQL (la parte en rojo es para Moodle 1.6 y posteriores, no la utilice para Moodle 1.5.x y anteriores):

  # mysql -u root -p
  > CREATE DATABASE moodle DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci; 
  > 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 WITH ENCODING = 'UTF8';" -U moodleuser template1
  > psql -c "alter user moodleuser nocreatedb;" template1
  > psql -c "alter user moodleuser with encrypted password 'tucontraseña';" template1
  > su - root
  # /etc/init.d/postgresql reload

Observación: Tenga presente que sería conveniente instanciar el cluster de BD de PostgreSQL con la codificación (encoding) más adecuada para nuestro idioma. Esta operación se realiza antes de las sentencias establecidas más arriba, y en una distribución Linux (tipo Red Hat o Fedora) tendría este formato (depenciendo de su configuración, las rutas pueden ser diferentes):

  # su - postgres
  # /usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data -E LATIN1 --locale=es_PY

Donde -E LATIN1 configura el conjunto de caracteres predeterminado para ese repositorio al tipo "europeo del oeste" y --locale=es_PY establece como localidad a Paraguay (en este caso, ese es mi país ;) Marcelo Demestri 07:07 1 ago, 2006 (WST)

Crear un directorio de datos

Moodle también necesita algo de espacio en su disco duro para almacenar los archivos que vayan a ser cargados, tales como la documentación de los cursos y las fotos de los usuarios.

El instalador de Moodle intenta crear este directorio pero si no puede hacerlo tendrá que crearlo usted manualmente.

Por seguridad, es mejor que este directorio NO sea accesible directamente desde la web. La manera más sencilla de conseguir esto es simplemente colocarlo FUERA del directorio web, pero en caso de que no pueda hacerlo así, protéjalo creando un archivo .htaccess en el directorio de datos que contenga la siguiente línea:

     deny from all

Para asegurarse de que Moodle puede guardar los archivos subidos en ese directorio, revise que el servidor web (por ejemplo Apache) tiene permiso de lectura, escritura y ejecución en ese directorio.

En las máquinas Unix, esto significa establecer que el dueño del directorio sea algo como "nobody" o "apache" y dar a ese usuario permiso de lectura, escritura y ejecución.

En los sistemas Cpanel puede usar el "Administrador de Archivos" para encontrar la carpeta, hacer clic en ella y escoger "Cambiar Permisos". En la mayoría de los servidores compartidos, probablemente necesitará restringir el acceso a archivos a su "grupo" (para evitar que otros clientes del mismo servidor web puedan ver o cambiar sus archivos), pero deberá proporcionar acceso completo de lectura/escritura a cualquiera (lo que permitirá al servidor web acceder a sus archivos).

Hable con el administrador de su servidor si tiene algún problema al establecer esto de forma segura. En concreto, algunos sitios que usan una característica de PHP conocida como "Safe Mode" pueden requerir que el administrador cree este directorio de la forma adecuada para usted.

Ir a la página de administración para continuar la configuración

Una vez que el archivo config.php ha sido correctamente creado en el paso anterior, al intentar acceder a la página principal de su sitio se encontrará con la página "administración" para continuar con el resto de la configuración.

La primera vez que acceda a esta página de administración, se le presentará el acuerdo de licencia GPL con el cual debe estar de acuerdo antes de continuar con la instalación.

En este momento, Moodle empezará configurando la base de datos y creando las tablas para guardar los datos. En primer lugar, se crean las principales tablas de la base de datos. Debería ver una serie de sentencias SQL seguidas por mensajes de estado (en verde o rojo) parecidas a éstas:

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 así sucesivamente, seguidas por: Main databases set up successfully.

Si no ve esto, debe de haber algún problema con la base de datos o con las opciones de configuración establecidas en config.php. Compruebe que PHP no está configurado como "Safe Mode" (a veces las empresas de hosting tienen esta restricción activada). Usted puede comprobar las variables PHP creando un pequeño archivo conteniendo <?php phpinfo() ?>; llámelo phpinfo.php y ábralo en un navegador. Compruebe esto y vuelva a la página de administración de nuevo.

Baje hasta el final de la página y presione el enlace "Continuar".

Ahora usted debería 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 servidor 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 hasta la parte inferior 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 llamamos el problema de la referencia defectuosa ("buggy referrer"). Esto es fácil de arreglar: sólo tiene que desactivar la opción "secureforms" del formulario, luego intente de nuevo entrar en la página.

A continuación verá más páginas con multitud de mensajes de estado a medida que se configuran todas las tablas requeridas por los diferentes módulos de Moodle. Como antes, deberían ser todos verdes.

Baje hasta el final de la página y presione el enlace "Continuar".

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. Complete los campos (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. Complete 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 diligenciar 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.

(Si por alguna razón se interrumpe su instalación, o hay un error del sistema de algún tipo que le impida entrar usando la cuenta de administrador, normalmente podrá entrar usando el usuario "admin", con contraseña "admin").

Una vez conseguido esto usted puede volver a la página principal de su sitio. Ésta contiene una serie de enlaces dispuestos en un menú que aparece en la parte izquierda de la página (estos elementos también aparecen en una página aparte de Administración). Estos elementos sólo son visibles para usted ya que ha entrado como el usuario administrador. Toda su gestión de administración puede desde ahora hacerse desde este menú, como por ejemplo:

  • Crear y borrar cursos
  • Crear y editar cuentas de usuario
  • Administrar cuentas de profesores
  • Cambiar opciones del sitio, como temas, etc.

¡Pero aún no ha concluido la instalación! Hay aún una cosa muy importante por hacer (vea la próxima sección acerca del cron).

Configurar el cron

Por favor, repase las instrucciones del cron.

Crear un nuevo curso

Ahora que Moodle está funcionando de manera apropiada, 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).

Complete 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.

Presione "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 necesita una cuenta para un profesor debe pedirle al profesor que cree su cuenta él mismo (vea la página de entradas) o créela usted utilizando 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 al mismo 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".

Ver También