diff --git a/documentation/installation_guide.html b/documentation/installation_guide.html index da7d4a024e..121c4a8530 100644 --- a/documentation/installation_guide.html +++ b/documentation/installation_guide.html @@ -1,722 +1,685 @@ - - - - - - - - - - Dokeos 1.8.6 Installation Guide - - - - - - - - - - -
-

Dokeos 1.8.6 FREE : Installation Guide

- -
- -Documentation > Installation Guide -
-
-

- - -

Thank you for downloading Dokeos Svalbard FREE.

- - - - - -

This guide explains how to install Dokeos FREE. Please read this fully before proceeding with the installation.

Check Dokeos PRO and Dokeos MEDICAL for a complete learning suite with a Service Level Agreement.
- - -

Contents

- -
    - -
  1. Pre-requisites
    2. - -
  2. Installation of Dokeos LMS
    3. - -
  3. Upgrade from a previous version of Dokeos
    4. - -
  4. Troubleshooting
    5. - -
  5. Administration section
    6. - -
  6. LDAP 
    7. - -
  7. Mathematical formulas with LaTeX
    8. - -
- - -
- -
-

1. Pre-requisites

- - -Dokeos -can be installed on Windows, Linux, Mac OS X and UNIX servers -indifferently. However, we recommend the use of Linux server for -optimal flexibility, remote control and scalability.
- -
- -Dokeos is mainly a LMS running Apache, MySQL and PHP5 (the so called AMP trilogy).
- - -
- -All these software are open source and freely available.
- -
- -To run Dokeos LMS on your server, you need to install WAMP, LAMP or MAMP: - - - -
- - -

MySQL database server

- -You will need a login and password allowing to administrate and create -at least one database. By default, Dokeos will create a new database -for each course created. It means your host should allow you to create -and administrate several databases. You can also install Dokeos using -only one database, in that case you have to select this option during -the installation.
- - -
-

2. Installation of Dokeos LMS

- - - - - -
- -The following directories need to be readable, writeable and executable for everyone: - - -(where 'dokeos' is the directory in which you installed Dokeos) -

On Linux, Mac OS X and BSD operating systems you can use the CHMOD -777 command for this (although we recommend you seek advice from an -experienced system administrator). -In Windows, you may need to check the properties of the folders (by -right-clicking on them). -

- -

-2.5. The following files need to be readable and writeable for the web browser, -only during the installation process: -

- - - - -

On Linux, Mac OS X and BSD operating systems you can use the CHMOD -666 command for this (although we recommend you seek advice from an -experienced system administrator). -In Windows, you may need to check the properties of the files and -folders (by right-clicking on them). -

- - - - -

-NOTES:
- -Do not modify the home_*.html files directly. Instead, -choose "Configure the homepage" in the Dokeos administration section.

- -

Windows : with combination packages like XAMPP, out of the box, login and password - for MySQL should probably remain empty.

- -

- - -

Configuration and security after installation

- - - -
- - -

PHP configuration

- - -To get the best of Dokeos, you need to finetune PHP settings. Consider :
- - - - - -
- max_execution_time = 300    ; Maximum execution time of each script, in seconds
- - max_input_time = 600 ; Maximum amount of time each script may spend parsing request data
- - memory_limit = 256M      ; Maximum amount of memory a script may consume (128MB)
- - post_max_size = 64M
- - upload_max_filesize = 100M -
- - - -

-Some users could meet problems if their PHP settings don't fit -these ones:

- - - - - -

-Past Dokeos versions required register_globals to be set to On. This is -no longer necessary, this can be set to Off and Dokeos will work fine. -

- - -

BSD users: these php libraries have to be included during php installation:

- - - - - -


- - -

- - -
-

3. Upgrade from a previous version of Dokeos

-Before upgrading we heavily recommend you do a full backup of the previous -Dokeos directories and databases. If you are unsure how to achieve this -please ask your hosting provider for advice.
- -

- - -

3.1 Upgrading from Dokeos 1.8.x

- - -If you upgrade from Dokeos 1.8.x :  - - -
- -* Styles and images are located in the main/css or main/img -directories. You can still recover them from your backup if you have made it. - Any modified style or image that uses the default style/image name will be - overwritten by the next step. To avoid loosing your customisations, always - ensure you copy the styles/images under a new name and use and modify the - copy, not the original. The original will always be overwritten by newer - versions. In Dokeos 1.8.5, we have changed the name of several CSS themes. - Backwards compatibility is ensured by the fact that an upgrade only adds the -new themes, but you should try and use these new themes rather than sticking -to the old ones which will be deprecated shortly (not maintained). -
- -

- -

3.2 Upgrading from Dokeos 1.6.x

- - -If you upgrade from a lower version of Dokeos (1.6.x), the first -and most important thing to do is to *move* your current directory to another -place.
-An easy way to do that is to create a subdirectory called "old_version" -in your current Dokeos directory and move everything in there using a -simple "move" command (i.e. under Linux: mkdir old_version; mv * -old_verion/), then make the old_version/ directory writeable by the web -server so that courses/ and upload/ directories can be moved from the -old to the new installation.
-
-The complete process is as follow: - - -
- - NOTE: The upgrade from 1.6.x to 1.8.x implies a revision of -the customised graphics and styles. The new version uses a complete new -set of icons and styles, which means the ones from version 1.6 cannot be -simply reused. The good news is the version 1.8.x allows you to create -your own style in a separate css folder, that you can then reuse through -all the 1.8.x versions -
- -

- -

-WARNING:
- -Do not delete the previous Dokeos installation directory before installing -the new one. When the update is successfully finished, you can remove -the old path. -

- - -

-NOTE:
- -Do not modify the home_*.html files directly. Instead, -choose "Configure the homepage" in the Dokeos administration section. -

- -

-

-

3.3 In both cases

- -The following directories need to be readable, writeable and executable for the web server: - - -On Linux, Mac OS X and BSD operating systems you can quick-fix this using the -CHMOD 777 command, but if you are unsure, we recommend you seek advice for -your own OS on our forum. -In Windows, you may need to check the properties of the folders. -

-

-

3.4 Quick-upgrade from 1.6.x guide for Linux

- - -The following quick-upgrade guide assumes that: - - -
- - -On the command-line, type: - - -
- -Then: - - -

- -

- - -
- -

4. Troubleshooting

- - -

If you have problems, go to the Dokeos website and ask a question on the -support forum. Please read the previous messages first to see if there is -already an answer to your question. We also maintain a list of -Frequently Asked Questions. -

- - -

- - -
-

5. Administration section

- -

To access the Dokeos administration section, open browser, -go to your Dokeos adress and log in with the admin user. -Then you will see a "Platform admin section" link in the header of the -web page. There you can manage users, courses, sessions, portal look -and feel, homepage content, course categories etc. 

- -

-

-
-

6. LDAP

- -

-This part is optional, only organisations with an LDAP server will need to read this.
- -An LDAP module is already provided in Dokeos, but it has to be configured to make it work. -

- - -

Compiling

- -

-Linux servers: It's possible that you have to recompile php with ldap support. -Newer distributions also allow downloading rpms for additional packages. -

- - -

Activating LDAP in Dokeos

- - -

-In (dokeos folder)/main/inc/conf/configuration.php, around line 90, you see
- -//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";
- -
- -remove the // from the last two lines to activate LDAP.
- -

- - -

Settings

- -

-Ask the LDAP server admin for the settings: -

- - -Since 1.8.5, you have to change the LDAP settings inside the "Portal -administration" panel, under "Dokeos configuration settings", section -"LDAP". -
- -As an example, you should find the following kind of values:
- -LDAP main server's address: "myldapserver.com"; // your ldap server
- -LDAP main server's port: 389; // your ldap server's port number
- -LDAP domain: "dc=xx, dc=yy, dc=zz"; //domain
- -
- - -

Teacher/student status

- -

-By default, Dokeos will check if the "employeenumber" field has a value. If it has, then Dokeos will -consider this user as being a teacher.
- -If you want to change this behaviour, you can edit main/auth/ldap/authldap.php, function ldap_put_user_info_locally(), -and change the if (empty($info_array[$tutor_field])) condition to whatever suits you.
- -You can also remove this check by removing the condition and leaving only the $status = STUDENT; line. -

- - -

Protected LDAP servers

- - -

-Some LDAP servers do not support anonymous use of the directory services.
-In this case, you should fill in the appropriate fields in the -administration panel (e.g. "manager" and "mypassword") and Dokeos will -try to authenticate using these, or fall back to anonymous mode before -giving up.

- - -

LDAP import into sessions

- -

There is a new set of scripts now that allow you to insert users -from LDAP directly into a Dokeos session. This, however, relies on a -set of static choices in the LDAP contact attributes.
- -The fields used intensively by the Dokeos module are:
- -

- - - - -
-

7. Mathematical formulas with LaTeX

- -This part is optional, only organisations wanting to use mathematical formulas inside the online editor might want to read this.
- -You can enable mathematical equations writing inside the Dokeos online editor (FCKEditor) by applying the following steps: - - -Adding the corresponding cgi-bin directory to your Apache configuration could be done, in Apache 2, like this: - -
- 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>
- -
- - -Adding a symbolic link can be done, under Windows, by creating a -shortcut to the mimetex.exe file from the cgi-bin directory, or under -Linux by issuing the following command: - -
ln -s /var/www/dokeos/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi
-This procedure should make a new icon available in your Dokeos online -editor, which will make it possible to insert mathematical formulas -into your documents.
- - - -
-
- -Contact address: Dokeos, Rue Victor Hugo, 201, B-1030 Brussels, Belgium
- -Mail: info@dokeos.com
- -Tel. +32 (0)2 669 69 55
-
- -
-
- -
- -
- Valid XHTML 1.0 Transitional - - Valid CSS - + + + + + + + + + + Dokeos 1.8.6 Installation Guide + + + + + + + + + + +
+

Dokeos 1.8.6 FREE : Installation Guide

+ +
+ +Documentation > Installation Guide +
+
+

+ + +

Thank you for downloading Dokeos Svalbard FREE.

+ + + + + +

This guide explains how to install Dokeos FREE. Please read this fully before proceeding with the installation.

Check Dokeos PRO and Dokeos MEDICAL for a complete learning suite with a Service Level Agreement.
+ + +

Contents

+ +
    + +
  1. Pre-requisites
    2. + +
  2. Installation of Dokeos LMS
    3. + +
  3. Upgrade from a previous version of Dokeos
    4. + +
  4. Troubleshooting
    5. + +
  5. Administration section
    6. + +
  6. LDAP 
    7. + +
  7. Mathematical formulas with LaTeX
    8. +
+ + +
+ +
+

1. Pre-requisites

+ + +Dokeos +can be installed on Windows, Linux, Mac OS X and UNIX servers +indifferently. However, we recommend the use of Linux server for +optimal flexibility, remote control and scalability.
+ +
+ +Dokeos is mainly a LMS running Apache, MySQL and PHP5 (the so called AMP trilogy).
+ + +
+ +All these software are open source and freely available.
+ +
+ +To run Dokeos LMS on your server, you need to install WAMP, LAMP or MAMP: + + + +
+ + +

MySQL database server

+ +You will need a login and password allowing to administrate and create +at least one database. By default, Dokeos will create a new database +for each course created. It means your host should allow you to create +and administrate several databases. You can also install Dokeos using +only one database, in that case you have to select this option during +the installation.
+ + +
+

2. Installation of Dokeos LMS

+ + + + + +
+ +The following directories need to be readable, writeable and executable for everyone: + + +(where 'dokeos' is the directory in which you installed Dokeos) +

On Linux, Mac OS X and BSD operating systems you can use the CHMOD +777 command for this (although we recommend you seek advice from an +experienced system administrator). +In Windows, you may need to check the properties of the folders (by +right-clicking on them).

+ +

+2.5. The following files need to be readable and writeable for the web browser, +only during the installation process:

+ + + + +

On Linux, Mac OS X and BSD operating systems you can use the CHMOD +666 command for this (although we recommend you seek advice from an +experienced system administrator). +In Windows, you may need to check the properties of the files and +folders (by right-clicking on them).

+ + + + +

+NOTES:
+ +Do not modify the home_*.html files directly. Instead, +choose "Configure the homepage" in the Dokeos administration section.

+ +

Windows : with combination packages like XAMPP, out of the box, login and password + for MySQL should probably remain empty.

+ +

+ + +

Configuration and security after installation

+ + + +
+ + +

PHP configuration

+ + +To get the best of Dokeos, you need to finetune PHP settings. Consider :
+ + + + + +
+ max_execution_time = 300    ; Maximum execution time of each script, in seconds
+ + max_input_time = 600 ; Maximum amount of time each script may spend parsing request data
+ + memory_limit = 256M      ; Maximum amount of memory a script may consume (128MB)
+ + post_max_size = 64M
+ + upload_max_filesize = 100M
+ + + +

+Some users could meet problems if their PHP settings don't fit +these ones:

+ + + + + +

+Past Dokeos versions required register_globals to be set to On. This is +no longer necessary, this can be set to Off and Dokeos will work fine.

+ + +

BSD users: these php libraries have to be included during php installation:

+ + + + + +


+

+ + +
+

3. Upgrade from a previous version of Dokeos

+Before upgrading we heavily recommend you do a full backup of the previous +Dokeos directories and databases. If you are unsure how to achieve this +please ask your hosting provider for advice.
+ +

+ + +

3.1 Upgrading from Dokeos 1.8.x

+ + +If you upgrade from Dokeos 1.8.x :  + + +
+ +* Styles and images are located in the main/css or main/img +directories. You can still recover them from your backup if you have made it. + Any modified style or image that uses the default style/image name will be + overwritten by the next step. To avoid loosing your customisations, always + ensure you copy the styles/images under a new name and use and modify the + copy, not the original. The original will always be overwritten by newer + versions. In Dokeos 1.8.5, we have changed the name of several CSS themes. + Backwards compatibility is ensured by the fact that an upgrade only adds the +new themes, but you should try and use these new themes rather than sticking +to the old ones which will be deprecated shortly (not maintained). +
+ +

+ +

3.2 Upgrading from Dokeos 1.6.x

+ + +If you upgrade from a lower version of Dokeos (1.6.x), the first +and most important thing to do is to *move* your current directory to another +place.
+An easy way to do that is to create a subdirectory called "old_version" +in your current Dokeos directory and move everything in there using a +simple "move" command (i.e. under Linux: mkdir old_version; mv * +old_verion/), then make the old_version/ directory writeable by the web +server so that courses/ and upload/ directories can be moved from the +old to the new installation.
+
+The complete process is as follow: + + +
+ + NOTE: The upgrade from 1.6.x to 1.8.x implies a revision of +the customised graphics and styles. The new version uses a complete new +set of icons and styles, which means the ones from version 1.6 cannot be +simply reused. The good news is the version 1.8.x allows you to create +your own style in a separate css folder, that you can then reuse through +all the 1.8.x versions +
+ +

+ +

+WARNING:
+ +Do not delete the previous Dokeos installation directory before installing +the new one. When the update is successfully finished, you can remove +the old path.

+ + +

+NOTE:
+ +Do not modify the home_*.html files directly. Instead, +choose "Configure the homepage" in the Dokeos administration section.

+ +

+

3.3 In both cases

+ +The following directories need to be readable, writeable and executable for the web server: + + +On Linux, Mac OS X and BSD operating systems you can quick-fix this using the +CHMOD 777 command, but if you are unsure, we recommend you seek advice for +your own OS on our forum. +In Windows, you may need to check the properties of the folders. +

+

3.4 Quick-upgrade from 1.6.x guide for Linux

+ + +The following quick-upgrade guide assumes that: + + +
+ + +On the command-line, type: + + +
+ +Then: + + +

+ +

+ + +
+ +

4. Troubleshooting

+ + +

If you have problems, go to the Dokeos website and ask a question on the +support forum. Please read the previous messages first to see if there is +already an answer to your question. We also maintain a list of +Frequently Asked Questions.

+ + +

+ + +
+

5. Administration section

+ +

To access the Dokeos administration section, open browser, +go to your Dokeos adress and log in with the admin user. +Then you will see a "Platform admin section" link in the header of the +web page. There you can manage users, courses, sessions, portal look +and feel, homepage content, course categories etc. 

+ +

+
+

6. LDAP

+ +

+This part is optional, only organisations with an LDAP server will need to read this.
+ +An LDAP module is already provided in Dokeos, but it has to be configured to make it work.

+ + +

Compiling

+ +

+Linux servers: It's possible that you have to recompile php with ldap support. +Newer distributions also allow downloading rpms for additional packages.

+ + +

Activating LDAP in Dokeos

+ + +

+In (dokeos folder)/main/inc/conf/configuration.php, around line 90, you see
+ +//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";
+ +
+ +remove the // from the last two lines to activate LDAP.
+

+ + +

Settings

+ +

+Ask the LDAP server admin for the settings:

+ + +Since 1.8.5, you have to change the LDAP settings inside the "Portal +administration" panel, under "Dokeos configuration settings", section +"LDAP". +
+ +As an example, you should find the following kind of values:
+ +LDAP main server's address: "myldapserver.com"; // your ldap server
+ +LDAP main server's port: 389; // your ldap server's port number
+ +LDAP domain: "dc=xx, dc=yy, dc=zz"; //domain
+ +
+ + +

Teacher/student status

+ +

+By default, Dokeos will check if the "employeenumber" field has a value. If it has, then Dokeos will +consider this user as being a teacher.
+ +If you want to change this behaviour, you can edit main/auth/ldap/authldap.php, function ldap_put_user_info_locally(), +and change the if (empty($info_array[$tutor_field])) condition to whatever suits you.
+ +You can also remove this check by removing the condition and leaving only the $status = STUDENT; line.

+ + +

Protected LDAP servers

+ + +

+Some LDAP servers do not support anonymous use of the directory services.
+In this case, you should fill in the appropriate fields in the +administration panel (e.g. "manager" and "mypassword") and Dokeos will +try to authenticate using these, or fall back to anonymous mode before +giving up.

+ + +

LDAP import into sessions

+ +

There is a new set of scripts now that allow you to insert users +from LDAP directly into a Dokeos session. This, however, relies on a +set of static choices in the LDAP contact attributes.
+ +The fields used intensively by the Dokeos module are:
+

+ + + + +
+

7. Mathematical formulas with LaTeX

+ +This part is optional, only organisations wanting to use mathematical formulas inside the online editor might want to read this.
+ +You can enable mathematical equations writing inside the Dokeos online editor (FCKEditor) by applying the following steps: + + +

Adding the corresponding cgi-bin directory to your Apache configuration could be done, in Apache 2, like this: + +

+
+ 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>
+
+ + +

Adding a symbolic link can be done, under Windows, by creating a + shortcut to the mimetex.exe file from the cgi-bin directory, or under + Linux by issuing the following command: + +

+
+

ln -s /var/www/dokeos/main/inc/lib/mimetex/mimetex.cgi /var/www/cgi-bin/mimetex.cgi

+
+

If you don't want modify your Apache, alternately you can make at this point 6: copy mimetex.exe (for windows) or mimetex.cgi (for linux) to your cgi-bin/

+

 

+

This procedure should make a new icon available in your Dokeos online + editor, which will make it possible to insert mathematical formulas + into your documents.
+ + + +
+
+ Contact address: Dokeos, Rue Victor Hugo, 201, B-1030 Brussels, Belgium
+ + Mail: info@dokeos.com
+ + Tel. +32 (0)2 669 69 55
+
+ +

+
+
+ +
+ +
+ Valid XHTML 1.0 Transitional + + Valid CSS + \ No newline at end of file diff --git a/documentation/installation_guide_es_ES.html b/documentation/installation_guide_es_ES.html index 1c856a58e6..893a8fa441 100755 --- a/documentation/installation_guide_es_ES.html +++ b/documentation/installation_guide_es_ES.html @@ -1,763 +1,763 @@ - - - - - - - - - - Guia de Instalación de Dokeos 1.8.6 Svalbard - - - - - - - - - - - - -
-

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.

- - - - - -

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. - -
  2. Instalación de Dokeos LMS
    3. - -
  3. Actualizar desde una versión previa de Dokeos
    4. - -
  4. Solución de Problemas
    5. - -
  5. Sección de administración
    6. - -
  6. LDAP 
    7. - -
  7. Formulas Matemáticas con LaTeX
    8. - -
- - -
- -
-

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

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:
- - - - - -
- -Para aprovechar la ventaja de la Videoconferencia de Dokeos, usted necesita:
- - - - - -
- - -
-

2. Instalación de Dokeos LMS

- - - - - -
- -Los siguientes directorios necesitan tener permisos de lectura, escritura y ejecución para todos: - - -(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: -

- - - - -

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

- - - -
- - -

Configuración PHP

- - -Para obtener lo mejor de Dokeos, usted necesita afinar las configuraciones de PHP. Considerar:
- - - -
- -
- 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:

- - - - - -

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

- - - - - -


- - -

- - -
-

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 :  - - -
- -* 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: - - -
- - 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: - - -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: - - -
- - -Escribir en la linea de comandos: - - -
- -Luego: - - -

- -

- - -
- -

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

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

- - - - -
-

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: - - -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
-
- -
-
- -
- -
- Valid XHTML 1.0 Transitional - - Valid CSS - - - + + + + + + + + + + Guia de Instalación de Dokeos 1.8.6 Svalbard + + + + + + + + + + + + +
+

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.

+ + + + + +

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. + +
  2. Instalación de Dokeos LMS
    3. + +
  3. Actualizar desde una versión previa de Dokeos
    4. + +
  4. Solución de Problemas
    5. + +
  5. Sección de administración
    6. + +
  6. LDAP 
    7. + +
  7. Formulas Matemáticas con LaTeX
    8. + +
+ + +
+ +
+

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: + + + +
+ + +

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:
+ + + + + +
+ +Para aprovechar la ventaja de la Videoconferencia de Dokeos, usted necesita:
+ + + + + +
+ + +
+

2. Instalación de Dokeos LMS

+ + + + + +
+ +Los siguientes directorios necesitan tener permisos de lectura, escritura y ejecución para todos: + + +(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: +

+ + + + +

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

+ + + +
+ + +

Configuración PHP

+ + +Para obtener lo mejor de Dokeos, usted necesita afinar las configuraciones de PHP. Considerar:
+ + + +
+ +
+ 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:

+ + + + + +

+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:

+ + + + + +


+ + +

+ + +
+

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 :  + + +
+ +* 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: + + +
+ + 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: + + +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: + + +
+ + +Escribir en la linea de comandos: + + +
+ +Luego: + + +

+ +

+ + +
+ +

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: +

+ + +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:
+ +

+ + + + +
+

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: + + +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
+

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 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
+
+ +

+
+
+ +
+ +
+ Valid XHTML 1.0 Transitional + + Valid CSS + + +