Dokeos 2.0 Guia de Installacion

Gracias por descargar Dokeos, la suite de aprendizaje de código abierto profesional.

• Vista rápida de las Características de Dokeos 
• Prueba Dokeos en Free Campus

Esta guía explica como instalar el Sistema de Gestión de Aprendizaje de Dokeos. Explica como instalar la conversión a PowerPoint Dokeos Oogie y la videoconferencia de Dokeos, aunque estos paquetes no son requeridos para usar Dokeos LMS.  Por favor, lea completamente este documento antes de proceder con la instalación.

Si desea ahorrar tiempo, problemas y dinero, alternativamente puede tener su Portal de Dokeos desplegado o instalado por Dokeos o alguno de sus socios.

Contenidos

1. Prerrequisitos
2. Instalación de Dokeos LMS
3. Actualizar desde una versión previa de Dokeos
4. Solución de Problemas
5. Sección de administración
6. LDAP 
7. Conversión Oogie PowerPoint / Impress
8. Grabador de videoconferencia y audio
9. Formulas Matemáticas con LaTeX
10. Múltiples URLs

---

1. Prerrequisitos

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

Dokeos es un LMS que se ejecuta con Apache 1.3, 2.0, MySQL 5.1 y PHP 5.1 (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 Dokeos 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 Dokeos 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, Dokeos 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 Dokeos 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:

• OpenOffice.org
• Java Runtime Environment

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

• Servidor de Flash de Código Abierto RED5

---

2. Instalación de Dokeos LMS

• Descargar Dokeos LMS
• Descomprimirlo.
• Copiar el directorio de Dokeos 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/dokeos/ si se instala de manera local o http://www.domain.com/dokeos/ 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:

• dokeos/main/inc/conf/
• dokeos/main/upload/users/
• dokeos/main/default_course_document/
• dokeos/archive/
• dokeos/courses/
• dokeos/home/

(donde 'dokeos' es el directorio en el cual usted instaló Dokeos)

En Linux, Mac OS X y sistemas operativos BSD puede usar el comando CHMOD 777 para esto (aunque nosotros recomendamos que busque la ayuda de un administrador de sistemas con experiencia). 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 Dokeos:

• dokeos/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 Dokeos.

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 Dokeos)/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 Dokeos) 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 Dokeos. 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 Dokeos: en la sección de administración de Dokeos, usted puede usar las Opciones de Configuración de Dokeos para ajustar el comportamiento de su instalación.
• Configurar correo de Dokeos: por lo general Dokeos 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 dokeos)/main/inc/conf/mail.conf.php.

Configuración PHP

Para obtener lo mejor de Dokeos, 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:

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 Dokeos anteriores se requería que register_globals estuviera configurada en On. Esto ya no necesario, puede estar configurado en Off y Dokeos funcionará bien.

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 Dokeos

Antes de actualizar, le recomendamos seriamente que haga una copia de seguridad de los directorios y bases de datos de 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 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 Dokeos 1.8.6 desde la página de descarga de Dokeos
• Descomprimir los nuevos archivos de Dokeos 1.8.6 sobre los archivos de la version 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.2 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 Dokeos 1.8.6 desde la página de descarga de Dokeos
• descomprimir los nuevos archivos de Dokeos 1.8.6 en el directorio principal de Dokeos. El nuevo directorio principal debe estar ubicado directamente dentro de su directorio raiz de Dokeos
• 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 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 Dokeos.

3.3 En ambos casos

Los siguientes directorios necesitan permisos de lectura, escritura y ejecución para el servidor web:
• dokeos/main/inc/conf/
• dokeos/main/upload/users/
• dokeos/main/default_course_document/
• dokeos/archive/
• dokeos/courses/
• dokeos/home/
En Linux, Mac OS X y sistemas operativos BSD esto se puede arreglar rápidamente 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, quizás necesite revisar las propiedades de las carpetas.

3.4 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 Dokeos (para MySQL) es "dokeos_db_user" y su acceso es "dokeos_user"
• Actualmente la instalacion de Dokeos esta en /var/www/dokeos/ 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 dokeos_db_user -p --all-databases --result-file=/home/dokeos_user/dokeos_old.sql
• cp -ra /var/www/dokeos /home/dokeos_user/backup_dokeos
• mkdir /var/www/dokeos/version_antigua
• mv /var/www/dokeos/* /var/www/dokeos/version_antigua/
• chmod -R 0777 /var/www/dokeos/version_antigua/
• wget http://www.dokeos.com/download/dokeos-1.8.6.tar.gz
• tar zxvf dokeos-1.8.6.tar.gz
• sudo cp -ra dokeos-1.8.6/* /var/www/dokeos/
• rm dokeos-1.8.6.tar.gz
• sudo rm -r dokeos-1.8.6/

Luego:
• 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 Dokeos 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 Dokeos, abra el navegador, diríjase a su dirección de Dokeos 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 Dokeos, 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 Dokeos

En (la carpeta de Dokeos)/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
Desde 1.8.5, usted tiene que cambiar las configuraciones de LDAP dentro del panel "Administración del Portal", bajo "Opciones de configuración de Dokeos", sección "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, Dokeos revisará si el campo "employeenumber" tiene un valor. Si lo tiene, entonces Dokeos 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 Dokeos 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 Dokeos. 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 Dokeos son:


• uid, el cual se corresponde con el username en Dokeos
• 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 usadl como el campo lastname en Dokeos
• givenName es usado como el campo firstname en Dokeos
• mail es usado como el campo email en Dokeos

---

7. Conversión Oogie PowerPoint / Impress

Esta parte es opcional, solamente organizaciones que esperan convertir documentos Office para metodos de aprendizaje, quizas deseen leer esta parte.
Oogie convierte sus presentaciones provenientes de Ms-Office y OpenOffice.org en e-courses SCORM estandarizados o metodos de aprendizaje. Esta caracteristica necesita OpenOffice.org para convertir las diapositivas y RED5 (opcional) para grabar su voz sobre las diapositivas usando un grabador de audio basado en Flash.



7.1. Conversión PowerPoint / Impress

• Instalar OpenOffice.org
• Editar el archivo Setup.xcu de OpenOffice.org
En algunas computadoras Windows, se localizan en: C:\Archivos de Programa\OpenOffice.org 2.2\share\registry\data\org\openoffice\Setup.xcu
En algunas computadoras Linux, se localizan en: /usr/lib/openoffice/share/registry/data/org/openoffice/Setup.xcu
o en /usr/lib/openoffice/basis3.0/share/registry/data/org/openoffice/Setup.xcu

Y agregar el siguiente codigo

<prop oor:name="ooSetupConnectionURL">
<value>
socket,host=localhost,port=2002;urp;StarOffice.ServiceManager
</value>
</prop>

... exactamente debajo de estas lineas
 

<prop oor:name="ooSetupInstCompleted">
<value>false</value>
</prop>
Ingrese a su portal de Dokeos en la web > Sección administración >  Configuracion de Servicios > Oogie y escribir :

Host : localhost
Port : 2002
Username : (dejar vacio si OpenOffice.org se ejecuta en una maquina servidor web)
FTP password : (dejar vacio si OpenOffice.org se ejecuta en una maquina servidor web)
Path to LZX Files: /main/webrooms/recorder.swf
Size of the slides : 800x600 (tan grande como sus clientes usen, por lo general una resolución de pantalla de 1024x768)

• Iniciar OpenOffice.org. La conversión solo funciona si este software esta iniciado y ejecutandose. Revisar la pagina wiki MakeOOOListening para iniciar OpenOffice.org como un servicio.
• Probar la conversión : crear un curso > entrar al curso > Modos de Aprendizaje > conversión PowerPoint. Si las diapositivas estan convertidas, entonces OpenOffice.org esta atendiendo a Dokeos. 
NOTA : durante la conversión, usted debe ver una barra de progreso con un porcentaje. Si usted solamente ve una animacion GIF predeterminada de una barra de progreso sin porcentaje, entonces deberia instalar la biblioteca PECL para PHP.

NOTA : En servidores Linux, probablemente quiera hacer un $ sudo apt-get install msttcorefonts para instalar los tipos de letras de Microsoft. Esto dara a la conversión PowerPoint un mejor renderizado.




7.2. Grabador de Audio

Ver debajo : Videoconferencia



---

8. Videoconferencia y grabador de audio

Esta parte es opcional, solamente las organizaciones que deseen usar la caracteristica de videoconferencia quedran leer esto.
Nosotros ahora instalaremos y configuraremos RED5 Servidor de Flash de Codigo Abierto : la aplicación web RED5 de Dokeos. Esto proveera ambos

• Videoconferencia y
• Grabador de audio para Oogie
Oogie permite convertir diapositivas, pero tambien

• agrega pruebas, paginas y actividades entre las diapositivas, gracias al constructor de metodos de aprendizaje
• obtener reportes SCORM gracias a la herramienta de metodos de aprendizaje
• agregar audio sobre las diapositivas gracias al grabador de audio en linea
NOTA : los procesos de instalación previos para esta parte eran muy complejos. La configuración entera ha sido considerablemente simplificada. Por favor ignorar cualquier documentación previa del mismo tema.


Quizas usted desee usar las ventajas del grabador de audio y de la videoconferencia. Para esto :

• Descargar e instalar el servidor Flash de codigo abierto RED5 versión 0.6.x (usted encontrará paquetes para Linux y un instalador para Windows en el sitio web de RED 5)
• Descargar la aplicación Dokeos-recorder RED5
• Renombrarla a "dokeos-recorder.war" y copiarla dentro del directorio webapps de su instalación de RED5. Windows : Directorio objetivo puede ser C:/Archivos de programa/Red5/webapps/ . Linux con Nautilus o a traves de una consola de comandos : cp dokeos-recorder.war /usr/lib/red5/webapps (cuando RED5 es instalado median el uso del paquete de Debian)
• Tambien descargar la aplicación Dokeos-videoconf RED5
• Renombrarla a "dokeos-videoconf.war" y copiarla dentro del directorio webapps de su instalación de RED5. Windows : Directorio objetivo puede ser C:/Archivos de programa/Red5/webapps/ . Linux con Nautilus o a traves de una consola de comandos : cp dokeos-videoconf.war /usr/lib/red5/webapps
• Crear un archivo de configuración XML para Red5 (ejm. Linux: sudo mkdir /etc/dokeos/; sudo gedit /etc/dokeos/videoconference-config.xml)
• Insertar la configuración de la siguiente manera:

<?xml version="1.0" encoding="UTF-8"?>
  <videoconference-config>
    <server-keys>
      <server-key host="dokeos.domain.com_" key="PaSSw0rd" />
      <server-key host="www.domain.com_dokeos_" key="p4ssWoRD" />
    </server-keys>
    <moderator-check-on-whiteboard>false</moderator-check-on-whiteboard>
    <video-streams-dir>/opt/dokeos/recorded-streams</video-streams-dir>
    <vod-streams-dir>/opt/dokeos/vod-streams</vod-streams-dir>
  </videoconference-config>

En este archivo, usted al menos necesitara poner una linea de llave de servidor por portal. En el ejemplo siguiente nosotros autorizamos portales instalados en las URLs:
• http://dokeos.domain.com/
• http://www.domain.com/dokeos/
El caracter "_" al final de cada URL es importante, usted no debe olvidarlo.


Recargar Red5

Reiniciar Red5 para recargar el archivo de configuración y la nueva aplicación mediante el uso, en Ubuntu o Debian:
/etc/init.d/red5 restart

Mayor información de RED5 + Dokeos

Por favor visite esta página : http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0



Configuración de su plugin de Videoconferencia de dokeos

La configuraciñón del plugin de videoconferencia se realiza mediante las paginas de administración de la configuración de Dokeos en la sección de administración de la plataforma Dokeos, "Configurar los servicios", "Videoconferencia"

Se le solicitaran 4 cosas
• el nombre del host o la dirección IP de su servidor Red5 (ejm. red5.miservidor.com)
• el puerto (el puerto predeterminado es 1935 y nosotros le recomendamos que lo deje como tal)
• la contraseña (la cual fue configurada en el archivo de configuración de red5)
• si usted usa rtmpt o no (util para pasar a traves de cortafuegos pero lento). Para usar esta opción, usted tendra que configurar red5 para que pueda escucharse en el puerto 80. Ver http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0

Eso es todo! Clic en "Reconfigurar extensión" y sus cursos estarán equipados con dos enlaces adicionales hacia sus salas de videoconferencia...


---

7. Conversión Oogie PowerPoint / Impress

Esta parte es opcional, solamente organizaciones que esperan convertir documentos Office para metodos de aprendizaje, quizas deseen leer esta parte.
Oogie convierte sus presentaciones provenientes de Ms-Office y OpenOffice.org en e-courses SCORM estandarizados o metodos de aprendizaje. Esta caracteristica necesita OpenOffice.org para convertir las diapositivas y RED5 (opcional) para grabar su voz sobre las diapositivas usando un grabador de audio basado en Flash.



7.1. Conversión PowerPoint / Impress

• Instalar OpenOffice.org
• Editar el archivo Setup.xcu de OpenOffice.org
En algunas computadoras Windows, se localizan en: C:\Archivos de Programa\OpenOffice.org 2.2\share\registry\data\org\openoffice\Setup.xcu
En algunas computadoras Linux, se localizan en: /usr/lib/openoffice/share/registry/data/org/openoffice/Setup.xcu

Y agregar el siguiente codigo

<prop oor:name="ooSetupConnectionURL">
<value>
socket,host=localhost,port=2002;urp;StarOffice.ServiceManager
</value>
</prop>

... exactamente debajo de estas lineas
 

<prop oor:name="ooSetupInstCompleted">
<value>false</value>
</prop>
Ingrese a su portal de Dokeos en la web > Sección administración >  Configuracion de Servicios > Oogie y escribir :

Host : localhost
Port : 2002
Username : (dejar vacio si OpenOffice.org se ejecuta en una maquina servidor web)
FTP password : (dejar vacio si OpenOffice.org se ejecuta en una maquina servidor web)
Path to LZX Files: /main/webrooms/recorder.swf
Size of the slides : 800x600 (tan grande como sus clientes usen, por lo general una resolución de pantalla de 1024x768)

• Iniciar OpenOffice.org. La conversión solo funciona si este software esta iniciado y ejecutandose. Revisar la pagina wiki MakeOOOListening para iniciar OpenOffice.org como un servicio.
• Probar la conversión : crear un curso > entrar al curso > Modos de Aprendizaje > conversión PowerPoint. Si las diapositivas estan convertidas, entonces OpenOffice.org esta atendiendo a Dokeos. 
NOTA : durante la conversión, usted debe ver una barra de progreso con un porcentaje. Si usted solamente ve una animacion GIF predeterminada de una barra de progreso sin porcentaje, entonces deberia instalar la biblioteca PECL para PHP.

NOTA : En servidores Linux, probablemente quiera hacer un $ sudo apt-get install msttcorefonts para instalar los tipos de letras de Microsoft. Esto dara a la conversión PowerPoint un mejor renderizado.




7.2. Grabador de Audio

Ver debajo : Videoconferencia



---

8. Videoconferencia y grabador de audio

Esta parte es opcional, solamente las organizaciones que deseen usar la caracteristica de videoconferencia quedran leer esto.
Nosotros ahora instalaremos y configuraremos RED5 Servidor de Flash de Codigo Abierto : la aplicación web RED5 de Dokeos. Esto proveera ambos

• Videoconferencia y
• Grabador de audio para Oogie
Oogie permite convertir diapositivas, pero tambien

• agrega pruebas, paginas y actividades entre las diapositivas, gracias al constructor de metodos de aprendizaje
• obtener reportes SCORM gracias a la herramienta de metodos de aprendizaje
• agregar audio sobre las diapositivas gracias al grabador de audio en linea
NOTA : los procesos de instalación previos para esta parte eran muy complejos. La configuración entera ha sido considerablemente simplificada. Por favor ignorar cualquier documentación previa del mismo tema.


Quizas usted desee usar las ventajas del grabador de audio y de la videoconferencia. Para esto :

• Descargar e instalar el servidor Flash de codigo abierto RED5 versión 0.6.x (usted encontrará paquetes para Linux y un instalador para Windows en el sitio web de RED 5)
• Descargar la aplicación Dokeos-recorder RED5
• Renombrarla a "dokeos-recorder.war" y copiarla dentro del directorio webapps de su instalación de RED5. Windows : Directorio objetivo puede ser C:/Archivos de programa/Red5/webapps/ . Linux con Nautilus o a traves de una consola de comandos : cp dokeos-recorder.war /usr/lib/red5/webapps (cuando RED5 es instalado median el uso del paquete de Debian)
• Tambien descargar la aplicación Dokeos-videoconf RED5
• Renombrarla a "dokeos-videoconf.war" y copiarla dentro del directorio webapps de su instalación de RED5. Windows : Directorio objetivo puede ser C:/Archivos de programa/Red5/webapps/ . Linux con Nautilus o a traves de una consola de comandos : cp dokeos-videoconf.war /usr/lib/red5/webapps
• Crear un archivo de configuración XML para Red5 (ejm. Linux: sudo mkdir /etc/dokeos/; sudo gedit /etc/dokeos/videoconference-config.xml)
• Insertar la configuración de la siguiente manera:

<?xml version="1.0" encoding="UTF-8"?>
  <videoconference-config>
    <server-keys>
      <server-key host="dokeos.domain.com_" key="PaSSw0rd" />
      <server-key host="www.domain.com_dokeos_" key="p4ssWoRD" />
    </server-keys>
    <moderator-check-on-whiteboard>false</moderator-check-on-whiteboard>
    <video-streams-dir>/opt/dokeos/recorded-streams</video-streams-dir>
    <vod-streams-dir>/opt/dokeos/vod-streams</vod-streams-dir>
  </videoconference-config>

En este archivo, usted al menos necesitara poner una linea de llave de servidor por portal. En el ejemplo siguiente nosotros autorizamos portales instalados en las URLs:
• http://dokeos.domain.com/
• http://www.domain.com/dokeos/
El caracter "_" al final de cada URL es importante, usted no debe olvidarlo.


Recargar Red5

Reiniciar Red5 para recargar el archivo de configuración y la nueva aplicación mediante el uso, en Ubuntu o Debian:
/etc/init.d/red5 restart

Mayor información de RED5 + Dokeos

Por favor visite esta página : http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0



Configuración de su plugin de Videoconferencia de dokeos

La configuraciñón del plugin de videoconferencia se realiza mediante las paginas de administración de la configuración de Dokeos en la sección de administración de la plataforma Dokeos, "Configurar los servicios", "Videoconferencia"

Se le solicitaran 4 cosas
• el nombre del host o la dirección IP de su servidor Red5 (ejm. red5.miservidor.com)
• el puerto (el puerto predeterminado es 1935 y nosotros le recomendamos que lo deje como tal)
• la contraseña (la cual fue configurada en el archivo de configuración de red5)
• si usted usa rtmpt o no (util para pasar a traves de cortafuegos pero lento). Para usar esta opción, usted tendra que configurar red5 para que pueda escucharse en el puerto 80. Ver http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0

Eso es todo! Clic en "Reconfigurar extensión" y sus cursos estarán equipados con dos enlaces adicionales hacia sus salas de videoconferencia...


---

9. Formulas 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 Dokeos (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 dokeos/main/inc/lib/mimetex/(*ver debajo)
• 2. Recargar su configuración de Apache
• 3. Editar dokeos/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"] = [
    ['Bold','Italic','Underline','StrikeThrough','Subscript','Superscript','Link','Unlink','ImageManager','MP3','OrderedList','UnorderedList','Table','mimetex']
    ] ;
    Usted puede agregarlo a todas las herramientas, o sólo a alguna de ellas (por ej., documentos y ejercicios)
    
    
• 4. Para servidores Windows solamente, actualizar dokeos/main/inc/lib/fckeditor/editor/plugins/mimetex/mimetex.html para reemplazar mimetex.cgi por mimetex.exe
• 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
Agregar el directorio cgi-bin correspondiente a su configuración 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 simbólico bajo Windows, puede ser realizado mediante la creación de un acceso directo al archivo mimetex.exe desde el directorio cgi-bin, o bajo Linux usando el siguiente comando:
ln -s /var/www/dokeos/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi
Este procedimiento creará un nuevo icono disponible en su editor en linea de Dokeos , el cual hara posible la inserción de formulas matemáticas en sus documentos.



---

10. Múltiples URLs

• Ingresar al sistema como Administrador de la plataforma y visitar la página de Administración (main/admin/index.php)
• Habilitar la opción de Múltiples URLs en la página de Administración descomentando la siguiente línea en main/inc/configuration.php
  $_configuration['multiple_access_urls'] = true;
• Acceder al nuevo enlace: "Configurar acceso a multiple URLs" en las opciones de Plataforma.
• Editar la URL con el nombre de dominio y agregar nuevos usuarios haciendo click en el enlace "Administrar usuarios". Es muy importante que el usuario Adminstrador esté registrado en los 2 portales, de lo contrario no podrá tener acceso. Por defecto todos los estudiantes registrados están asociados al primer sitio.
• Para configurar el segundo sitio Dokeos se debe crear un nuevo virtualhost (en Apache) que apunte a la misma carpeta (DocumentRoot) pero con un nombre (ServerName) diferente.
• Una vez instalado este nuevo virtualhost, es necesario agregar un nuevo sitio haciendo click en el enlace: "Agregar URL".
• Se agregan los nuevos usuarios a la segunda URL. Si un usuario no esta asociado a una URL entonces no podrá acceder al sistema.
• Las dos instalaciones podrán ser configuradas de manera distinta solo es necesario editar las configuraciones que tengan el siguiente icono: a lado de la descripción. Talvez querrá modificar el nombre de la organización, nombre del administrador, etc.