<ahref="index.html">Documentación</a>> Guia de Instalación
<divid="outerframe">
<divid="main">
<p></p>
<p>Gracias por descargar Dokeos, la suite de aprendizaje de código abierto profesional.</p>
<ul>
<li>Vista rapida de las <ahref="http://www.dokeos.com/en/node/58">Características de Dokeos </a></li>
<li>Prueba Dokeos en <ahref="http://campus.dokeos.com">Free Campus</a></li>
</ul>
<p>Esta guía explica como instalar la Gestión de Aprendizaje de Dokeos. Explica como instalar la conversión a PowerPoint Dokeos Oogie
y la videoconferencia de Dokeos sin embargo estos paquetes
no son requeridos para usar Dokeos LMS. Por favor lea completamente este documento antes de proceder con la instalación. </p>
Si desea ahorrar tiempo, problemas y dinero, alternativamente puede tener su Portal de Dokeos <ahref="http://www.dokeos.com/en/node/6">desplegado</a> o <ahref="http://www.dokeos.com/en/node/32">instalado</a> por Dokeos o alguno de sus socios.<br/>
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. <br/>
<br/>
Dokeos es principalmente un LMS que se ejecuta con <spanstyle="font-weight: bold;">Apache</span>, <spanstyle="font-weight: bold;">MySQL</span> y <spanstyle="font-weight: bold;">PHP5</span> (tambien llamada la trilogía <spanstyle="font-weight: bold;">AMP</span>). <br/>
<br/>
Puede ser enriquecida con conversión a PowerPoint (característica llamada Dokeos
Oogie) mediante el uso de <spanstyle="font-weight: bold;">OpenOffice.org</span> + Java. Quizas usted también desee agregar el plugin de Videoconferencia de Dokeos mediante el uso de <spanstyle="font-weight: bold;">RED5</span>
servidor de codigo abierto de Flash. <br/>
<br/>
Todo este software es software de código abierto y está disponible libremente. <br/>
<br/>
Para ejecutar Dokeos <spanstyle="font-weight: bold;">LMS</span> en su servidor, usted necesita instalar WAMP, LAMP o MAMP:
<ul>
<li>Para instalar <spanstyle="font-weight: bold;">WAMP</span> (AMP en Windows), nosotros recomendamos el instalador <ahref="http://www.apachefriends.org/en/xampp.html">XAMPP</a> .exe<ahref="http://www.apachefriends.org/en/xampp.html"></a></li>
(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
<ahref="http://ubuntuguide.org/wiki/Ubuntu:Feisty#Apache_HTTP_Server">Ubuntuguide on Apache</a> y las secciones siguientes.</li>
<li>Para instalar <spanstyle="font-weight: bold;">MAMP</span> (AMP en Mac OS X), referirse al sitio web dedicado a <ahref="http://www.mamp.info/en/index.php">MAMP</a><ahref="http://www.mamp.info/en/index.php"></a></li>
</ul>
<br/>
<h3><spanstyle="font-weight: bold;">Servidor de Base de Datos MySQL</span></h3>
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 creado. Esto significa que su proveedor debera permitirle crear y
administrar varias bases de datos. Usted también puede instalar Dokeos y usar
sólo una base de datos, en ese caso, usted tiene que seleccionar esta opción durante
la instalación.
<br/>
<br/>
Para aprovechar la ventaja de la conversión <spanstyle="font-weight: bold;">Oogie</span> de PowerPoint / Impress, usted necesita: <br/>
<li>Copiar el directorio de dokeos en su directorio web de Apache. Este puede ser
<spanstyle="font-weight: bold;">C:\xampp\htdocs\</span> en un servidor Windows o <spanstyle="font-weight: bold;">/var/www/html/</span> en un servidor Linux</li>
<li>Abrir su navegador web (Internet Explorer, Firefox...) y escribir
<spanstyle="font-weight: bold;">http://localhost/dokeos/</span> si se instala de manera local o
<spanstyle="font-weight: bold;">http://www.domain.com/dokeos/</span> si se instala remotamente</li>
<li>Seguir el proceso de instalación web. Usted puede aceptar todos los valores
predeterminados. Considere cambiar la contraseña de administrador y recuerdela. </li>
</ul>
<br/>
Los siguientes directorios necesitan tener permisos de lectura, escritura y ejecución para todos:
<ul>
<li>dokeos/main/inc/conf/</li>
<li>dokeos/main/garbage/</li>
<li>dokeos/main/upload/users/</li>
<li>dokeos/main/default_course_document/</li>
<li>dokeos/archive/</li>
<li>dokeos/courses/</li>
<li>dokeos/home/</li>
</ul>
(donde 'dokeos' es el directorio en el cual usted instaló Dokeos)
<p>En Linux, Mac OS X y sistemas operativos BSD usted puede usar el comando CHMOD
777 para esto (aunque nosotros recomendamos que busque asistencia de un
administrador de sistemas con experiencia).
En Windows, es probable que usted necesite revisar las propiedades de las carpetas (mediante el uso
del clic derecho en ellas).
</p>
<p>
2.5. Los siguientes archivos necesitan tener permisos de lectura y escritura
para el navegador web, solo durante la instalación de Dokeos:
</p>
<ul>
<li>dokeos/main/inc/conf/configuration.php (si esta presente)</li>
</ul>
<p>En Linux, Mac OS X y sistemas operativos BSD usted puede usar el comando CHMOD
666 para esto (aunque nosotros recomendamos que busque asistencia de un
administrador de sistemas con experiencia).
En Windows, es probable que usted necesite revisar las propiedades de las carpetas (mediante el uso
del clic derecho en ellas).
</p>
<p>
<b>NOTAS:</b><br/>
No modifique los archivos home_*.html directamente. En vez de ello,
seleccione "Configurar la pagina de inicio" en la sección de administración de Dokeos.</p>
<p><spanstyle="font-weight: bold;">Windows</span> : con paquetes combinados como XAMPP, disponibles por todo lado, la cuenta de acceso y contraseña
para MySQL probablemente permanecera vacia.</p>
<p></p>
<h3><strong> Configuración y seguridad despues de la instalación</strong></h3>
<ul>
<li><strong>Proteger su archivo de configuración: </strong>
asegurarse que nadie pueda sobreescribirlo. Usted puede encontrar el archivo de configuración en la <em>(carpeta de dokeos)</em>/main/inc/conf/configuration.php.
Hacerla 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 adminitrador para cambiar sus
permisos.</li>
<li><strong>Proteger su carpeta de instalación: </strong>
si la <em>(carpeta de dokeos)</em>carpeta /main/install
es aun accesible, alguien podria instalar de nuevo sobre su versión existente
(usted puede perder sus datos de esta manera). Mover la carpeta a algún lugar
fuera de los directorios web para que no se encuentre accesible, cambiar su nombre, o
editar sus propiedades para que nadie pueda leerlo o ejecutarlo.</li>
<li><strong>Para mayor seguridad: </strong>
hacer que los archivos posean permisos de escritura por todos ayudaria a instalar, y resolveria varias
dudas a las personas sin mucha experiencia en administracion. Sin embargo, es mas seguro
hacer al propietario del proceso de apache (usualmente llamado apache
o www-data) tambien propietario de todos los archivos y carpetas de dokeos. De esta manera,
estos archivos solo tendrian permisos de lectura y escritura por el propietario
del proceso Apache, y ya no permiso a todo el mundo.</li>
<li><strong>Configurar su instalación de Dokeos: </strong>
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.</li>
<li><strong>Configurar correo de Dokeos: </strong>
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 <em>(la carpeta de dokeos)</em>/main/inc/conf/mail.conf.php.</li>
</ul>
<br/>
<h3>Configuración PHP</h3>
Para obtener lo mejor de Dokeos, usted necesita afinar las configuraciones de PHP. Considerar: <br/>
<ul>
<li>Editar el archivo php.ini (en windows puede ser ubicado en <spanstyle="font-weight: bold;">C:\xampp\php\php.ini</span>, en Ubuntu Linux : <spanstyle="font-weight: bold;">/etc/php5/apache2/php.ini</span></li>
<li>buscar la palabra "max" y incrementar los valores para optimizar el servidor</li>
<li>quizas usted desee terminar; con los siguiente valores: </li>
</ul>
<br/>
<divclass="code">
max_execution_time = 300 ; Maximo tiempo de ejecucion para cada script, en segundos<br/>
max_input_time = 600 ; Maxima cantidad de tiempo para cada script que pueda gastar analizando datos solicitados<br/>
memory_limit = 256M ; Maxima cantidad de memoria que un script puede consumir (128MB)<br/>
post_max_size = 64M<br/>
upload_max_filesize = 100M
</div>
<br/>
<p>
Algunos usuarios pueden encontrar problemas si en sus configuraciones de PHP no
encajan las siguientes:</p>
<ul>
<li>short_open_tag = On</li>
<li>safe_mode = Off</li>
<li>magic_quotes_gpc = On</li>
<li>magic_quotes_runtime = Off</li>
</ul>
<p>
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.
</p>
<p><strong>Usuarios BSD:</strong> estas bibliotecas de php tienen que ser incluidas durante la instalación de php:</p>
<ul>
<li>php-mysql La extensión compartida de mysql para php</li>
<li>php-pcre La extensión compartida de pcre para php</li>
<li>php-session La extensión compartida de sesión para php</li>
<li>php-zlib La extensión compartida de zlib para php</li>
<li>(opcional) php-ldap si se desea habilitar el uso de la autenticación de LDAP</li>
<i>Esta parte es opcional, solamente organizaciones que esperan convertir documentos Office para metodos de aprendizaje, quizas deseen leer esta parte.</i><br/>
Oogie convierte sus presentaciones provenientes de Ms-Office y OpenOffice.org en e-courses SCORM estandarizados o <spanstyle="font-style: italic;">metodos de aprendizaje</span>.
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.<br/>
<br/>
<h3>7.1. Conversión PowerPoint / Impress </h3>
<ul>
<li>Instalar OpenOffice.org</li>
<li>Editar el archivo Setup.xcu de OpenOffice.org </li>
</ul>
<divclass="code">En algunas computadoras Windows, se localizan en: <spanstyle="font-weight: bold;">C:\Archivos de Programa\OpenOffice.org 2.2\share\registry\data\org\openoffice\Setup.xcu</span><br/>
En algunas computadoras Linux, se localizan en: <spanstyle="font-weight: bold;">/usr/lib/openoffice/share/registry/data/org/openoffice/Setup.xcu</span>
Ingrese a su portal de Dokeos en la web ><spanstyle="font-style: italic;">Sección administración > Configuracion de Servicios > Oogie </span>y escribir :<br/>
<divclass="code">
<spanstyle="font-weight: bold;">Host : </span>localhost<br/><spanstyle="font-weight: bold;">Port</span> : 2002<br/><spanstyle="font-weight: bold;">Username</span> : (dejar vacio si OpenOffice.org se ejecuta en una maquina servidor web)<br/><spanstyle="font-weight: bold;">FTP password</span> : (dejar vacio si OpenOffice.org se ejecuta en una maquina servidor web)<br/>
<spanstyle="font-weight: bold;">Path to LZX Files</span>: /main/webrooms/recorder.swf<br/><spanstyle="font-weight: bold;">Size of the slides </span>: 800x600
(tan grande como sus clientes usen, por lo general una resolución de pantalla de 1024x768)<br/></div>
<ul>
<li>Iniciar OpenOffice.org. La conversión solo funciona si este software esta iniciado y ejecutandose. Revisar la pagina wiki <ahref="http://www.dokeos.com/wiki/index.php/MakeOOOListening">MakeOOOListening</a> para iniciar OpenOffice.org como un servicio.</li>
<li>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. </li>
</ul>
<spanstyle="font-weight: bold;">NOTA</span> : 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. <br/>
<br/>
<spanstyle="font-weight: bold;">NOTA</span> : En servidores Linux, probablemente quiera hacer un <spanstyle="font-weight: bold;">$ sudo apt-get install msttcorefonts</span> para instalar los tipos de letras de Microsoft. Esto dara a la conversión PowerPoint un mejor renderizado. <br/>
<br/>
<spanstyle="font-weight: bold;"><br/>
</span>
<h3>7.2. Grabador de Audio</h3>
Ver debajo : Videoconferencia<br/>
<br/>
<hrstyle="width: 100%; height: 2px;"/>
<h2><aname="8._Videoconferencing_and_audio-recorder"></a>8. Videoconferencia y grabador de audio</h2>
<i>Esta parte es opcional, solamente las organizaciones que deseen usar la caracteristica de videoconferencia quedran leer esto.</i><br/>
Nosotros ahora instalaremos y configuraremos RED5 Servidor de Flash de Codigo Abierto : la aplicación web RED5 de Dokeos. Esto proveera ambos <br/>
<ul>
<li>Videoconferencia y</li>
<li>Grabador de audio para Oogie</li>
</ul>
Oogie permite convertir diapositivas, pero tambien <br/>
<ul>
<li>agrega pruebas, paginas y actividades entre las diapositivas, gracias al constructor de metodos de aprendizaje</li>
<li>obtener reportes SCORM gracias a la herramienta de metodos de aprendizaje</li>
<li>agregar audio sobre las diapositivas gracias al grabador de audio en linea</li>
</ul>
<spanstyle="font-weight: bold;">NOTA</span> : 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.
<br/>
<br/>
<br/>
Quizas usted desee usar las ventajas del grabador de audio y de la videoconferencia. Para esto :<br/>
<ul>
<li>Descargar e instalar <ahref="http://osflash.org/red5"> el servidor Flash de codigo abierto RED5 versión 0.6.x</a> (usted encontrará paquetes para Linux y un instalador para Windows en el sitio web de RED 5)</li>
<li>Renombrarla a "dokeos-recorder.war" y copiarla dentro del directorio <spanstyle="font-style: italic;">webapps</span> 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)</li>
<li>Renombrarla a "dokeos-videoconf.war" y copiarla dentro del directorio <spanstyle="font-style: italic;">webapps</span> 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</li>
<li>Crear un archivo de configuración XML para Red5 (ejm. Linux: sudo
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:
<ul>
<li>http://dokeos.domain.com/</li>
<li>http://www.domain.com/dokeos/</li>
</ul>
El caracter "_" al final de cada URL es importante, usted no debe olvidarlo.<br/>
<h4>Recargar Red5</h4>
Reiniciar Red5 para recargar el archivo de configuración y la nueva aplicación mediante el uso, en Ubuntu o Debian:
<divclass="code">
/etc/init.d/red5 restart
</div>
<h4>Mayor información de RED5 + Dokeos</h4>
Por favor visite esta página : <ahref="http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0">http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0</a><br/>
<br/>
<h4>Configuración de su plugin de Videoconferencia de dokeos</h4>
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"<br/>
<br/>
Se le solicitaran 4 cosas
<ul>
<li>el nombre del host o la dirección IP de su servidor Red5 (ejm. red5.miservidor.com)</li>
<li>el puerto (el puerto predeterminado es 1935 y nosotros le recomendamos que lo deje como tal)</li>
<li>la contraseña (la cual fue configurada en el archivo de configuración de red5)</li>
<li>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 <ahref="http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0">http://www.dokeos.com/wiki/index.php/Installing_videoconference_2.0</a></li>
</ul>
<br/>
Eso es todo! Clic en "Reconfigurar extensión" y sus cursos estarán equipados
con dos enlaces adicionales hacia sus salas de videoconferencia...<br/>
<hrstyle="width: 100%; height: 2px;"/>
<h2><aname="9._Mathematical_formulas"></a>9. Formulas Matemáticas con LaTeX</h2>
<i>Esta parte es opcional, solo las organizaciones que deseen usar formulas matemáticas dentro del editor en linea podran querer leer esto.</i><br/>
Usted puede habilitar la escritura de ecuaciones matemáticas dentro del editor en linea de Dokeos (FCKEditor) aplicando los siguientes pasos:
<ul>
<li>1. Configurar su instalación de Apache para agregar un directorio cgi-bin que contenga un enlace simbólico a mimetex.cgi en <i>dokeos/main/inc/lib/mimetex/</i>(*ver debajo)</li>
<li>2. Recargar su configuración de Apache</li>
<li>3. Editar <i>dokeos/main/inc/lib/fckeditor/myconfig.js</i> y
<ul>
<li>3.1. Agregar <b>FCKConfig.Plugins.Add("mimetex", "en", sOtherPluginPath ) ;</b> al final del archivo</li>
<li>3.2. Agregar <b>'mimetex'</b> al final de las lineas
FCKConfig.ToolbarSets donde usted desee que el icono de LaTeX aparezca
(existe un FCKConfig.ToolbarSets por herramienta). Por ejemplo:
Usted puede agregarlo a todas las herramientas, o solamente a las herramientas de documentos y pruebas, por ejemplo<br/>
<br/>
</li>
</ul>
</li>
<li>4. Para servidores Windows solamente, actualizar <i>dokeos/main/inc/lib/fckeditor/editor/plugins/mimetex/mimetex.html</i> para reemplazar <b>mimetex.cgi</b> por <b>mimetex.exe</b></li>
<li>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</li>
</ul>
<i>Agregar el directorio cgi-bin correspondiente a su configuración de Apache puede ser lograda de esta manera, en Apache 2:</i>
