Instalación de moodle
De MoodleDocs
¡En primer lugar, no se asuste!
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 Moodle se instala en unos pocos minutos!
Si tiene dificultades, por favor lea este documento cuidadosamente, pues la mayoría de los problemas habituales están contestados aquí. Si aún así tiene problemas, puede buscar ayuda en los foros del curso de Moodle en Español.
Otra opción es contactar con una compañía de hosting que pueda mantener Moodle por usted, de forma que pueda despreocuparse de todo esto y centrarse en la formación.
Requerimientos
Moodle está desarrollado principalmente en GNU/Linux usando Apache, MySQL y PHP (también conocida como plataforma LAMP), aunque es probado regularmente con PostgreSQL y en los sistemas operativos Windows XP, MacOS X y Netware 6.
Los requerimientos de Moodle son los siguientes:
- Un servidor web. La mayoría de los usuarios usan Apache, pero Moodle debe funcionar bien en cualquier servidor web que soporte PHP, como el IIS (Internet Information Server) de las plataformas Windows.
- Una instalación de PHP en funcionamiento (versión 4.3.0 o posterior). PHP 5 está soportado a partir de Moodle 1.4. (tenga cuidado con PHP-Accelerator ya que se han detectado problemas con él.
- Una base de datos: MySQL o PostgreSQL, que están completamente soportadas y recomendadas para su uso con Moodle. MySQL es la elección preferida para mucha gente porque es muy popular, pero hay algunos argumentos a favor de PostgreSQL, especialmente si está planificando instalaciones de grandes dimensiones. MySQL 4.1.16 es la versión mínima para trabajar con Moodle 1.6 (muchas distribuciones de Linux incorporan versiones más antiguas, así que debe comprobar este extremo).
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).
Descarga y copia de archivos
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://download.moodle.org/
Tras descargar y descomprimir el archivo, o actualizar los archivos vía CVS, tendrá un directorio llamado "moodle", que contiene varios archivos y carpetas.
Puede colocar la carpeta completa en el directorio de documentos de su servidor web, en cuyo caso el sitio estará localizado en http://suservidor.com/moodle, o bien copiar todos los contenidos directamente en el directorio principal de documentos del servidor web, en cuyo caso el sitio será simplemente http://suservidor.com.
Si está descargando Moodle a su ordenador para después subirlo a su sitio web, normalmente es preferible subirlo todo como un solo archivo y descomprimirlo en el servidor. Incluso los paneles de control como Cpanel le permiten descomprimir archivos en el "Administrador de Archivos".
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
AcceptPathInfo on
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:
- Haga click en el icono "Bases de datos MySQL".
- Escriba "moodle" en el campo base de datos y haga click en "Añadir Base de Datos".
- Escriba un usuario y contraseña (no uno que use en cualquier sitio) en el campo respectivo y haga click en "Añadir Usuario".
- 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.
- 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 ; 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".
, seguro que ya se dieron cuenta de esto mientras instalaban.
: 
Julio 21, 2009 a las 7:04 pm
He seguido tu guia detenida y en ultimo (paso 7 instalacion) paso luego de borrar la carpeta de instalacion me sale un error en /localhost/joomla
No configuration file found and no installation code available. Exiting…
algun consejo?
desde ya muchas gracias por tus aportes
Julio 22, 2009 a las 4:05 am
Hola Pedro, te pido por favor que revises una vez más el tutorial que publiqué, le hice agregué algunas imágenes y unas instrucciones más. Quizás eso me faltó desde un principio. Espero que te ayude, pues en una de esas te saltaste algún paso o tecleaste algo mal ya que al borrar la carpeta “instalacion” no deberia arrojarte un error.
Bueno, espero comentarios tuyos.
Cualqueir otra duda no dudes en preguntar.
Saludos
Diciembre 18, 2009 a las 5:25 am
El erro que te da es porque has borrado el directorio de instalación ANTES de haber configurado Joomla
Septiembre 1, 2009 a las 2:26 pm
Hola, excelente tutorial, muy bien explicado, solamente me sucede en el punto final, cuando quiero entrar como administrator me marca el siguiente error:
Apache/2.2.11 (Ubuntu) PHP/5.2.6-3ubuntu4.2 with Suhosin-Patch Server at localhost Port 80
Septiembre 1, 2009 a las 3:42 pm
Hola boysk7… de casualidad te metiste a la configuracion de apache???…
si es asi..prueba reiniciando el servicio……
lo otro que puedes hacer es mirar el log para ver que esta haciendo mal..o detectar algun posible error….pues eso es claramente problema con tu apache..joomla no tiene nada que ver..
mira..en esta foro (http://ubuntuforums.org/showthread.php?p=7874500) a alguien le sucedio el mismo error y finalmente lo soluciono…. es un foro en ingles…si tienes problema con el idioma usa google traductor..
saludos
Septiembre 1, 2009 a las 3:44 pm
ahhh…por cierto….cuando en tu consola te aparezcan errores…copialo y lo buscas en san google..siempre hay una solucion…. e incluso es mas facil encontrarla si el mensaje de error esta en ingles…encontraras de esa forma mayor documentacion…
saludos otra vez
Septiembre 1, 2009 a las 4:32 pm
geniutrixone muchas gracias por tu pronta respuesta, el problema ya lo solucione. Fue un error que cometi ya que la carpeta la puse con mayusculas, al final me funciono con la siguiente liga sobre el navegador: http://localhost/JOOMLA/administrator
Muchas gracias por tus tips, saludos desde Monterrey Mexico
Noviembre 21, 2009 a las 3:09 am
Aunque creo que ya debes haber resuelto el problema:
“error en /localhost/joomla No configuration file found and no installation code available. Exiting…”
Pero puede servirle, si esto le ocurra a otros, como me ocurrió a mi.
Lo más probable que en el segundo paso, señalaba en rojo:
“configuration.php Escribible NO”
Como lo señalan en el blog, eso ocurre por que el archivo original “configuration.php-dist” no tiene permisos de escritura.
Es solucionable otorgándole los permisos.
Sin cambiar los permisos igual se puede instalar, pues la otra solución es dejarlo para el final en el paso 7, que es el ultimo paso.
Antes de terminar la instalación, lo advierte y sale el script que debes copiar y pegar en un archivo de texto o en un block de notas.
Y guardarlo con el nombre: configuration.php (debe conservar la extensión .php)
Después vía ftp lo subes a tu carpeta donde esta localizado joomla.
O lo copias y lo pegas directamente (si tu servidor es tu mismo PC).
El archivo “configuration.php”, será diferente en cada instalación de joomla.
Ya que guarda tu configuración personal incluyendo password, ruta de tu carpeta “joomla”, email, etc
Diciembre 17, 2009 a las 7:53 pm
[...] de Joomla-Ubuntu: http://dcala.wordpress.com/2009/07/14/como-instalar-joomla-1-5-en-ubuntu-o-debian-lenny/ MySQL localhost Escrito por lamatriz Archivado en Software Libre y Gratuito, Ubuntu Tips, [...]