# Guía de Instalación de Dokeos 1.8.6 Svalbard

Documentación > Guia de Instalación

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

- Vista rapida de las Características de Dokeos
- Prueba Dokeos en Free Campus

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.

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. Pre-requisitos
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. Formulas Matemáticas con LaTeX

## 1. Pre-requisitos

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 principalmente un LMS que se ejecuta con Apache, MySQL y PHP5 (tambien llamada la trilogía AMP).
Puede ser enriquecida con conversión a PowerPoint (característica llamada Dokeos Oogie) mediante el uso de OpenOffice.org + Java. Quizas usted también desee agregar el plugin de Videoconferencia de Dokeos mediante el uso de RED5 servidor de codigo abierto de Flash.
Todo este software es software de código abierto y está disponible libremente.
Para ejecutar Dokeos LMS en su servidor, usted necesita instalar WAMP, LAMP o MAMP:

- Para instalar WAMP (AMP en Windows), nosotros 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 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.
Para aprovechar la ventaja de la conversión Oogie de PowerPoint / Impress, usted necesita:

- OpenOffice.org
- Java Runtime Environment

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

- Servidor de Flash de Codigo 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 recuerdela.

Los siguientes directorios necesitan tener permisos de lectura, escritura y ejecución para todos:

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

2.5. Los siguientes archivos necesitan tener permisos de lectura y escritura para el navegador web, solo durante la instalación de Dokeos:

- dokeos/main/inc/conf/configuration.php (si esta presente)

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

NOTAS:
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.

Windows : con paquetes combinados como XAMPP, disponibles por todo lado, la cuenta de acceso y contraseña para MySQL probablemente permanecera vacia.

### Configuración y seguridad despues de la instalación

- Proteger su archivo de configuración: asegurarse que nadie pueda sobreescribirlo. Usted puede encontrar el archivo de configuración en la (carpeta de dokeos)/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.
- Proteger su carpeta de instalación: si la (carpeta de dokeos)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.
- Para mayor seguridad: 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.
- 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 (la carpeta de dokeos)/main/inc/conf/mail.conf.php.

### Configuración PHP

Para obtener lo mejor de Dokeos, usted necesita afinar las configuraciones de PHP. Considerar:

- Editar el archivo php.ini (en windows puede ser 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
- quizas usted desee terminar; con los siguiente valores:

max_execution_time = 300 ; Maximo tiempo de ejecucion para cada script, en segundos
max_input_time = 600 ; Maxima cantidad de tiempo para cada script que pueda gastar analizando 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 encajan 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

## 3. Actualizar desde una versión previa de Dokeos

Antes de actualizar, nosotros recomendamos seriamente hacer una copia de seguridad de los directorios previos de Dokeos y las bases de datos. Si no esta seguro de como hacer esto, por favor 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 usted no haya dejado alguna hoja de estilo personalizada o imagen*
- descargar el paquete de instalación de Dokeos 1.8.6 desde la pagina 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 clic en Actualizar desde 1.8.x

* Los estilos e imagenes están ubicados en el directorio main/css o main/img. Usted aun puede recuperarlos desde la copia de seguridad si es que usted la hizo. Cualquier estilo o imagen modificada que use el nombre predeterminado style/image sera sobreescrita en el siguiente paso. Para evitar perder cualquier personalizacion, siempre asegurese de copiar styles/images bajo un nuevo nombre y use y modifique la copia, no el original. El original siempre sera sobreescrito por nuevas versiones. En Dokeos 1.8.5, hemos cambiado el nombre de varios temas CSS. La compatibilidad hacia atras esta asegurada por el hecho de que una actualizacion solo agrega los nuevos temas, sin embargo usted debe tratar y usar estos nuevos temas en lugar de quedarse con los antiguos que estaran obsoletos dentro de poco (sin mantenimiento).

### 3.2 Actualizar desde Dokeos 1.6.x

Si usted actualiza desde una version anterior a Dokeos (1.6.x), lo primero y mas importante por 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 instalacion 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 pagina 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 carpeta raiz de Dokeos
- apuntar su navegador a la URL de su portal
- escoja su idioma y clic en Actualizar desde 1.6.x y confirmar el directorio actual de la version antigua

NOTA: La actualizacion desde 1.6.x a 1.8.x implica una revision de los graficos y estilos personalizados. La nueva version usa un nuevo conjunto completo de iconos y estilos, lo cual significa que aquellos provenientes de la version 1.6 no pueden ser simplemente reusados. La buena noticia es que la version 1.8.x le permite crear su propio estilo en una carpeta css separada, la cual se puede reusar en todas las versiones 1.8.x

ADVERTENCIA:
No elimine el directorio de instalacion previo de Dokeos antes de instalar el nuevo. Usted puede remover la ruta antigua, cuando la actualizacion sea finalizada satisfactoriamente.

NOTA:
No modifique los archivos de home_*.html directamente. En lugar de ello, seleccione "Configurar la pagina 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 se puede arreglar rapidamente esto, mediante el uso del comando CHMOD 777, sin embargo si usted esta inseguro, nosotros le recomandamos que busque asistencia para su propio SO en nuestro foro. En Windows, quizas usted necesite revisar las propiedades de las carpetas.

### 3.4 Guia de Actualizacion Rapida desde 1.6.x para Linux

La siguiente guia de actualizacion 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 linea 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, ir 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 tambien mantenemos una lista de Preguntas Frecuentes.

##

## 5. Sección de Administración

Para acceder a la sección de administracion de Dokeos, abra el navegador, dirijase a su direccion de Dokeos y acceda a el con el usuario admin. Luego usted vera un enlace a la "Seccion de administracion de la plataforma" en la parte superior de la pagina web. En ese lugar usted puede administrar usuarios, cursos, secciones, apariencia del portal contenido de la pagina principal, categorias de cursos, entre otros.

## 6. LDAP

Esta parte es opcional, solamente organizaciones con un servidor LDAP necesitan leer esto.
Un modulo LDAP esta ya provisto en Dokeos, pero tiene que ser configurado para hacerlo funcionar.

### Compilar

Servidores Linux: Es posible que se requiera recompilar php con soporte ldap. Distribuciones nuevas tambien 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";
remover // de las dos ultimas lineas 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; // su numero 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 considerara 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 lo que encaje para usted.
Adicionalmente usted puede remover esta revisión, eliminando la condicion y dejando solamente la linea $status = STUDENT;

### Servidores LDAP protegidos

Algunos servidores LDAP no permiten usos anonimos de los servicios del directorio.
En este caso, usted debe rellenar los campos apropiados en el panel de administracion (ejm. "manager" y "mypassword") y Dokeos tratará de autenticarse usando esto, o volver al modo anonimo antes de darse por vencido.

### Importar LDAP en sesiones

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

- uid, el cual encaja con el username en Dokeos
- userPassword, el cual encaja con la contraseña del usuario, aunque esta parte solamente funcionara con contraseñas no encriptadas por ahora, pero no seria necesario si se usa el servidor LDAP para autenticació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 ser obtenidos 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. Formulas Matemáticas con LaTeX

Esta parte es opcional, solo las organizaciones que deseen usar formulas matemáticas dentro del editor en linea podran querer leer esto.
Usted puede habilitar la escritura de ecuaciones matemáticas dentro del editor en linea 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 solamente a las herramientas de documentos y pruebas, por ejemplo
- 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 lograda 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 logrado 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.
Dirección de Contacto: Dokeos, Rue du Corbeau, 108, B-1030 Brussels, Belgium
Correo: info@dokeos.com
Tel. +32 (0)2 669 69 55