Gua de Instalacin de Chamilo 1.8.7.

1
Contenidos
1. 2. 3. 4. 5. 6. 7. 8. 9. Prerrequisitos Instalacin de Chamilo LMS Actualizar desde una versin previa de Chamilo o Dokeos Solucin de Problemas Seccin de administracin LDAP Frmulas Matemticas con LaTeX Frmulas Matemticas con ASCIIMathML Frmulas Matemticas con WIRIS

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 (triloga tambin llamada AMP). Puede ser enriquecida con la conversin a PowerPoint (caracterstica llamada Dokeos Oogie) mediante el uso de OpenOffice.org + Java. Quizs tambin quiera agregar el plugin de Videoconferencia de Chamilo mediante el uso de RED5 servidor de cdigo abierto de Flash. Todo este software es software de cdigo 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 distribucin 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 contrasea 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 tambin puede instalar Chamilo con una sola base de datos, en ese caso, deber seleccionar esta opcin durante la instalacin. Para aprovechar la ventaja de la conversin Oogie de PowerPoint / Impress, necesita:

OpenOffice.org Java Runtime Environment

Para aprovechar la ventaja de la Videoconferencia de Chamilo, necesita:

Servidor de Flash de Cdigo Abierto RED5

2. Instalacin 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 instalacin web. Usted puede aceptar todos los valores predeterminados. Considere cambiar la contrasea de administrador y recurdela.

Los siguientes directorios necesitan tener permisos de lectura, escritura y ejecucin 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/

Opcionalmente, puede hacer lo mismo a los directorios siguientes si desea activar la subida de paquetes de estilos CSS y la definicin de sub-idiomas:

[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, slo durante la instalacin 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 pgina de inicio" en la seccin de administracin de Chamilo. Windows : con paquetes combinados como XAMPP, disponibles por todo lado, la cuenta de acceso y contrasea para MySQL probablemente permanecer vaca.

Configuracin y seguridad despus de la instalacin

Proteger su archivo de configuracin: asegurarse que nadie pueda sobrescribirlo. Usted puede encontrar el archivo de configuracin 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 configuracin es creado por Apache, por lo tanto usted necesita ser administrador para cambiar sus permisos. Proteger su directorio de instalacin: si el (directorio de Chamilo) directorio /main/install sigue accesible, alguien podra instalar de nuevo sobre la versin existente (usted puede perder sus datos de esta manera). Por ello es muy importante que mueva el directorio a algn 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 instalacin y resuelve muchas dudas a las personas con poca experiencia

en administracin. Sin embargo, en lugar de esto, es ms seguro hacer que el propietario del proceso de Apache (usualmente llamado apache o www-data) sea tambin propietario de todos los archivos y carpetas de Chamilo. De esta manera, estos archivos slo tendrn permisos de lectura y escritura para el propietario del proceso Apache y no para todo el mundo. Configurar su instalacin de Chamilo: en la seccin de administracin de Chamilo, usted puede usar las Opciones de Configuracin de Chamilo para ajustar el comportamiento de su instalacin. 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.

Configuracin PHP
Para obtener lo mejor de Chamilo, necesita ajustar la configuracin 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 Quizs desee terminar con los siguiente valores:

max_execution_time = 300 ; Tiempo mximo de ejecucion para cada script, en segundos max_input_time = 600 ; Tiempo mximo 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 requera 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: date.timezone = 'America/Lima' Usuarios BSD: estas bibliotecas de php tienen que ser incluidas durante la instalacin de php:

php-mysql La extensin compartida de mysql para php php-pcre La extensin compartida de pcre para php php-session La extensin compartida de sesin para php php-zlib La extensin compartida de zlib para php (opcional) php-ldap si se desea habilitar el uso de la autenticacin de LDAP

Tambin puede necesitar estos mdulos y paquetes:

php-ctype php-gd php-iconv php-json php-mbstring

3. Actualizar desde una versin 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 cmo 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 instalacin de Chamilo 1.8.7.1 desde la pgina 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 despus copiarlos sobre los archivos de la versin anterior) Actualizar $_configuration['system_version'] de '1.8.7' a '1.8.7.1' en el fichero de configuracin 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 instalacin de Chamilo 1.8.7.1 desde la pgina 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 despus copiarlos sobre los archivos de la versin 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 imgenes estn 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 precaucin de realizarla. Cualquier estilo o imagen modificada que use el nombre predeterminado style/image ser sobrescrita en el siguiente paso. Para evitar perder cualquier personalizacin, siempre asegrese 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 atrs est asegurada por el hecho de que una actualizacin slo agrega los nuevos temas, sin embargo usted debe usar estos nuevos temas en lugar de quedarse con los antiguos que quedarn obsoletos dentro de poco (sin mantenimiento).

3.3 Actualizar desde Dokeos 1.6.x

Si usted actualiza desde una versin 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 instalacin 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 pgina 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 versin antigua

NOTA: La actualizacin desde 1.6.x a 1.8.x implica una revisin de los grficos y estilos personalizados. La nueva versin usa un completo nuevo conjunto de iconos y estilos, lo cual significa que aquellos provenientes de la versin 1.6 no pueden ser simplemente reusados. La buena noticia es que la versin 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 instalacin previo de Chamilo/Dokeos antes de instalar el nuevo. Usted puede eliminar la ruta antigua, cuando la actualizacin haya finalizado satisfactoriamente. NOTA: No modifique los archivos de home_*.html directamente. En lugar de ello, seleccione "Configurar la pgina de inicio" en la seccin de administracin de Chamilo.

3.4 En ambos casos

Los siguientes directorios necesitan permisos de lectura, escritura y ejecucin para el servidor web:

chamilo/main/inc/conf/ chamilo/main/upload/users/ chamilo/main/default_course_document/ chamilo/archive/ chamilo/courses/ chamilo/home/

En Linux, Mac OS X y sistemas operativos BSD esto se puede arreglar rpidamente mediante el uso del comando CHMOD 777, sin embargo si usted no est seguro, le recomandamos que busque asistencia para su propio SO en nuestro foro. En Windows, quizs necesite revisar las propiedades de las carpetas.

3.5 Gua de Actualizacion Rapida desde 1.6.x para Linux

La siguiente gua de actualizacin rpida 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 lnea de comandos:

cd /tmp mysqldump -u chamilo_db_user -p --all-databases --resultfile=/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 actualizacin desde versiones anteriores a la 1.8.7):

Direccionar su navegador web hacia http://www.portalurl.com/main/install/ Proceder con la instalacin Revisar los permisos de los directorios

4. Solucin 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 tambin mantenemos una lista de Preguntas Frecuentes.

5. Seccin de Administracin
Para acceder a la seccin de administracin de Chamilo, abra el navegador, dirjase a su direccin 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 pgina web. En ese lugar usted puede administrar usuarios, cursos, secciones, apariencia del portal contenido de la pgina principal, categoras 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 tambin 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 lneas 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

Desde 1.8.5, usted tiene que cambiar las configuraciones de LDAP dentro del panel "Administracin del Portal", bajo "Opciones de configuracin de Chamilo", seccin "LDAP". Como ejemplo, usted debe encontrar tipos de valores como los siguientes: Direccin principal del servidor LDAP: "miservidorldap.com"; // su servidor ldap Puerto principal del servidor LDAP: 389; // el nmero 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 funcin ldap_put_user_info_locally(), y cambiar la condicin if (empty($info_array[$tutor_field])) a la que a usted mejor le convenga. Adicionalmente usted puede suprimir esta revisin, eliminando la condicin y dejando solamente la linea $status = STUDENT;

Servidores LDAP protegidos

Algunos servidores LDAP no permiten usos annimos de los servicios del directorio. En este caso, usted debe rellenar los campos apropiados en el panel de administracin (ej. "manager" y "mypassword") y Chamilo tratar de autentificarse usando esto, o volver al modo annimo antes de darse por vencido.

Importar LDAP en sesiones

Existe un nuevo grupo de scripts que permiten insertar usuarios desde LDAP directamente a una sesin de Chamilo. Sin embargo, esto se basa en un conjunto de opciones estticas en los atributos de contacto de LDAP. Los campos usados intensivamente por el mdulo de Chamilo son:

uid, el cual se corresponde con el username en Chamilo userPassword, el cual se corresponde con la contrasea del usuario. Aunque esta parte, por ahora, solamente funcionar con contraseas no encriptadas, no ser necesaria si se usa el servidor LDAP para la autentificacin. ou debe terminar con el ao 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. Frmulas Matemticas con LaTeX

Esta parte es opcional, slo interesa a las organizaciones que deseen usar frmulas matemticas dentro del editor en lnea. Usted puede habilitar la escritura de ecuaciones matemticas dentro del editor en lnea de Chamilo (FCKEditor) aplicando los siguientes pasos:

1. Configurar su instalacin de Apache para agregar un directorio cgi-bin que contenga un enlace simblico a mimetex.cgi en chamilo/main/inc/lib/mimetex/(*ver debajo) 2. Recargar su configuracin de Apache 3. Editar chamilo/main/inc/lib/fckeditor/myconfig.js y o 3.1. Agregar FCKConfig.Plugins.Add("mimetex", "en", sOtherPluginPath ) ; al final del archivo o 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"] = [ ['Bold','Italic','Underline','StrikeThrough','Subscript','Superscript','Link',

'Unlink','ImageManager','MP3','OrderedList','UnorderedList','Table','mi metex'] ]; Usted puede agregarlo a todas las herramientas, o slo a alguna de ellas (por ej., documentos y ejercicios)

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 pgina de configuraciones de su navegador 6. Realice estos cambios:

Agregar el directorio cgi-bin correspondiente a su configuracin de Apache puede ser realizada de esta manera, en Apache 2: ScriptAlias /cgi-bin/ /var/www/cgi-bin/ <Directory "/var/www/cgi-bin"> AllowOverride None Options ExecCGI -MultiViews +SymLinksIfOwnerMatch Order allow,deny Allow from all </Directory> Agregar un enlace simblico bajo Windows, puede ser realizado mediante la creacin de un acceso directo al archivo mimetex.exe desde el directorio cgi-bin, o bajo Linux usando el siguiente comando: ln -s /var/www/chamilo/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi 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 lnea de Chamilo, el cual har posible la insercin de frmulas matemticas en sus documentos.

8. Frmulas matemticas con ASCIIMathML

Las frmulas matemticas pueden ser renderizadas en pginas web usando el script ASCIIMathML.js (en su versin modificada para Chamilo). Para ms informacin sobre este script y sobre la sintaxis de frmulas de ASCIIMath, ver http://www1.chapman.edu/~jipsen/mathml/asciimath.html y http://dlippman.imathas.com/asciimathtex/AMT.html.

Para escribir frmulas ASCIIMath en documentos, es necesario activar el plugin correspondiente del editor en lnea. Para hacerlo, ver la seccin de administracin de la plataforma, "Administracin > Parmetros de configuracin > > Editor WYSIWYG". Activar el parmetro "Editor matemtico ASCIIMathML". El script ASCIIMathML.js puede mostrar frmulas matemticas en los documentos de dos formas:

Traduciendo las frmulas en notacin ASCIIMath en cdigo MathML. El estndar MathML est soportado actualmente sobre tres navegadores: o Mozilla Firefox: debera considerar la instalacin de las fuentes de carcter STIX (http://www.stixfonts.org) en sus mquinas cliente para tener frmulas bonitas o Internet Explorer 6 o superior, con el add-on MathPlayer 2.0 o superior (http://www.dessci.com/en/products/mathplayer) o Opera 9.5 o superior Traduciendo la notacin de frmulas ASCIIMath en notacin TeX y pasndolo 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 frmula. Esta tcnica se llama "image-based fallback".

Para proveer image-based fallback en un sistema en produccin, debera seleccionar e instalar en su servidor algun software de renderizacin TeX, como:

mimeTeX - http://www.forkosh.dreamhost.com/source_mimetex.html. Ver "7. Frmulas matemticas con LaTeX" para instalar el ejecutable mimetex en su servidor mathTeX - http://www.forkosh.com/mathtex.html. Ver el sitio para instrucciones de instalacin

Y como alternativa, puede intentar servicios pblicos, 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 lnea que inicializa la variable AMTcgiloc. Podra 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.

9. Frmulas matemticas con WIRIS

Instalando este plugin obtendr WIRIS editor y WIRIS CAS. La activacin no se realiza completamente si previamente no ha descargado el PHP plugin for FCKeditor de WIRIS y descomprimido su contenido en el directorio de Chamilo main/inc/lib/fckeditor/editor/plugins/fckeditor_wiris/ Esto es necesario debido a que Wiris es un software propietario y los servicios de Wiris son comerciales. Para realizar ajustes en el plugin edite el archivo configuration.ini o sustituya su contenido por el de configuration.ini.default que acompaa a Chamilo.

Direccin de Contacto: Chamilo Correo: info@chamilo.org