diff --git a/documentation/installation_guide.html b/documentation/installation_guide.html deleted file mode 100644 index cc73c7ba5d..0000000000 --- a/documentation/installation_guide.html +++ /dev/null @@ -1,470 +0,0 @@ - - -Dokeos 1.8 installation guide - - - - -
-

Dokeos 1.8 installation guide

-
-Documentation > English installation guide -
-
-

Thank you for downloading Dokeos! - This text will guide you through the basics of installing Dokeos 1.8. - Please read this fully before proceeding with the installation.

-

The installation guide is also available in other languages, please see this overview page for a list. The Dokeos website will notify when new translations are available.

-

This is only a short installation guide. We are writing a manual with more info on installation, but this was not ready at the time of writing. When ready, this manual will be accessible through the Dokeos documentation page. You can read the work in progress manual on our web writing area. We also maintain a list of Frequently Asked Questions (FAQ).

-

Contents -

    -
  1. Requirements
    2. -
  2. Installing a new version of Dokeos
    3. -
  3. Upgrading from a previous version of Dokeos
    4. -
  4. Troubleshooting
    5. -
  5. Administration section
    6. -
  6. Ldap (optional)
    7. -
-

-

1. Requirements

-

As from Dokeos 1.8 additional plugins can be enabled. Two of these plug-ins needs a set of prerequirements and additional installation of - software modules. The basic requirements have to be met by the core or basic Dokeos modules. Both additional plugins do need a jdk (java development - environment). The additional packages may be installed on an other computer as the DokeosServer.

- -

1.1 Basic Requirements

-

Dokeos is a web application which requires some other software to function:

- -

These software packages have to be installed on the computer where you will install Dokeos.
- You can install all these software packages separately, which often gives the best results. However, beginning users who want to test Dokeos can use a combination package that installs all these software packages in one simple install. If you want to use a combination package, we recommend Wamp (Download at the WAMP5 website, you also need the PHP4 add-on) or XAMP.

-

1.1.1. A web server

-

The Apache web server is recommended, and Dokeos is configured to use some Apache security enhancements if possible. However, other web servers will work too. For best security results, you need to have the Apache module mod_rewrite activated. The mod_rewrite rules for Dokeos are read from a .htaccess file in the courses folder, so Apache needs to allow this (AllowOverride FileInfo in httpd.conf).
-
- Download Apache web server
- Apache web server manual

-

1.1.2. PHP

-

You need PHP version 5.2.x or later (5.x versions), configured with the following modules : mysql, zlib, preg, xml. PHP versions 5 or later are not supported by Dokes yet. - You need the ldap module too if you want to use ldap with Dokeos. - Most of the PHP5 compiled distributions are provided with these modules. - Anyway, their presence is checked by the Dokeos install script.
-
- Download PHP
- PHP manual

-

Some users could meet problems if their PHP setting doesn'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:

- -

1.1.3. The 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.
-
- Download MySQL server
- MySQL server manual

-

Note:
- It seems the backticks characters (`) inserted inside most of - the Dokeos SQL queries since version 1.3 don't work with MySQL - versions before 3.23.6.

-

1.1.4. Permissions

-

Furthermore, Dokeos needs to have write access to specific directories. The best way to deal with these permission is to give the webserver user - read/ write access on the specified directories. The other directories can work with read access. The specific directories are listed in the installation section. - or unzipped to. On a Windows machine locally, this - is not a problem. Remotely, you need to be allowed to CHMOD - through FTP, telnet or any means.

- - -

1.2 Java Requirements

-

Install a java jdk on the system where you will install the conversiontool and the videoconferencing modules. Depending on the system this - environment have to be installed

- Download Java runtime environment and install
- -

1.3 Requirements for Powerpoint and Presenter imports

-

For the basic conversion of a presentation to Dokeos on neede the installation of openoffice.org.
-
- Download openoffice.org and install
-

-

Once the latest version of OpenOffice.org is installed, edit the configuration file (Setup.xcu) and add the following property : - -

<prop oor:name="ooSetupConnectionURL">
-<value>
-socket,host=localhost,port=2002;urp;StarOffice.ServiceManager
-</value>
-</prop>
-
- (ex on Debian /usr/lib/openoffice/share/registry/data/org/openoffice/Setup.xcu) -

-

For the basic convertion of a presentation to Dokeos one need to run the openoffice server in headless mode. On linux systems this is - done via the X framebuffer (xvfb package). When your server does not contain an x-window system, additional fonts and basic x-window libraries have to be installed for - not running into problems.

-

- If during the conversion sets one need additional recording of sound, then the installation of the - Openlaszlo and tomcat modulesare needed. -

-

- The startup from the Openoffice server at startup from the computer van be done via the file oooserver.init. Additional description is found - on the Dokeos wikihttp://www.dokeos.com/wiki/index.php/MakeOOOListening -

-

- Configuration in dokeos platform admin, Configure the services, Configure PowerPoint2LearningPath -

-

-

1.4 Requirements for VideoConferencing

-

The set-up and usage of the videoconferencing and recording functionality in Dokeos is provided by patched external - packages. These patches are at this moment not yet available in the latest stable release of the packages. The following - 4 packages are used. Openlaszlo comes in a packages with the tomcat server 5.0.24. The red5 streaming servers is packaged with the - jetty servlet engine. In order to be able to correctly identify the usercontext from Dokeos into Openlaszlo and Red5 the - connection between the apache webserver and the tomcat servlet engine is needed. -

- Download of the additional packages from the Dokeos site. - -

-

1.4.1 Requirements and installation of OpenLaszlo

-

Depending if the Openlaszlo server is installed on the same server as the webserver of dokeos, different parameters have to be changed

- -

1.4.2 Requirements and installation of Red5 Server

-

Installation and set-up of the Red5 Server

- -

1.4.3 Requirements for the connection of Tomcat with Apache

-

The mod-jk or mod-jk module for apache(2) has to be installed in order to transfer the sessiondata from the Dokeos to the - additional plugins. For the installation of the additional modules see the installation guide of the webserver.

- -

1.4.4 Configuration of DokeosVideoServerving plugin

-

The configuration of the videoServing is done via de admin pages of Dokeos

-

Configuration in dokeos platform admin, Configure the services, Configure VideoConferencingServer

-

This contains the URL to the videoserver the example is for a localversion

- - Bandwidth calculation -

Outgoing Stream:7KB Incoming Stream: 12KB

-

1 one2four VideoConference: 4 outgoing streams from every client: 4*7KB=28KB incoming traffic on server-side -12 incoming streams to every client: 12*12KB=144KB outgoing traffic from server-side

-

1 one2many Conference (up to 50 seats) 1 outgoing streams -> 7KB incoming traffic 50 incoming streams -> -50*12KB = 524KB outgoing traffic

- -

2. Installing a new version of Dokeos

-

2.1. Download the Dokeos 1.8 install package (.zip for Windows users or .tar.gz for all others) from the Dokeos download page.

-

2.2. Unzip or untar the downloaded install package. - Most current operating systems - can do this with a built-in graphical application, if this doesn't work - you can open a commandline, go to the download directory and type - tar -zxvf dokeos-community-1.8.tar.gz

-

2.3. Move by any means (FTP, SCP, local file copy) the contents of the - Dokeos install package to your website on your webserver (whether webroot or subdirectory). Your webserver can also be your local computer. Be sure to copy all the folders (archive, home, claroline, courses) as well as all the .php files.

-

For Windows users who install Dokeos locally: if you use an Apache/PHP/MySQL combination package, just drag and drop the contents of the Dokeos install package into the web directory of the combination package:

- -

2.4. The following directories need to be readable, writeable and executable for the owner of the apache webservice:

- -

On Linux, Mac OS X and BSD operating systems you can use the CHMOD 777 command for this. - 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 everyone:

- -

On Linux, Mac OS X and BSD operating systems you can use the CHMOD 666 command for this. - In Windows, you may need to check the properties of the files and folders (by right-clicking on them).

-

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

-

2.6. Open a web browser and go to - http://www.yourserver.org/yoursite/dokeos/index.php - - If you install Dokeos locally (not on a server) open: - http://localhost/dokeos/index.php

-

2.7. Click on the install button and follow instructions. - - Windows: with combination packages like easyphp, out of the box, login and password - for MySQL should probably remain empty.

-

2.8. Configuration and security after installation

- -
-

3. Upgrading 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.
-

-

If you upgrade from Dokeos 1.8, you can simply copy the new files of 2.0.1 over - the files of the older version. You should not copy over the home, courses or archive folders, otherwise you might lose data. If you accidentally copy over those folders, you can simply replace them with the folders from your backup.
- If you upgrade from a lower version of Dokeos (1.6.x), - you'll have to use the built-in upgrade facility, as described below.

-

3.1. Download the Dokeos 1.8 install package (.zip for Windows users or .tar.gz for all others) from the Dokeos download page.

-

3.2. Unzip or untar the downloaded install package. - Most current operating systems - can do this with a built-in graphical application, if this doesn't work - you can open a commandline, go to the download directory and type - tar -zxvf dokeos-community-1.8.tar.gz

-

3.3. Move the Dokeos directory to a different path from the previous version

-

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.

-

TIP:
- If you want Dokeos 1.8 to be installed in the same directory as - the previous version : -

-

-

3.4. The following files need to be readable and writeable by the web server: -

- On Linux, Mac OS X and BSD operating systems you can use the CHMOD 666 command for this. - In Windows, you may need to check the properties of the folders. -

-

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

-

3.5. The following directories need to be readable, writeable and executable by the web server: -

- On Linux, Mac OS X and BSD operating systems you can use the CHMOD 777 command for this. - In Windows, you may need to check the properties of the folders. -

-

3.6. Open a web browser and go to - http://www.yourserver.org/yoursite/dokeos/index.php
- On Windows, locally, with e.g easyphp or another combination package, open: - http://localhost/dokeos/index.php

-

3.7. Click on the install button, then click on "Upgrade from Dokeos 1.6, 1.6.1, 1.6.2, 1.6.3, 1.6.4, 1.6.5" and follow the instructions.

-

4. Troubleshooting

-

In the future we will also provide instructions on how to do a "manual" install - of Dokeos, by creating the database tables yourself. - - If you have any problems, go to the Dokeos website and ask a question on our 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.

-

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

- You must enter these in - (dokeos folder)/main/auth/ldap/ldap_var.inc.php
- //parameters for LDAP module
- $usesLDAP = TRUE;
- $usesCurriculum = FALSE;
- $ldaphost = "myldapserver.com"; // your ldap server
- $ldapport = 389; // your ldap server's port number
- $ldapDc = "dc=xx, dc=yy, dc=zz"; //domain
-

-

Teacher/student status
- If you wish, you can give teacher/student status to dokeos users according to settings in the ldap server. - This is not a standard field however, so you'll have to change some code. - main/auth/ldap/ldap_var.inc.php - around line 189, function putUserInfoInClaroline ($login, $infoArray)

-

if (your criterium)
- {
- $statut = STUDENT;
- }
- else
- {
- $statut = COURSEMANAGER;
- }
-

-

If this seems too difficult, the simplest solution is to just put - $statut = STUDENT; and give course manager rights through the administration section.

-

Protected LDAP servers
- Some LDAP servers do not support anonymous use of the directory services - In this case, you need code that binds with a name and password - this code has already been provided, - just ask on a forum or email for this.

-

-

7 Debian based linux distribution (ubuntu)

-

The following packages have to be installed

- -
- Contact address: Dokeos, 44 rue des palais, B-1030 Brussels, Belgium
- Mail: info@dokeos.com -
-

-
-
- - diff --git a/documentation/installation_guide_french.html b/documentation/installation_guide_french.html deleted file mode 100644 index 04de99b21f..0000000000 --- a/documentation/installation_guide_french.html +++ /dev/null @@ -1,276 +0,0 @@ - - -Dokeos 1.8 guide d'installation - - - - -
-

Dokeos 1.8 guide d'installation

-
-Documentation > French installation guide -
-
-

Merci d'avoir choisi Dokeos ! - Ce texte vous guidera durant l'installation de Dokeos community release 2.0. - Merci de prendre intégralement connaissance des informations qu'il contient avant de procéder à l'installation.

-

Ce guide ne constitue qu'une aide brève pour l'installation. Nous rédigeons un manuel plus complet concernant l'installation, mais il n'est pas encore disponible au moment où vous lisez ces lignes. Lorsqu'il sera disponible, ce manuel sera accessible via la page de documentation de Dokeos . Vous pouvez aussi consulter la progression du travail de rédaction du manuel d'installation sur le wiki. Une FAQ est aussi disponible en ligne: Frequently Asked Questions.

-

Contenu du guide d'installation -

    -
  1. Eléments requis pour l'installation
    2. -
  2. Installer une nouvelle version de Dokeos (installation fraîche)
    3. -
  3. Mettre à jour une version de Dokeos déjà installée
    4. -
  4. Dysfonctionnements
    5. -
  5. Administration
    6. -
  6. Authentification Ldap (optionnel)
    7. -
-

-

1. Eléments requis pour l'installation

-

Dokeos est une application web qui nécessite d'autres logiciels pour fonctionner:

- -

Ces élements doivent être installés sur votre serveur avant de procéder à l'installation de Dokeos.
- Vous pouvez installer ces éléments séparément, méthode qui donne souvent les meilleurs résultats. Cependant, l'utilisateur débutant qui souhaite tester Dokeos peut utiliser un package qui installe tous ces éléments en une seule fois. Si vous souhaitez utiliser un tel package, nous vous recommandons d'installer Wamp (téléchargeable à l'adresse WAMP5, vous aurez alors besoin de PHP4 add-on) ou XAMP.

-

1.1. Un serveur web

-

Le serveur web Apache est recommandé, et Dokeos est pré-configuré pour utiliser les fonctions de sécurité d'Apache si celà est possible. Cependant, d'autres serveus web feront aussi l'affaire. Pour une meilleure sécurité, vous devez activer le module Apache mod_rewrite. Les règles mod_rewrite pour Dokeos sont inscrites dans un fichier.htaccess dans le dossier de chaque cours, Apache doit permettre cette utilisation (AllowOverride FileInfo dans le fichier httpd.conf).
-
- Télécharger le serveur web Apache
- Consulter le manuel du serveur web Apache

-

1.2. PHP

-

Vous avez besoin de PHP version 5.2.x ou plus récent (versions 5.x ), configuré avec les modules suivants : mysql, zlib, preg, xml. PHP 5 ou plus récent n'est pas encore supporté par Dokeos. - Vous aurez aussi besoin du module ldap si vous souhaitez utiliser une authentification ldap avec Dokeos. - La plupart des distributions compilées de PHP 5 sont fournies avec ces modules. - De toute façon, leur présence est vérifiée par Dokeos au moment de l'installation.
-
- Télécharger PHP
- Consulter le manuel de PHP

-

Vous pourriez rencontrer des problèmes si PHP comprend un paramétrage différent de :

- -

Les versions antérieures de Dokeos nécessitaient register_globals paramétré sur On. Ce n'est plus nécessaire, ce paramètre peut être réglé sur Off, Dokeos fonctionnera correctement.

-

Utilisateus de BSD: ces librairies php doivent être incluses durant l'installation de php:

- -

1.3. Un serveur de bases de données MySQL

-

Vous aurez besoin d'un identifiant et d'un mot de passe autorisant l'administration - et la création d'au moins une base de données. Par défaut, Dokeos créé une nouvelle base de données pour chaque nouveau cours. Cela signifie que votre hébergeur doit vous autoriser à créer et administrer plusieurs bases de données. Vous pouvez aussi procéder à l'installation de Dokeos en utilisant une seule base de données, pour cela, sélectionnez l'option correspondante durant l' - installation.
-
- Télécharger le serveur de base de données MySQL
- Consulter le manuel de MySQL

-

Note:
- Il semble que les caractères (`) contenu dans les requêtes SQL de Dokeos depuis la version 1.3 ne fonctionnent pas avec les versions de MySQL - antérieures à 3.23.6.

-

1.4. Autorisations

-

En outre, vous avez besoin d'un accès en écriture sur le dossier où Dokeos a été uploadé ou décompressé. En utilisation locale, sur une machine équipée de Windows, cela ne constitue pas un problème. A distance, vous devez être autorisé à effectuer des modifications de CHMOD - par FTP, telnet ou tout autre moyen.

-
-

2. Installer une nouvelle version de Dokeos (installation fraîche)

-

2.1. Télecharger le package d'installation de Dokeos community 2.0 (.zip pour les utilisateurs de Windows ou .tar.gz pour les utilisateurs d'autres systèmes d'exploitation) depuis la page de t��hargement de Dokeos.

-

2.2. Décompressez le package d'installation. - La plupart des systèmes d'exploitation effectuent cette opération au travers d'une interface graphique, si cela ne fonctionne pas, vous pouvez utiliser la ligne de commande, accéder au dossier dans lequel vous avez téléchargé le package d'installation et saisir - tar -zxvf dokeos-2.0.tar.gz

-

2.3. Transférer par n'importe quel moyen (FTP, SCP, copie locale des fichiers) le contenu du package d'installation de Dokeos 2.0 vers le site web sur votre serveur (racine ou sous-dossier). Le serveur web peut aussi être votre machine, en local. Assurez-vous de copier tous les fichiers (archive, home, claroline, courses) ainsi que tous les fichiers .php.

-

Pour les utilisateurs de Windows qui effectuent l'installation en local: si vous utilisez un package Apache/PHP/MySQL, vous devez simplement réaliser un glisser/déposer du contenu du package d'installation de Dokeos vers le dossier web du package correspondant:

- -

2.4. Les dossiers suivants doivent être paramétrés en lecture, écriture et exécution pour tous les utilisateurs:

- -

Sur les systèmes d'exploitation Linux, Mac OS X et BSD vous pouvez réaliser un CHMOD 777. - Avec Windows, vous avez besoin de vérifier les propriétés des dossiers (en effectuant un clic droit au dessus du nom).

-

2.5. Les fichiers suivants doivent être paramétrés en lecture et écriture pour tous les utilisateurs:

- -

Sur les systèmes d'exploitation Linux, Mac OS X et BSD vous pouvez réaliser un CHMOD 666. - Avec Windows, vous avez besoin de vérifier les propriétés des dossiers (en effectuant un clic droit au dessus du nom).

-

NOTE:
- Ne modifiez pas les fichiers home_*.html directement. Pour réaliser les modifications sur ces fichiers, choisissez - "Configurer la page d'accueil " dans la section administration de Dokeos.

-

2.6. Ouvrez votre navigateur et saisissez l'adresse - http://www.yourserver.org/yoursite/dokeos/index.php. - - Si vous installez Dokeos localement (pas sur un serveur distant) saisissez l'adresse: - http://localhost/dokeos/index.php

-

2.7. Cliquez sur le bouton "Installer" et suivez les instructions qui s'affichent à l'écran. - - Pour les utilisateurs Windows: avec un package comme easyphp, dont les paramétrages initiaux n'ont pas été modifiés, l'identifiant et le mot de passe pour MySQL doivent rester vides.

-

2.8. Configuration et securité après l'installation

- -
-

3. Mettre à jour une version de Dokeos déjà installée

-

Avant de procéder à la mise à jour, nous vous recommandons très vivement de réaliser une sauvegarde complète de la précédente installation (dossiers et bases de données). Si vous n'êtes pas certain de savoir mener la procédure de sauvegarde, demandez conseil à votre hébergeur pour pouvoir ensuite réaliser cette opération. - - Si vous mettez à jour depuis Dokeos 1.6 ou 1.6.1, vous pouvez simplement copier les nouveaux fichiers de la version 1.6.2 afin d'écraser les fichiers de l'ancienne version. Si vous upgradez depuis une version plus ancienne (1.5.x), - utilisez l'outil de mise à niveau, comme décrit ci-dessous.

-

3.1. Téléchargez le package d'installation Dokeos 1.6.2 (.zip pour les utilisateurs Windows ou.tar.gz pour les autres utilisateurs) depuis la page de téléchargement de Dokeos.

-

3.2. Décompressez le package d'installation. La plupart des systèmes d'exploitation effectuent cette opération au travers d'une interface graphique, si cela ne fonctionne pas, vous pouvez utiliser la ligne de commande, accéder au dossier dans lequel vous avez téléchargé le package d'installation et saisir tar -zxvf dokeos-1.6.2.tar.gz

-

3.3. Déplacez le dossier Dokeos vers une localisation différente de la précédente version

-

Attention:
- Ne supprimez pas le précédent dossier d'installation de Dokeos avant d'installer la nouvelle version. Lorsque le mise à jour sera terminée, vous pourrez supprimer l'ancienne localisation.

-

Astuce:
- Si vous souhaitez que Dokeos 1.6.2 soit installé dans le même dossier que l'installation précédente: -

-

- 3.4. Les fichiers suivants doivent être paramétrés en lecture et écriture pour tous les utilisateurs: - - Sur les systèmes d'exploitation Linux, Mac OS X et BSD vous pouvez réaliser un CHMOD 666. Avec Windows, vous avez besoin de vérifier les propriétés des dossiers (en effectuant un clic droit au dessus du nom). -

NOTE:
- Ne modifiez pas les fichiers home_*.html directement. Pour réaliser les modifications sur ces fichiers, choisissez "Configurer la page d'accueil " dans la section administration de Dokeos.

-

3.5. Les dossiers suivants doivent être paramétrés en lecture, écriture et exécution pour tous les utilisateurs: -

- Sur les systèmes d'exploitation Linux, Mac OS X et BSD vous pouvez réaliser un CHMOD 777. Avec Windows, vous avez besoin de vérifier les propriétés des dossiers (en effectuant un clic droit au dessus du nom). -

-

3.6. Ouvrez votre navigateur et saisissez l'adresse - http://www.yourserver.org/yoursite/dokeos/index.php. - - Si vous installez Dokeos localement (pas sur un serveur distant) saisissez l'adresse: - http://localhost/dokeos/index.php

-

3.7. Cliquez sur le bouton "Installer", puis sur "Update from Dokeos 1.5 | 1.5.4 | 1.5.5" et suivez les instructions qui s'affichent à l'écran.

-

3.8. Cette partie de l'installation est optionnelle !
- Depuis après la version 1.5.5, les tables suivantes appartenant à la base dokeos_main peuvent être supprimées lors de la mise à jour depuis une version 1.5.5 version ou antérieure, à condition que vous ne les utilisiez pas pour une personnalisation de votre installation Dokeos: -

- Ces tables peuvent être supprimées en se connectant à la base de données comme administrateur et en exécutant la requête: - DROP TABLE dokeos_main.my_table; - où dokeos_main est le nom de la base de données principale de Dokeos et où - my_table représente chacune des tables précédentes (répeter la requête pour chacune des tables).
-
- Le nettoyage des champs inutilisés a aussi eu une influence sur le code: - main_db.cours. cours_id a été supprimé, comme toutes les références à ce champ contenues dans le code officiel de Dokeos. Le code du cours (littéral) est utilisé à la place. Mettez à jour les adaptations de votre code si c'est nécessaire.
-
- Comme pour la suppression des tables, les champs suivants peuvent être supprimés à la condition qu'ils ne soient pas utilisés à des fins de personnalisation dans votre code, en utilisant une requête: - ALTER TABLE database.table drop column abc - où database est le nom de la base de données (dokeos_main? or code of a course), - table est le nom de la table (cours?) - abc est le nom du champ à éliminer. - Vous pouvez aussi éliminer les champs suivants: - -

-

4. Dysfonctionnements

-

Dans le futur, nous fournirons aussi les instructions pour réaliser une installation "manuelle" de Dokeos, en créant les tables par vous-même. - - Si vous rencontrez un quelconque problème, consultez le site de Dokeos et posez vos questions sur le forum de support. Prenez d'abord connaissance des messages postés antérieurement pour voir si une réponse à votre question n'est pas déja disponible. Une FAQ est aussi disponible en ligne: Frequently Asked Questions.

-

5. Administration

-

Pour accéder à la section Administration de Dokeos, ouvrez votre navigateur, - saisissez l'adresse de votre site Dokeos et identifiez-vous en tant qu'administrateur. Vous accèderez à la plate-forme d'administration via un lien situé dans l'entête de la page.

-

6. LDAP

-

Cette partie est optionnelle, seules les organisations utilisant un serveur LDAP ont besoin de ces informations.
- Un module LDAP est fourni avec Dokeos, mais il doit être configuré pour pouvoir être exploitable.

-

Compilation
- Serveurs Linux: il est possible que vous ayez à recompiler php avec le support de ldap. - Les distributions récentes autorisent le téléchargement de rpms pour les packages aditionnels.

-

Activer LDAP dans Dokeos
- Dans (dokeos folder)/main/inc/conf/configuration.php, aux environs de la ligne 90, vous pouvez lire:
- //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";
-
- supprimez les // situés devant les deux dernières lignes pour activer LDAP.
-

-

Paramétrages
- Récupérez les informations du serveur LDAP auprès de l'administrateur: -

- Vous devez saisir ces informations dans (dokeos folder)/main/auth/ldap/ldap_var.inc.php
- //parameters for LDAP module
- $usesLDAP = TRUE;
- $usesCurriculum = FALSE;
- $ldaphost = "myldapserver.com"; // your ldap server
- $ldapport = 389; // your ldap server's port number
- $ldapDc = "dc=xx, dc=yy, dc=zz"; //domain
-

-

Statut Enseignant/Etudiant
- Si vous le souhaitez, vous pouvez affecter le statut d'Enseignant ou d'Etudiant aux utilisateurs de Dokeos conformément aux informations disponibles dans le serveur ldap. - Cependant, ce n'est pas automatique, vous devrez modifier le code: - main/auth/ldap/ldap_var.inc.php - aux environs de la ligne 189, fonction putUserInfoInClaroline ($login, $infoArray)

-

if (votre critère )
- {
- $statut = STUDENT;
- }
- else
- {
- $statut = COURSEMANAGER;
- }
-

-

Si cela vous semble trop difficile, une solution plus simple consiste à écrire - $statut = STUDENT; et à donner les droits d'Enseignant via la section Administration de Dokeos.

-

Serveurs LDAP protégés
- Quelques serveurs LDAP ne supportent pas l'utilisation anonyme du dossier services. - Dans ce cas, vous devrez mettre en place un code utilisant identifiant et mot de passe. Ce code est disponible, adressez une demande sur le forum ou par courriel pour l'obtenir.

-

-

- Contact address: Dokeos, 44 rue des palais, B-1030 Brussels, Belgium
- Mail: info@dokeos.com -
-

-
-
- - diff --git a/documentation/installation_guide_german.html b/documentation/installation_guide_german.html deleted file mode 100755 index 2f0b10748e..0000000000 --- a/documentation/installation_guide_german.html +++ /dev/null @@ -1,329 +0,0 @@ - - -Dokeos community release 2.0 Installationshandbuch - - - - -
-

Dokeos 1.8 Installationshandbuch

-
-Documentation > German installation guide -
-
-

Herzlichen Dank fr das Herunterladen von Dokeos! - Dieser Text wird Ihnen die Grundlagen der Installation von Dokeos 2.0 fhren. - Lesen sie die Informationen bitte sorgf�tig durch, bevor Sie mit der Installation beginnen.

-

Dies ist lediglich eine kurze Anleitung fr die Installatin. Wir sind dabei, ein Handbuch mit weiteren - Informationen zu schreiben; dieses ist leider zum jetzigen Zeitpunkt noch nicht fertig. Nach Fertigstellung - wird das Handbuch ber die Dokeos documentation Seite - verfgbar sein. Sie k�nen die Arbeitskopie im jetzigen Stand auf unserem Web WIKI anschauen.

-

Inhalt

-
    -
  1. Voraussetzungen
    2. -
  2. Installation einer neuen Dokeos Version
    3. -
  3. Upgrade einer vorigen Dokeos Version
    4. -
  4. M�liche Probleme
    5. -
  5. Administration
    6. -
  6. Ldap (optional)
    7. -
-

-

1. Voraussetzungen

-

Dokeos ist eine Web Applikation, die einige andere Software ben�igt:

- -

Diese Software Pakete mssen auf dem Computer installiert sein, wo Sie Dokeos installieren wollen.
- Sie k�nen diese Software Pakete separat installieren, was oft zu den besten Ergebnissen fhrt. Allerdings k�nen - Anwender mit weniger Kenntnissen, die Dokeos testen wollen, ein kombiniertes Paket benutzen; wir empfehlen - Wamp (Download von The WAMP5 Website, zus�zlich ben�igt man - das PHP4 add-on) oder XAMP.

-

1.1. Webserver

-

Der Apache Webserver wird empfohlen, und Dokeos ist so konfiguriert, da�einige - der Apache Erweiterungen benutzt werden, falls vorhanden. Andere Webserver sind aber - m�lich. Die besten Ergebnisse fr Sicherheit erreicht man, wenn das Apache Modul mod_rewrite - aktiviert ist. Die mod_reqrite Regeln fr Dokeos werden aus einer .htaccess Datei im Kursverzeichnis - gelesen, daher mu�Apache dies gestatten (AllowOverride FileInfo in httpd.conf).
-
- Download Apache Webserver
- Apache Webserver Handbuch

-

1.2. PHP

-

PHP Version 4.3.2 oder sp�er (4.x Versionen) sind notwendig, und die folgenden Module mssen - konfiguriert sein: mysql, zlib, preg, xml. PHP Version 5 oder sp�er wird bislang von Dokeos noch - nicht untersttzt. - Falls Ldap mit Dokeos benutzt werden soll, mu�auch das ldap Modul eingebunden sein. - Die meisten der kompilierten PHP4 Distributionen enthalten diese Module. - Dokeos prft bei der Installation, ob diese vorhanden sind.
-
- Download PHP
- PHP Handbuch

-

Einige Benutzer k�nten Probleme haben, wenn PHP folgende Einstellungen nicht hat:

- -

�tere Dokeos Versionsn erforderten Past register_globals = on. Dies ist nicht mehr l�ger - erforderlich, auch bei off wird Dokeos korrekt laufen.

-

BSD Benutzer: Die nachfolgenden Bibliotheken mssen w�rend der PHP Installation - eingebunden werden:

- -

1.3. Der MySQL Datenbankserver

-

Sie ben�igen ein Login und Passwort, mit dem Sie den Server administrieren oder zumindest eine Datenbank - anlegen k�nen. Per Default legt Dokeos fr jeden Kurs eine neue Datenbank an; was bedeutet, da�Ihr - Provider Ihnen gestatten sollte, mehrere Datenbanken anzulegen und zu administrieren. Die k�nen Dokeos auch - installieren mit der Option, nur eine Datenbank zu verwenden, diese Option mssen Sie dann w�rend der - Intallation ausw�len.
-
- Download MySQL Server
- MySQL Server Handbuch

-

Bitte beachten:
- Es scheint, als wrden ` Zeichen, die in SQL Abfragen eingefgtsind, nicht - mit �teren MySQL Versionen (�ter als 3.23.6) nicht funktionieren.

-

1.4. Erlaubnisse

-

Weiterhin ben�igt das Serververzeichnis, in das Sie Dokeos entpackt haben "Write" Rechte. Auf einem lokalen - Windows Rechner ist das kein Problem. Auf einem remote Server mssen Sie die Rechte vergeben k�nen durch CHMOD - per FTP, Telnet o.�

-
-

2. Installation einer neuen Dokeos Version

-

2.1. Download des Dokeos 1.6.1 Installationspakets (.zip fr Windows Benutzer oder .tar.gz fr alle anderen) - von der Dokeos download Seite.

-

2.2. Unzip oder untar das heruntergeladene Paket. - Die meisten neueren Betriebssysteme k�nen dies mittels einer integrierten Software, falls das nicht geht, - �fnen Sie die Kommandozeile, gehen zum Download Verzeichnis und geben ein: - tar -zxvf dokeos-1.6.1.beta.tar.gz

-

2.3. Inhalt des Dokeos Installationspakets auf Ihre Website auf dem Webserver hochladen - (z.B. per FTP, SCP, Datei kopieren), entweder in das webroot Verzeichnis oder ein Unterverzeichnis. Der - Webserver kann auch ihr lokaler Computer sein. Vergewissern Sie sich, da�alle Verzeichnisse angelegt - werden (archive, home, claroline, courses) und alle php Dateien kopiert wurden.

-

Fr Windows Benutzer, die Dokeos loakl installieren: Falls Sie ein - Apache/PHP/MySQL Paket benutzen, kopieren Sie den Inhalt des Dokeos Pakets einfach in das Web Verzeichnis - des Kombipakets:

- -

2.4. Die nachfolgenden Verzeichnisse mssen fr alle readable, writeable und executable sein:

- -

Auf Linux, Mac OS X und BSD Betriebssystemen k�nen Sie hierfr den CHMOD 777 Befehl verwenden. - In Windows mssen Sie vielleicht die Verzeichnis Eigenschaften (per rechts Klick) prfen.

-

2.5. Die nachfolgenden Dateien mssen fr alle readable und writeable sein:

- -

Auf Linux, Mac OS X und BSD Betriebssystemen k�nen Sie hierfr den CHMOD 666 Befehl verwenden. - In Windows mssen Sie vielleicht die Verzeichnis Eigenschaften (per rechts Klick) prfen.

-

Bitte beachten:
- Die home_*.html Dateien nicht direkt bearbeiten. Benutzen Sie stattdessen die "Homepage konfigurieren" Option - in der Dokeos Administration.

-

2.6. �fnen sie einen Webbrowser und gehen Sie zu - http://www.ihrserver.org/ihresite/dokeos/index.php - - Falls Sie Dokeos lokal installieren (nicht auf einem remote Server) �fnen Sie: - http://localhost/dokeos/index.php

-

2.7. Klicken Sie auf den "Installieren" Button und folgen Sie den Anweisungen. - - Windows: Mit Kombinationspaketen wie easyphp, wo nichts ver�dert wurde, sollten Login und Passwort - fr MySQL wahrscheinlich leer bleiben.

-

2.8. Konfiguration und Sicherheit nach der Installation

- -
-

3. Upgrade von einer �teren Dokeos Version

-

Vor einem Upgrade empfehlen wir, da�Sie unbedingt ein vollst�diges Backup der vorigen Dokeos Verzeichnisse und - Datenbanken durchfhren. Sollten Sie sich nicht sicher sein, wie man das erreicht, erkundigen Sie sich bei Ihrem - Provider nach Hilfestellung. - - Falls Sie ein Upgrade von Dokeos 1.6 durchfhren, k�nen Sie einfach die neuen Dateien von 1.6.1 ber die Dateien der vorigen Version kopieren. Falls Sie ein Upgrade von einer �teren Version durchfhren (1.5.x), mssen Sie die integrierte Upgrade - Funktion benutzen (Anleitungen weiter unten).

-

3.1. Download des Dokeos 1.6.1 Installationspakets (.zip fr Windows users oderr .tar.gz fr alle anderen) von der Dokeos Download Seite.

-

3.2. Unzip oder untar das heruntergeladene Installationspaket. - Die meisten neueren Betriebssysteme k�nen dies mittels einer integrierten Software, falls das nicht geht, - �fnen Sie die Kommandozeile, gehen zum Download Verzeichnis und geben ein: - tar -zxvf dokeos-1.6.1.beta.tar.gz

-

3.3. Verschieben Sie das Dokeos Verzeichnis in einen neuen Pfad, nicht in das der vorherigen Version.

-

WARNUNG:
- L�chen Sie das Installationsverzeichnis der vorherigen Version nicht vor der Installation der neuen Version! Nachdem das - Update erfolgreich durchgefhrt wurde, k�nen Sie den alten Pfad entfernen.

-

TIPP:
- Falls Sie Dokeos 1.6.1 im gleichen Verzeichnis wie die vorherige Version installieren wollen:

- -

-

3.4. Die nachfolgenden Dateien mssen fr alle readable und writeable sein:

- -

Auf Linux, Mac OS X und BSD Betriebssystemen k�nen Sie hierfr den CHMOD 666 Befehl verwenden. - In Windows mssen Sie vielleicht die Verzeichnis Eigenschaften prfen.

-

Bitte beachten:
- Die home_*.html Dateien nicht direkt bearbeiten. Benutzen Sie stattdessen die "Homepage konfigurieren" Option - in der Dokeos Administration.

-

3.5. Die nachfolgenden Verzeichnisse mssen fr alle readable, writeable und executable sein:

- -

Auf Linux, Mac OS X und BSD Betriebssystemen k�nen Sie hierfr den CHMOD 777 Befehl verwenden. - In Windows mssen Sie vielleicht die Verzeichnis Eigenschaften prfen.

-

3.6. �fnen sie einen Webbrowser und gehen Sie zu - http://www.ihrserver.org/ihresite/dokeos/index.php - - Falls Sie Dokeos lokal installieren (nicht auf einem remote Server) �fnen Sie: - http://localhost/dokeos/index.php

-

3.7. Klicken Sie auf den "Installieren" Button, danach auf "Update from Dokeos 1.5 | 1.5.4 | 1.5.5" - und folgen Sie den Anweisungen.

-

3.8. Dieser Teil ist optional!
- Nach der Version 1.5.5 k�nen nachfolgende Tabellen aus der dokeos_main Datenbank entfernt werden, wenn - man ein Update von 1.5.5 oder �ter durchgfhrt, vorausgesetzt, Sie benutzen diese nicht fr bestimmte - Anpassungen Ihrer Dokeos Installation:

- - Diese Tabellen kann man entfernen, indem man sich als Dokeos User mit der Datenbank verbindet und folgende Abfrage - durchfhrt: - DROP TABLE dokeos_main.my_table; - where dokeos_main is the main dokeos database name and - my_table is each of the preceding tables (fr jede Tabelle wiederholen)
-
- Eine Bereinigung der nicht mehr benutzten Felder hat ebenfalls den Code beeinflu�: - Das Feld main_db.cours.cours_id wurde entfernt, wie auch alle Bezugnahmen auf dieses Feld innerhalb des - offiziellen Dokeos Codes. Der Kurs Code wird stattdessen benutzt. �dern/erg�zen Sie von Ihnen angepa�en - Code dementsprechend, falls dies notwendig ist.
-
- Unter den gleichen Umst�den wie bei der Entfernung von Tabellen k�nen auch die nachfolgenden Felder - entfernt werden, solange sie nicht von Ihrem speziellen Code benutzt werden, indem Sie folgende Abfrage - durchfhren: - ALTER TABLE database.table drop column abc - where database ist der Datenbankname (dokeos_main? oder Code eines Kurses) - table ist der Tabellenname (Kurs?) - abc ist der Name des zu entfernenden Feldes - Sie k�nen auf diese Weise folgende Felder entfernen: - -

-

4. Problembehandlung

-

In Zukunft werden wir auch Anleitungen fr eine Dokeos Installation "per Hand" bereitstellen, wo Sie die Datenbank Tabellen selbst erstellen. - - Bei Problemen gehen Sie zur Dokeos Website und stellen Sie Ihre Fragen in unserem Support Forum. Lesen Sie bitte zuerst frhere Nachrichten, um zu sehen, ob es bereits eine Antwort auf Ihre Frage gibt. Wir fhren auch eine Liste von H�fig gestellte Fragen.

-

5. Administration

-

Um die Dokeos Administration zu benutzen, �fnen Sie den Browser, gehen Sie zu Ihrer Dokeos Adresse und loggen Sie sich als Administrator ein. Dann sehen Sie einen Link fr "Plattform Administration" imKopfbereich der Seite.

-

6. LDAP

-

Dieser Teil ist optional. Nur Organisationen mit einem LDAP Server werden diese Information ben�igen
- Ein LDAP Modul wird in Dokeos bereitgestellt, mu�aber zur Benutzung manuell konfiguriert werden.

-

Kompilieren
- Linux Server: Es k�nte sein, da�Sie PHP mit LDAP Untersttzung neu kompilieren mssen. Neuere Distributionen erlauben auch Download von rpms fr zus�zliche Pakete.

-

LDAP in Dokeos aktivieren
- In (Dokeos Verzeichnis)/main/inc/conf/configuration.php, etwa in Zeile 90, sehen Sie
- //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";
-
- Entfernen Sie die // vor den beiden letzten Zeilen, um LDAP zu aktivieren

-

Einstellungen
- Fragen Sie den Administrator des LDAP server fr die Einstellungen:

- - Diese Werte mssen Sie eingeben in - (Dokeos Verzeichnis)/main/auth/ldap/ldap_var.inc.php
- //parameters for LDAP module
- $usesLDAP = TRUE;
- $usesCurriculum = FALSE;
- $ldaphost = "myldapserver.com"; // your ldap server
- $ldapport = 389; // your ldap server's port number
- $ldapDc = "dc=xx, dc=yy, dc=zz"; //domain
-

-

Kursleiter/Student Status
- Falls gewnscht, k�nen Sie Kursleiter/Student Stauts entsprechend der Einstellungen auf dem LDAP Server - an Dokeos Benutzer vergeben. - Dies ist allerdings kein Standardfeld, Sie mssen dazu den Code ein wenig ver�dern. - main/auth/ldap/ldap_var.inc.php - etwa in Zeile 189, function putUserInfoInClaroline ($login, $infoArray)

-

if (Ihr Kriterium)
- {
- $statut = STUDENT;
- }
- else
- {
- $statut = COURSEMANAGER;
- }
-

-

Falls dies zu schwierig erscheint, ist die einfachste L�ung, zun�hst einfach - $statut = STUDENT anzugeben; und Kursleitern dann ber die Dokeos Administration Rechte zu vergeben.

-

Geschtzte LDAP Server
- Einige LDAP Server untersttzen keine anonymous Benutzung der Verzeichnis Dienste. In diesem Fall ben�igen Sie Code, der mit einem Namen und Passwort bindet - dieser Code wurde schon bereitgestellt, fragen Sie im Forum danach oder schicken Sie uns eine E-Mail.

-

-
- Kontakt Adresse: Dokeos, 44 rue des palais, B-1030 Brussels, Belgien
- E-Mail: info@dokeos.com -
-

-
-
- - diff --git a/documentation/installation_guide_slovenian.html b/documentation/installation_guide_slovenian.html deleted file mode 100644 index e84de4189d..0000000000 --- a/documentation/installation_guide_slovenian.html +++ /dev/null @@ -1,327 +0,0 @@ - - -VodiÄ? po namestitvi Dokeos community release 2.0 - - - - - -
-

VodiÄ? po namestitvi Dokeos 1.8

-
-Documentation > Slovenian installation guide -
-
-

Zahvaljujemo se vam, ker ste si prenesli Dokeos! - - To besedilo vas bo vodilo preko osnovnih korakov namestitve Dokeos 2.0. - - Preberite ga v celoti preden priÄ?nete z namestitvijo.

-

Ta vodiÄ? je dostopen tudi v drugih jezikih, seznam se nahaja na tej strani. Spletna stran Dokeos bo vsebovala obvestilo vsakiÄ?, ko bo dostopen nov prevod.

-

Tole je le kratek vodiÄ? po postopku namestitve. Pripravljamo priroÄ?nik - - s podrobnejÅ¡imi informacijami o namestitvi, ki pa v Ä?asu nastanka tega dokumenta Å¡e ni na voljo. Ko bo, bo priroÄ?nik dostopen na naslovu Dokeos documentation page. Nastajanje priroÄ?nika si lahko ogledate na web writing area. Vzdržujemo tudi seznam pogosto zastavljenih vpraÅ¡anj (FAQ).

-

Vsebina

-
    -
  1. Zahteve
    2. -
  2. Namestitev nove razliÄ?ice Dokeos
    3. -
  3. Nadgradnja predhodne razliÄ?ice Dokeos
    4. -
  4. Odpravljanje težav
    5. -
  5. Administracija
    6. -
  6. Ldap (opcijsko)
    7. -
-

-

1. Zahteve

-

Dokeos je spletna aplikacija, ki za svoje delovanje zahteva nekaj dodatne programske opreme:

- -

Ta programska oprema mora biti nameÅ¡Ä?ena na raÄ?unalniÅ¡kem sistemu preden priÄ?nete z namestitvijo Dokeos.
- Zahtevano programsko opremo lahko namestite po delih (vsako posamezno), kar ponavadi daje boljÅ¡e rezultate. Uporabniki zaÄ?etniki, ki bi želeli preskusiti - - Dokeos, pa lahko uporabijo sestavljen paket programske opreme (bundle) , ki vse potrebno namesti z enim samim namestitvenim postopkom. ÄŒe želite tak sestavljen paket, priporoÄ?amo Wamp (dostopen na WAMP5 spletni strani, pri tem potrebujete tudi PHP4 add-on) ali XAMP.

-

1.1. Spletni strežnik

-

PriporoÄ?amo Apache spletni strežnik. Dokeos vsebuje možnosti izkoriÅ¡Ä?anja - - nakaterih Apache varnostnih mehanizmov. ÄŒe vam ta ne odgovorja, lahko uporabite poljuben drug spletni strežnik. - - Za ustrezno uporabo varnostnih mehanizmov Apache spletnega strežnika, morate namestiti in aktivirati Apache modul mod_rewrite. Pravila mod_rewrite za Dokeos - - so zapisana v .htaccess datoteki mape courses, torej jih morate omogoÄ?iti v nastavitvah strežnika Apache (AllowOverride FileInfo v datoteki httpd.conf).
-
- Prenesi si Apache spletni strežnik
- PriroÄ?nik za uporabo Apache spletnega strežnika

-

1.2. PHP

-

Potrebujete PHP verzije 4.3.2 ali kasnejÅ¡e (4.x verzije), konfiguriranega z - - naslednjimi moduli : mysql, zlib, preg, xml. PHP verzije 5 ali novejÅ¡i - - Å¡e niso podprti s strani Dokes. - - Potrebujete tudi ldap modul , Ä?e želite uporabljati ldap v povezavi z Dokeos. - - VeÄ?ina PHP4 predprevedenih distribucij prihaja z vsemi naÅ¡tetimi moduli. - - Kakorkoli že, njihova prisotnost se preveri v Dokeos namestitvenem postopku.
-
- Prenesi si PHP
- PHP priroÄ?nik

-

Nekateri uporabniki lahko naletijo na težave v primeru, de se nastavitev PHP razlikuje od:

- -

Predhodne razliÄ?ice Dokeos zahtevajo register_globals nastavljen na vrednost On. To ni veÄ? potrebno.

-

BSD uporabniki: naslednje php knjižnjice (moduli) morajo biti vkljuÄ?eni v namestitev php:

- -

1.3. MySQL strežnik podatkovne baze

-

Potrebujete uporabniÅ¡ko ime in geslo, ki dovoljujeta upravljanje in kreiranje vsaj ene podatkovne baze. - - Dokeos vam prednastavljeno kreira novo podatkovno bazo z vsakim kreiranim teÄ?ajem. - - To pomeni, da vam mora strežnik dovoliti kreiranje in upravljanje veÄ?ih podatkovnih baz. - - V postopku namestitve lahko izberete namestitev z eno samo podatkovno bazo, Ä?e vam ponudnik storitve ne omogoÄ?a kreiranje veÄ?ih.
-
- Prenesi si MySQL strežnik
- MySQL uporabniÅ¡ki priroÄ?nik

-

Opomba:
- Vse kaže da znak za poveÅ¡enko /backticks character/ (`), vstavljen v veÄ?ino - - Dokeos SQL povpraÅ¡evanj od razliÄ?ice 1.3 ne deluje z MySQL - - verzijami pred 3.23.6.

-

1.4. Pravice dostopa

-

Nadalje, potrebujete pisalni dostop (Write access) pri dostopu do spletnih map, kjer se nahaja nameÅ¡Ä?en Dokeos. Na Windows platformah z lokalno namestitvijo to ni problem. Pri oddaljenem dostopu pa potrebujete dovoljenje za funkcijo CHMOD vsled uporabe protokolov FTP, telnet ali drugih.

-
-

2. Namestitev nove razliÄ?ice Dokeos

-

2.1. Prenesite si 2.0 namestitveni paket (.zip za Windows uporabnike ali .tar.gz za ostale) s Dokeos spletnega naslova.

-

2.2. Dekomprimirajte (unzip / untar) prenesen namestitveni paket. - - VeÄ?ina novejÅ¡ih operacijskih sistemov - - je to zmožna izvesti z vgrajenimi grafiÄ?nimi aplikacijami, Ä?e pa to ne deluje, - - lahko to izvedete preko ukaznega poziva: v mapi, kamor ste si prenesli namestitveni paket odtipkajte tar -zxvf dokeos-2.0.tar.gz

-

2.3. Prestavite (FTP, SCP, lokalno kopiranje datotek) vsebino Dokeos namestitvenega paketa na želeno spletno stran spletnega strežnika (ali v korensko mapo spletnega strežnika ali njegovo poljubno podmapo). VaÅ¡ spletni strežnik je lahko tudi vaÅ¡ lokalni raÄ?unalnik. Pazite, da boste prestavili vse mape (archive, home, claroline, - - courses) kot tudi vse .php datoteke.

-

Za Windows uporabnike, ki nameÅ¡Ä?ajo Dokeos lokalno: Ä?e uporabljate - - Apache/PHP/MySQL sestavljen paket, uporabite funkcijo povleci in izpusti (drag and drop) na vsebini Dokeos namestitvenega paketa v WWW mapo nameÅ¡Ä?enega sestavljenega paketa:

- -

2.4. Naslednje mape morajo imeti bralne, pisalne in izvršilne pravice za vse in vsakogar:

- -

Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 777 za dodeljevanje pravic. - - Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi).

-

2.5. Naslednje mape morajo imeti bralne in pisalne pravice za vse in vsakogar:

- -

Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 666. - - Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi).

-

OPOMBA:
- Ne spreminjajte vsebine home_*.html datotek direktno. Namesto tega, - - uporabite možnost "Uredi domaÄ?o stran" v Dokeos administracijskem podroÄ?ju.

-

2.6. Odprite okno spletnega brskalnika in pojdite na - - http://www.vasstreznik.org/vasastran/dokeos/index.php - - - - ÄŒe ste Dokeos namestili lokalno, odprite: - - http://localhost/dokeos/index.php

-

2.7. Kliknite na gumb install in sledite navodilom. - - - - Windows: pri uporabi sestavljenega paketa, kot je npr. easyphp, bosta uporabniško ime in geslo - - za MySQL verjetno prazna /ju ni/.

-

2.8. Nastavitve in varnost po postopku namestitve

- -
-

3. Nadgradnja predhodne razliÄ?ice Dokeos

-

Pred nagraditvijo toplo priporoÄ?amo izdelavo popolne rezervne kopije trenutnih Dokeos map, njihove vsebine in podatkovnih baz. ÄŒe niste prepriÄ?ani, kako boste to izvedli, se obrnite po nasvet na gostitelja oz. ponudnika storitve.
-

-

3.1. Prenesite si Dokeos 2.0 namestitveni paket (.zip za Windows uporabnike ali .tar.gz za vse ostale) s spletnega naslova Dokeos download page.

-

3.2. Dekomprimirajte (unzip / untar) prenesen namestitveni paket. - - VeÄ?ina novejÅ¡ih operacijskih sistemov - - je to zmožno izvesti z vgrajenimi grafiÄ?nimi aplikacijami, Ä?e pa to ne deluje, - - lahko to izvedete preko ukaznega poziva: v mapi, kamor ste si prenesli namestitveni paket odtipkajte tar -zxvf dokeos-2.0.tar.gz

-

3.3. Premaknite Dokeos mapo pod koren mape spletnega strežnika, proÄ? od obstojeÄ?e namestitve

-

OPOZORILO:
- Ne briÅ¡ite obstojeÄ?e namestitve Dokeos pred namestitvijo nove. Staro namestitev lahko odstranite Å¡ele po uspeÅ¡nem zakljuÄ?ku nadgraditve.

-

NASVET:
- ÄŒe želite namestiti Dokeos 2.0 v isto mapo, kot je bil nameÅ¡Ä?en pred nadgraditvijo: -

-

-

3.4. Naslednje datoteke morajo biti bralne in pisalne za vsakogar: -

- Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 666. - - Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi). -

-

OPOMBA:
- Ne spreminjajte vsebine home_*.html datotek direktno. Namesto tega - - uporabite možnost "Uredi domaÄ?o stran" v Dokeos administracijski sekciji.

-

3.5. Naslednje mape morajo biti bralne, pisalne in izvršne za vsakogar:

- - Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 777 za doseljevanje pravic. - - Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi). -

-

3.6. Odprite okno spletnega brskalnika in pojdite na - - http://www.yourserver.org/yoursite/dokeos/index.php .
- Windows lokalno, z npr. easyphp ali drugim primerljivim, pojdite na: - - http://localhost/dokeos/index.php

-

3.7. Kliknite gumb install , nato kliknite na "Update from Dokeos 1.5 | 1.5.4 | 1.5.5" in sledite navodilom.

-

4. Odpravljanje težav

-

V prihodnosti imamo namen zagotoviti navodila za "roÄ?no" namestitev Dokeos, vkljuÄ?no z "roÄ?nim" kreiranjem podatkovne baze in vseh potrebnih tabel. - - - - ÄŒe naletite na kakrÅ¡enkoli problem, pojdite na Dokeos spletno stran in zastavite vpraÅ¡anje na naÅ¡em forumu podpore. Preberi prosim najprej predhodna sporoÄ?ila! Lahko, da je bil vaÅ¡ problem že reÅ¡en, vpraÅ¡anje predhodno že zastavljeno. Vzdržujemo tudi seznam pogosto zastavljanih vpraÅ¡anj.

-

5. Administracija

-

Za dostop do Dokeos administracijskega podroÄ?ja, odprite brskalnik, - - pojdite na Dokeos naslov vaÅ¡ega portala in se prijavite kot adminstratorski uporabnik. - - Videli boste "Platform admin section / podroÄ?je Upravitelj teÄ?aja" povezavo v glavi spletne strani portala.

-

6. LDAP

-

Ta del je opcijski, sledeÄ?e besedilo je namenjeno le organizacijam z LDAP strežnikom .
- LDAP modul je integriran v Dokeos distribucijo, potrebno ga je le ustrezno nastaviti, da ga usposobite za delo.

-

Prevajanje
- Linux strežniki: Možno je, da boste morali ponovno prevesti php z ldap podporo. - - Novejše distribucije tudi dovoljujejo selektiven prenos rpm-jev za dodatne podporne pakete.
- Enako velja tudi za BSD uporabnike.

-

Activiranje LDAP v Dokeos
- V (dokeos mapa)/main/inc/conf/configuration.php, okoli vrstice 90, se nahaja naslednje besedilo
- //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";
-
- odstranite // izpred zadnjih dveh vrstic za aktiviranje LDAP.
-

-

Nastavitve
- Pozanimajte se pri upravitelju LDAP strežnika za naslednje nastavitve: -

- Te vrednosti morate vnesti v datoteko - - (dokeos mapa)/main/auth/ldap/ldap_var.inc.php
- //parameters for LDAP module
- $usesLDAP = TRUE;
- $usesCurriculum = FALSE;
- $ldaphost = "myldapserver.com"; // vaš ldap strežnik
- $ldapport = 389; // vaša ldap številka strežniških vrat
- $ldapDc = "dc=xx, dc=yy, dc=zz"; //domena
-

-

UÄ?itelj/teÄ?ajnik status
- ÄŒe želite, lahko uÄ?itelju/teÄ?ajniku dodelite znotraj dokeos status iz vpisov ldap strežnika. - - To ni standarna možnost, torej boste morali rahlo spremeniti programsko kodo: - - main/auth/ldap/ldap_var.inc.php - - okoli vrstice 189, function putUserInfoInClaroline ($login, $infoArray)

-

if (tvoj kriterij)
- {
- $statut = STUDENT;
- }
- else
- {
- $statut = COURSEMANAGER;
- }
-

-

ÄŒe se vam to zdi pretežko, je najenostavnejÅ¡a reÅ¡itev ta, da enostavno doloÄ?ite - - $statut = STUDENT; in dodeljute upravljalcu teÄ?aja pravice preko administracijske sekcije portala.

-

ZaÅ¡Ä?iteni LDAP strežniki
- Nekateri LDAP strežniki ne podpirajo anonimne uporabe direktorijskih storitev - - V tem primeru, potrebujete dodatno programsko kodo, ki bo povezovala LDAP z uporabniškim imenom in geslom - koda je zagotovljena, - - le vprašajte na forumu ali jo zahtevajte preko e-pošte.

-

-

- Kontaktni naslov: Dokeos, 44 rue des palais, B-1030 Brussels, Belgium
- E-pošta: info@dokeos.com -
-

-
-
- -