<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/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>
De manera predeterminada, Dokeos revisará si el campo "employeenumber" tiene un valor. Si lo tiene, entonces Dokeos
considerara que este usuario es profesor.<br/>
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 <em>if (empty($info_array[$tutor_field]))</em> a lo que encaje para usted.<br/>
Adicionalmente usted puede remover esta revisión, eliminando la condicion y dejando solamente la linea <em>$status = STUDENT;</em>
</p>
<h3><b>Servidores LDAP protegidos</b></h3>
<p>
Algunos servidores LDAP no permiten usos anonimos de los servicios del directorio.<br/>
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.</p>
<h3>Importar LDAP en sesiones</h3>
<p>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.<br/>
Los campos usados intensivamente por el modulo de Dokeos son:<br/>
</p>
<ul>
<li>uid, el cual encaja con el username en Dokeos</li>
<li>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.</li>
<li>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</li>
<li>sn es usadl como el campo lastname en Dokeos</li>
<li>givenName es usado como el campo firstname en Dokeos</li>
<li>mail es usado como el campo email en Dokeos</li>
</ul>
<hrstyle="width: 100%; height: 2px;"/>
<h2><aname="7._Mathematical_formulas"></a>7. 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. En raras ocasiones (sólo si se detecta algún problema), las opciones de configuración del fichero /dokeos/main/inc/lib/fckeditor/fckeditor.php tendrán que ser editadas manualmente</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>
<li>6. Realice estos cambios:</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>
