Dokeos community release 2.0 Installationshandbuch

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. Installation einer neuen Dokeos Version
  3. Upgrade einer vorigen Dokeos Version
  4. M�liche Probleme
  5. Administration
  6. Ldap (optional)

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/claro_main.conf.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