Gracias por descargar Chamilo, la suite de aprendizaje de código abierto profesional.
- Prueba Chamilo en Free Campus
Esta guía explica como instalar el Sistema de Gestión de Aprendizaje Chamilo. Explica como instalar la conversión a PowerPoint Chamilo Oogie y la videoconferencia de Chamilo, aunque estos paquetes no son requeridos para usar Chamilo LMS. Por favor, lea completamente este documento antes de proceder con la instalación.
Contenidos
- Prerrequisitos
- Instalación de Chamilo LMS
- Actualizar desde una versión previa de Chamilo o Dokeos
- Solución de Problemas
- Sección de administración
- LDAP
- Fórmulas Matemáticas con LaTeX
- Fórmulas Matemáticas con ASCIIMathML
1. Prerrequisitos
Chamilo puede ser instalado indiferentemente en servidores Windows, Linux, Mac OS X y UNIX. Sin embargo, nosotros recomendamos el uso de un servidor Linux para una óptima flexibilidad, control remoto y escalabilidad.Chamilo es un LMS que se ejecuta con Apache 1.3, 2.0, MySQL 5.1 y PHP 5.2 (trilogía también llamada AMP).
Puede ser enriquecida con la conversión a PowerPoint (característica llamada Dokeos Oogie) mediante el uso de OpenOffice.org + Java. Quizás también quiera agregar el plugin de Videoconferencia de Chamilo mediante el uso de RED5 servidor de código abierto de Flash.
Todo este software es software de código abierto y está disponible libremente.
Para ejecutar Chamilo LMS en su servidor, necesita instalar WAMP, LAMP o MAMP:
- Para instalar WAMP (AMP en Windows), recomendamos el instalador XAMPP .exe
- Para instalar LAMP (AMP en Linux), use el administrador de paquetes de su distribución favorita (Synaptic, RPMFinder etc.). Por ejemplo, en un servidor Ubuntu, use Shell o Synaptic siguiendo la Ubuntuguide on Apache y las secciones siguientes.
- Para instalar MAMP (AMP en Mac OS X), referirse al sitio web dedicado a MAMP
Servidor de Base de Datos MySQL
Usted necesitará una cuenta de acceso y una contraseña que le permita administrar y crear al menos una base de datos. De manera predeterminada, Chamilo creará una nueva base de datos para cada curso. Esto significa que su proveedor deberá permitirle crear y administrar varias bases de datos. Usted también puede instalar Chamilo con una sola base de datos, en ese caso, deberá seleccionar esta opción durante la instalación.Para aprovechar la ventaja de la conversión Oogie de PowerPoint / Impress, necesita:
Para aprovechar la ventaja de la Videoconferencia de Chamilo, necesita:
2. Instalación de Chamilo LMS
- Descargar Chamilo LMS
- Descomprimirlo.
- Copiar el directorio de Chamilo en su directorio web de Apache. Este puede ser C:\xampp\htdocs\ en un servidor Windows o /var/www/html/ en un servidor Linux.
- Abrir su navegador web (Internet Explorer, Firefox...) y escribir http://localhost/chamilo/ si se instala de manera local o http://www.domain.com/chamilo/ si se instala remotamente.
- Seguir el proceso de instalación web. Usted puede aceptar todos los valores predeterminados. Considere cambiar la contraseña de administrador y recuérdela.
Los siguientes directorios necesitan tener permisos de lectura, escritura y ejecución para todos el mundo (remplace [chamilo] por el directorio en el cual está ubicado su Chamilo):
- [chamilo]/main/inc/conf/
- [chamilo]/main/upload/users/
- [chamilo]/main/default_course_document/images/
- [chamilo]/archive/
- [chamilo]/courses/
- [chamilo]/home/
- [chamilo]/main/css/
- [chamilo]/main/lang/
En Linux, Mac OS X y sistemas operativos BSD puede usar el comando CHMOD 0777 para esto (aunque nosotros recomendamos que busque la ayuda de un administrador de sistemas con experiencia para evitar fallas de seguridad). En Windows, es probable que necesite revisar las propiedades de los directorios (mediante el uso del clic derecho en ellos).
2.5. Los siguientes archivos necesitan tener permisos de lectura y escritura para el navegador web, sólo durante la instalación de Chamilo:
- chamilo/main/inc/conf/configuration.php (si está presente)
En Linux, Mac OS X y sistemas operativos BSD usted puede usar el comando CHMOD 666 para esto (aunque nosotros recomendamos que busque la ayuda de un administrador de sistemas con experiencia). En Windows, es probable que usted necesite revisar las propiedades de los directorios (mediante el uso del clic derecho en ellos).
NOTAS:
No modifique los archivos home_*.html directamente. En vez de hacer esto,
seleccione "Configurar la página de inicio" en la sección de administración de Chamilo.
Windows : con paquetes combinados como XAMPP, disponibles por todo lado, la cuenta de acceso y contraseña para MySQL probablemente permanecerá vacía.
Configuración y seguridad después de la instalación
- Proteger su archivo de configuración: asegurarse que nadie pueda sobrescribirlo. Usted puede encontrar el archivo de configuración en el (directorio de Chamilo)/main/inc/conf/configuration.php. Hacerlo de solo lectura (windows/xwindows: clic derecho en el archivo para editar las propiedades. linux/bsd/macosx: usar el comando chmod 444). El archivo de configuración es creado por Apache, por lo tanto usted necesita ser administrador para cambiar sus permisos.
- Proteger su directorio de instalación: si el (directorio de Chamilo) directorio /main/install sigue accesible, alguien podría instalar de nuevo sobre la versión existente (usted puede perder sus datos de esta manera). Por ello es muy importante que mueva el directorio a algún lugar fuera de los directorios web para que no se encuentre accesible, cambie su nombre, o edite sus propiedades para que nadie pueda leerlo o ejecutarlo.
- Para mayor seguridad: hacer que todos los archivos posean permisos de escritura facilita la instalación y resuelve muchas dudas a las personas con poca experiencia en administración. Sin embargo, en lugar de esto, es más seguro hacer que el propietario del proceso de Apache (usualmente llamado apache o www-data) sea también propietario de todos los archivos y carpetas de Chamilo. De esta manera, estos archivos sólo tendrán permisos de lectura y escritura para el propietario del proceso Apache y no para todo el mundo.
- Configurar su instalación de Chamilo: en la sección de administración de Chamilo, usted puede usar las Opciones de Configuración de Chamilo para ajustar el comportamiento de su instalación.
- Configurar correo de Chamilo: por lo general Chamilo usa las configuraciones de correo del archivo php.ini. Sin embargo, la herramienta de anuncios usa phpMailer (otro proyecto de software libre) y las configuraciones para esta herramienta pueden ser ajustadas en (directorio de chamilo)/main/inc/conf/mail.conf.php.
Configuración PHP
Para obtener lo mejor de Chamilo, necesita ajustar la configuración de PHP. Considere:- Editar el archivo php.ini (en Windows puede estar ubicado en C:\xampp\php\php.ini, en Ubuntu Linux : /etc/php5/apache2/php.ini
- Buscar la palabra "max" y incrementar los valores para optimizar el servidor
- Quizás desee terminar con los siguiente valores:
max_input_time = 600 ; Tiempo máximo que cada script que puede emplear para analizar los datos solicitados
memory_limit = 256M ; Maxima cantidad de memoria que un script puede consumir (128MB)
post_max_size = 64M
upload_max_filesize = 100M
Algunos usuarios pueden encontrar problemas si en sus configuraciones de PHP no se ajustan a las siguientes:
- short_open_tag = On
- safe_mode = Off
- magic_quotes_gpc = On
- magic_quotes_runtime = Off
En versiones de Chamilo/Dokeos anteriores se requería que register_globals estuviera configurada en On. Esto ya no necesario, puede estar configurado en Off y Chamilo funcionará bien.
Nota: si se usa PHP 5.3 o superior, se necesita configurar la variable date.timezone a la zona horaria de su servidor. Por ejemplo, si su servidor está en la zona horaria 'America/Lima', modificar en el php.ini:
Usuarios BSD: estas bibliotecas de php tienen que ser incluidas durante la instalación de php:
- php-mysql La extensión compartida de mysql para php
- php-pcre La extensión compartida de pcre para php
- php-session La extensión compartida de sesión para php
- php-zlib La extensión compartida de zlib para php
- (opcional) php-ldap si se desea habilitar el uso de la autenticación de LDAP
También puede necesitar estos módulos y paquetes:
- php-ctype
- php-gd
- php-iconv
- php-json
- php-mbstring
3. Actualizar desde una versión previa de Chamilo/Dokeos
Antes de actualizar, le recomendamos seriamente que haga una copia de seguridad de los directorios y bases de datos de Chamilo/Dokeos que previamente haya en su servidor. Si no está seguro de cómo hacer esto solicite asistencia a su proveedor de servicios de almacenamiento.3.1 Actualizar desde from Chamilo 1.8.7
- Revisar que no ha dejado alguna hoja de estilo personalizada o imagen*
- Descargar el paquete de instalación de Chamilo 1.8.7.1 desde la página de descarga de Chamilo
- Descomprimir los nuevos archivos de Chamilo 1.8.7.1 sobre los archivos de la version anterior (o descomprimirlos en una nueva carpeta y después copiarlos sobre los archivos de la versión anterior)
- Actualizar $_configuration['system_version'] de '1.8.7' a '1.8.7.1' en el fichero de configuración main/inc/conf/configuration.php
- Ya está! Está usando Chamilo 1.8.7.1
3.2 Actualizar desde Dokeos 1.8.x
Si usted actualiza desde Dokeos 1.8.x :- Revisar que no ha dejado alguna hoja de estilo personalizada o imagen*
- Descargar el paquete de instalación de Chamilo 1.8.7.1 desde la página de descarga de Chamilo
- Descomprimir los nuevos archivos de Chamilo 1.8.7.1 sobre los archivos de la version anterior (o descomprimirlos en una nueva carpeta y después copiarlos sobre los archivos de la versión anterior)
- Apunte su navegador a su portal URL + main/install/
- Escoja su idioma y haga clic en Actualizar desde 1.8.x
* Los estilos e imágenes están ubicados en el directorio main/css o main/img. Usted puede recuperarlos desde la copia de seguridad en el caso de que usted hya tenido la precaución de realizarla. Cualquier estilo o imagen modificada que use el nombre predeterminado style/image será sobrescrita en el siguiente paso. Para evitar perder cualquier personalización, siempre asegúrese de copiar styles/images bajo un nuevo nombre y use y modifique la copia, no el original. El original siempre sera sobrescrito por nuevas versiones. En Dokeos 1.8.5, hemos cambiado el nombre de varios temas CSS. La compatibilidad hacia atrás está asegurada por el hecho de que una actualización sólo agrega los nuevos temas, sin embargo usted debe usar estos nuevos temas en lugar de quedarse con los antiguos que quedarán obsoletos dentro de poco (sin mantenimiento).
3.3 Actualizar desde Dokeos 1.6.x
Si usted actualiza desde una versión anterior a Dokeos (1.6.x), lo primero y mas importante a hacer es *mover* su directorio actual hacia otro lugar.Una manera simple de hacer esto es crear un subdirectorio llamado "version_antigua" en su directorio actual de Dokeos y luego mover todo dentro de este, usando un sencillo comando "mover" (ejem. en Linux: mkdir version_antigua; mv * version_antigua/), luego dar permisos de escritura al directorio version_antigua para el servidor web para que los directorios courses/ y upload/ puedan moverse desde la antigua instalación a la nueva.
El proceso completo es como sigue:
- Mover los contenidos del directorio de Dokeos a un subdirectorio llamado version_antigua y darle permisos de escritura por el servidor web. Esto es importante para permitir mover los directorios courses/ y upload/ a la nueva instalacion
- Descargar el paquete de instalacion de Chamilo 1.8.7.1 desde la página de descarga de Chamilo
- descomprimir los nuevos archivos de Chamilo 1.8.7.1 en el directorio principal de Chamilo. El nuevo directorio principal debe estar ubicado directamente dentro de su directorio raiz de Chamilo
- Apuntar su navegador a la URL de su portal
- Escoja su idioma y haga clic en Actualizar desde 1.6.x y confirme el directorio actual de la versión antigua
NOTA: La actualización desde 1.6.x a 1.8.x implica una revisión de los gráficos y estilos personalizados. La nueva versión usa un completo nuevo conjunto de iconos y estilos, lo cual significa que aquellos provenientes de la versión 1.6 no pueden ser simplemente reusados. La buena noticia es que la versión 1.8.x le permite crear su propio estilo en un directorio css separado, el cual se puede reusar en todas las versiones 1.8.x
ADVERTENCIA:
No elimine el directorio de instalación previo de Chamilo/Dokeos antes de instalar
el nuevo. Usted puede eliminar la ruta antigua, cuando la actualización haya finalizado satisfactoriamente.
NOTA:
No modifique los archivos de home_*.html directamente. En lugar de ello,
seleccione "Configurar la página de inicio" en la sección de administración de Chamilo.
3.4 En ambos casos
Los siguientes directorios necesitan permisos de lectura, escritura y ejecución para el servidor web:- chamilo/main/inc/conf/
- chamilo/main/upload/users/
- chamilo/main/default_course_document/
- chamilo/archive/
- chamilo/courses/
- chamilo/home/
3.5 Guía de Actualizacion Rapida desde 1.6.x para Linux
La siguiente guía de actualización rápida rapida asume lo siguiente:- El nombre de usuario de la base de datos de Chamilo (para MySQL) es "chamilo_db_user" y su acceso es "chamilo_user"
- Actualmente la instalacion de Chamilo/Dokeos esta en /var/www/chamilo/ y tiene permisos 777
- La URL de su portal es http://www.portalurl.com/
Escribir en la línea de comandos:
- cd /tmp
- mysqldump -u chamilo_db_user -p --all-databases --result-file=/home/chamilo_user/chamilo_old.sql
- cp -ra /var/www/chamilo /home/chamilo_user/backup_chamilo
- mkdir /var/www/chamilo/version_antigua
- mv /var/www/chamilo/* /var/www/chamilo/version_antigua/
- chmod -R 0777 /var/www/chamilo/version_antigua/
- wget http://www.chamilo.org/files/chamilo-1.8.7.1.tar.gz
- tar zxvf chamilo-1.8.7.1.tar.gz
- sudo cp -ra chamilo-1.8.7.1/* /var/www/chamilo/
- rm chamilo-1.8.7.1.tar.gz
- sudo rm -r chamilo-1.8.7.1/
Luego (para actualización desde versiones anteriores a la 1.8.7):
- Direccionar su navegador web hacia http://www.portalurl.com/main/install/
- Proceder con la instalación
- Revisar los permisos de los directorios
4. Solución de problemas
Si usted tiene problemas, vaya al Sitio Web de Chamilo y haga una pregunta en el foro de soporte. Por favor, primero lea los mensajes previos para ver si existe ya una respuesta a su pregunta. Nosotros también mantenemos una lista de Preguntas Frecuentes.
5. Sección de Administración
Para acceder a la sección de administración de Chamilo, abra el navegador, diríjase a su dirección de Chamilo y acceda a el con el usuario admin. Luego usted verá un enlace a la "Seccion de administracion de la plataforma" en la parte superior de la página web. En ese lugar usted puede administrar usuarios, cursos, secciones, apariencia del portal contenido de la página principal, categorías de cursos, entre otros.
6. LDAP
Esta parte es opcional, solamente organizaciones con un servidor LDAP necesitan leer esto.
Un modulo LDAP está ya implementado en Chamilo, pero debe ser configurado para que tenga un correcto funcionamiento.
Compilar
Servidores Linux: Es posible que se requiera recompilar php con soporte ldap. Distribuciones nuevas también permiten descargar rpms para los paquetes adicionales.
Activar LDAP en Chamilo
En (la carpeta de Chamilo)/main/inc/conf/configuration.php, aproximadamente en la line 90, se puede ver
//for new login module
//uncomment these to activate ldap
//$extAuthSource['ldap']['login'] = "./main/auth/ldap/login.php";
//$extAuthSource['ldap']['newUser'] = "./main/auth/ldap/newUser.php";
eliminar // de las dos últimas líneas para activar LDAP.
Configuraciones
Solicitar al administrador del servidor LDAP los siguientes datos:
- nombre del servidor ldap
- puerto del servidor ldap (usualmente 389)
- dc del ldap
Como ejemplo, usted debe encontrar tipos de valores como los siguientes:
Dirección principal del servidor LDAP: "miservidorldap.com"; // su servidor ldap
Puerto principal del servidor LDAP: 389; // el número de puerto de su servidor ldap
dominio LDAP: "dc=xx, dc=yy, dc=zz"; //dominio
Estado Profesor/Estudiante
De manera predeterminada, Chamilo revisará si el campo "employeenumber" tiene un valor. Si lo tiene, entonces Chamilo
considerará que este usuario es profesor.
Si usted desea cambiar este comportamiento, usted puede editar main/auth/ldap/authldap.php, la función ldap_put_user_info_locally(),
y cambiar la condición if (empty($info_array[$tutor_field])) a la que a usted mejor le convenga.
Adicionalmente usted puede suprimir esta revisión, eliminando la condición y dejando solamente la linea $status = STUDENT;
Servidores LDAP protegidos
Algunos servidores LDAP no permiten usos anónimos de los servicios del directorio.
En este caso, usted debe rellenar los campos apropiados en el
panel de administración (ej. "manager" y "mypassword") y Chamilo tratará
de autentificarse usando esto, o volver al modo anónimo antes de darse por vencido.
Importar LDAP en sesiones
Existe un nuevo grupo de scripts que permiten insertar usuarios
desde LDAP directamente a una sesión de Chamilo. Sin embargo, esto se basa en un
conjunto de opciones estáticas en los atributos de contacto de LDAP.
Los campos usados intensivamente por el módulo de Chamilo son:
- uid, el cual se corresponde con el username en Chamilo
- userPassword, el cual se corresponde con la contraseña del usuario. Aunque esta parte, por ahora, solamente funcionará con contraseñas no encriptadas, no será necesaria si se usa el servidor LDAP para la autentificación.
- ou debe terminar con el año de registro de la persona o cualquier criterio que usted use para filtrar a los usuarios, de manera que ellos puedan obtenerse con ese criterio
- sn es usado como el campo lastname en Chamilo
- givenName es usado como el campo firstname en Chamilo
- mail es usado como el campo email en Chamilo
7. Fórmulas Matemáticas con LaTeX
Esta parte es opcional, sólo interesa a las organizaciones que deseen usar fórmulas matemáticas dentro del editor en línea.Usted puede habilitar la escritura de ecuaciones matemáticas dentro del editor en línea de Chamilo (FCKEditor) aplicando los siguientes pasos:
- 1. Configurar su instalación de Apache para agregar un directorio cgi-bin que contenga un enlace simbólico a mimetex.cgi en chamilo/main/inc/lib/mimetex/(*ver debajo)
- 2. Recargar su configuración de Apache
- 3. Editar chamilo/main/inc/lib/fckeditor/myconfig.js y
- 3.1. Agregar FCKConfig.Plugins.Add("mimetex", "en", sOtherPluginPath ) ; al final del archivo
- 3.2. Agregar 'mimetex' al final de las lineas
FCKConfig.ToolbarSets donde usted desee que el icono de LaTeX aparezca
(existe un FCKConfig.ToolbarSets por herramienta). Por ejemplo:
FCKConfig.ToolbarSets["Test"] = [Usted puede agregarlo a todas las herramientas, o sólo a alguna de ellas (por ej., documentos y ejercicios)
['Bold','Italic','Underline','StrikeThrough','Subscript','Superscript','Link','Unlink','ImageManager','MP3','OrderedList','UnorderedList','Table','mimetex']
] ;
- 4. En raras ocasiones puede ser necesario realizar ajustes manuales editando el fichero /chamilo/main/inc/lib/fckeditor/fckeditor.php
- 5. Limpiar la cache de su navegador para probarlo (muy importante). Esto se puede hacer mediante el uso de la página de configuraciones de su navegador
- 6. Realice estos cambios:
<Directory "/var/www/cgi-bin">
AllowOverride None
Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>
Si no quiere modificar su Apache, alternativamente a este punto 6: copie mimetex.exe (para Windows) o mimetex.cgi (para Linux) en su cgi-bin/
Este procedimiento creará un nuevo icono en su editor en línea de Chamilo, el cual hará posible la inserción de fórmulas matemáticas en sus documentos.
8. Fórmulas matemáticas con ASCIIMathML
Las fórmulas matemáticas pueden ser renderizadas en páginas web usando el script ASCIIMathML.js (en su versión modificada para Chamilo). Para más información sobre este script y sobre la sintaxis de fórmulas de ASCIIMath, ver http://www1.chapman.edu/~jipsen/mathml/asciimath.html y http://dlippman.imathas.com/asciimathtex/AMT.html.
Para escribir fórmulas ASCIIMath en documentos, es necesario activar el plugin correspondiente del editor en línea. Para hacerlo, ver la sección de administración de la plataforma, "Administración > Parámetros de configuración > > Editor WYSIWYG". Activar el parámetro "Editor matemático ASCIIMathML".
El script ASCIIMathML.js puede mostrar fórmulas matemáticas en los documentos de dos formas:
- Traduciendo las fórmulas en notación ASCIIMath en código MathML. El estándar MathML está soportado actualmente sobre tres navegadores:
- Mozilla Firefox: debería considerar la instalación de las fuentes de carácter STIX (http://www.stixfonts.org) en sus máquinas cliente para tener fórmulas bonitas
- Internet Explorer 6 o superior, con el add-on MathPlayer 2.0 o superior (http://www.dessci.com/en/products/mathplayer)
- Opera 9.5 o superior
- Traduciendo la notación de fórmulas ASCIIMath en notación TeX y pasándolo a un servicio externo. Se debe usar en el caso de navegadores que no soporten MathML. El servicio externo produce y devuelve un imagen que contiene la fórmula. Esta técnica se llama "image-based fallback".
Para proveer image-based fallback en un sistema en producción, debería seleccionar e instalar en su servidor algun software de renderización TeX, como:
- mimeTeX - http://www.forkosh.dreamhost.com/source_mimetex.html. Ver "7. Fórmulas matemáticas con LaTeX" para instalar el ejecutable mimetex en su servidor
- mathTeX - http://www.forkosh.com/mathtex.html. Ver el sitio para instrucciones de instalación
Y como alternativa, puede intentar servicios públicos, como:
- MathTran - http://www.mathtran.org
- Google Chart Tools - http://code.google.com/apis/charttools
Abrir el fichero .../chamilo/main/inc/lib/asciimath/ASCIIMathML.js con un editor de texto. Encuentre un lugar al inicio de la línea que inicializa la variable AMTcgiloc. Podría necesitar modificar el ejemplo para tener algo como:
- var AMTcgiloc = "http://mychamiloserver.org/cgi-bin/mimetex.cgi";
- var AMTcgiloc = "http://mychamiloserver.org/cgi-bin/mathtex.cgi";
- var AMTcgiloc = "http://www.mathtran.org/cgi-bin/mathtran?tex=";
- var AMTcgiloc = "http://chart.apis.google.com/chart?cht=tx&chs=1x0&chl=";
- ... o algo similar
Para formas de probar como la variable AMTcgiloc tiene que ser configurada, existen unos ejemplos (en comentario) dentro del script.
Dirección de Contacto: Chamilo
Correo: info@chamilo.org
