# Dokeos 1.6.1 Installationshandbuch

Herzlichen Dank für das Herunterladen von Dokeos! Dieser Text wird Ihnen die Grundlagen der Installation von Dokeos 1.6.1 führen. Lesen sie die Informationen bitte sorgfältig durch, bevor Sie mit der Installation beginnen.

Dies ist lediglich eine kurze Anleitung für 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 verfügbar sein. Sie können 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ögliche Probleme
5. Administration
6. Ldap (optional)

## 1. Voraussetzungen

Dokeos ist eine Web Applikation, die einige andere Software benötigt:

- Webserver - wir empfehlen Apache
- PHP
- MySQL Datenbankserver

Diese Software Pakete müssen auf dem Computer installiert sein, wo Sie Dokeos installieren wollen.
Sie können diese Software Pakete separat installieren, was oft zu den besten Ergebnissen führt. Allerdings können Anwender mit weniger Kenntnissen, die Dokeos testen wollen, ein kombiniertes Paket benutzen; wir empfehlen Wamp (Download von The WAMP5 Website, zusätzlich benötigt 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öglich. Die besten Ergebnisse für Sicherheit erreicht man, wenn das Apache Modul mod_rewrite aktiviert ist. Die mod_reqrite Regeln für 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äter (4.x Versionen) sind notwendig, und die folgenden Module müssen konfiguriert sein: mysql, zlib, preg, xml. PHP Version 5 oder später wird bislang von Dokeos noch nicht unterstützt. Falls Ldap mit Dokeos benutzt werden soll, muß auch das ldap Modul eingebunden sein. Die meisten der kompilierten PHP4 Distributionen enthalten diese Module. Dokeos prüft bei der Installation, ob diese vorhanden sind.
Download PHP
PHP Handbuch

Einige Benutzer könnten Probleme haben, wenn PHP folgende Einstellungen nicht hat:

- short_open_tag = On
- safe_mode = Off
- magic_quotes_gpc = On
- magic_quotes_runtime = Off

Ältere Dokeos Versionsn erforderten Past register_globals = on. Dies ist nicht mehr länger erforderlich, auch bei off wird Dokeos korrekt laufen.

BSD Benutzer: Die nachfolgenden Bibliotheken müssen während der PHP Installation eingebunden werden:

- php-mysql Die mySQL Erweiterung für PHP
- php-pcre Die pcre Erweiterung für PHP
- php-session Die session Erweiterung für PHP
- php-zlib Die zlib Erweiterung für PHP
- (optional) php-ldap falls die LDAP Authentifizierung benutzt werden soll

### 1.3. Der MySQL Datenbankserver

Sie benötigen ein Login und Passwort, mit dem Sie den Server administrieren oder zumindest eine Datenbank anlegen können. Per Default legt Dokeos für jeden Kurs eine neue Datenbank an; was bedeutet, daß Ihr Provider Ihnen gestatten sollte, mehrere Datenbanken anzulegen und zu administrieren. Die können Dokeos auch installieren mit der Option, nur eine Datenbank zu verwenden, diese Option müssen Sie dann während der Intallation auswählen.
Download MySQL Server
MySQL Server Handbuch

Bitte beachten:
Es scheint, als würden ` Zeichen, die in SQL Abfragen eingefügtsind, nicht mit älteren MySQL Versionen (älter als 3.23.6) nicht funktionieren.

### 1.4. Erlaubnisse

Weiterhin benötigt das Serververzeichnis, in das Sie Dokeos entpackt haben "Write" Rechte. Auf einem lokalen Windows Rechner ist das kein Problem. Auf einem remote Server müssen Sie die Rechte vergeben können durch CHMOD per FTP, Telnet o.ä.

## 2. Installation einer neuen Dokeos Version

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

2.2. Unzip oder untar das heruntergeladene Paket. Die meisten neueren Betriebssysteme können dies mittels einer integrierten Software, falls das nicht geht, öffnen 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.

Für 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:

- EasyPHP - C:\Program Files\easyphp\www\
- WAMP - C:\Program Files\wamp\www\
- XAMP - C:\Program Files\xamp\www\

2.4. Die nachfolgenden Verzeichnisse müssen für alle readable, writeable und executable sein:

- dokeos/claroline/inc/conf/
- dokeos/claroline/garbage/
- dokeos/claroline/upload/
- dokeos/archive/
- dokeos/courses/
- dokeos/home/

Auf Linux, Mac OS X und BSD Betriebssystemen können Sie hierfür den CHMOD 777 Befehl verwenden. In Windows müssen Sie vielleicht die Verzeichnis Eigenschaften (per rechts Klick) prüfen.

2.5. Die nachfolgenden Dateien müssen für alle readable und writeable sein:

- dokeos/claroline/inc/conf/claro_main.conf.php (wenn vorhanden)
- dokeos/home/*.html

Auf Linux, Mac OS X und BSD Betriebssystemen können Sie hierfür den CHMOD 666 Befehl verwenden. In Windows müssen Sie vielleicht die Verzeichnis Eigenschaften (per rechts Klick) prüfen.

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

2.6. Öffnen 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) öffnen 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ändert wurde, sollten Login und Passwort für MySQL wahrscheinlich leer bleiben.

2.8. Konfiguration und Sicherheit nach der Installation

- Schützen Sie ihre Konfigurationsdatei: Vergewissern Sie sich, daß niemand die Datei überschreiben kann. Die Konfigurationsdatei befindet sich hier: (Dokeos Verzeichnis)/claroline/inc/conf/claro_main.conf.php. Die Datei sollte nur lesbar sein (Windows/XWindows: rechts Klick auf die Datei und die Eigenschaften anpassen. linux/bsd/macosx: den chmod 444 Befehl benutzen). Die Konfigurationsdatei wird von Apache erstellt, daher müssen Sie eventuell ein "root" Benutzer sein, um die Erlaubnisse zu verändern.
- Installationsverzeichnis schützen: falls das (Dokeos Verzeichnis)/claroline/install Verzeichnis weiterhin erreichbar ist, könnte jemand über Ihre vorhandene Installation neu installieren (Sie könnten Daten verlieren). Verschieben Sie das Verzeichnis ausserhalb der Webverzeichnisse, wo es nicht mehr für einen Browser erreichbar ist, ändern Sie den Verzeichnisnamen, oder bearbeiten Sie die Eigenschaften, damit niemand das Verzeichnis lesen oder Dateien darin ausführen kann.
- Verbesserte Sicherheit: Die Dateien für alle lesbar machen, erleichtert die Installation und hilft bei Problemen für die, welche keine Adminsitrator Erfahrung haben. Es ist aber sicherer, den Eigentümer des Apache Prozesses (oft als apache oder www-data bezeichnet) auch zum Eigentümer aller Dokeos Verzeichnisse und Dateien zu machen. So brauchen diese Dateien lediglich für den Apache Prozess readable und writeable zu sein, nicht aber für alle.
- Ihre Dokeos Installation konfigurieren: In der Administration von Dokeos, können Sie die Dokeos Konfiguration benutzen, um das Verhalten Ihrer Dokeos Installation anzupassen.
- Dokeos Mail konfigurieren: Dokeos benutzt zumeist die Mail Einstellungen aus der php.ini Datei. Das Modul "Ankündigungen" benutzt phpMailer (ein anderes freies Software Projekt) und die Einstellungen für dieses Werkzeug können angepaßt werden in der (Dokeos Verzeichnis)/claroline/inc/conf/mail.conf.php Datei.

## 3. Upgrade von einer älteren Dokeos Version

Vor einem Upgrade empfehlen wir, daß Sie unbedingt ein vollständiges Backup der vorigen Dokeos Verzeichnisse und Datenbanken durchführen. 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 durchführen, können Sie einfach die neuen Dateien von 1.6.1 über die Dateien der vorigen Version kopieren. Falls Sie ein Upgrade von einer älteren Version durchführen (1.5.x), müssen Sie die integrierte Upgrade Funktion benutzen (Anleitungen weiter unten).

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

3.2. Unzip oder untar das heruntergeladene Installationspaket. Die meisten neueren Betriebssysteme können dies mittels einer integrierten Software, falls das nicht geht, öffnen 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öschen Sie das Installationsverzeichnis der vorherigen Version nicht vor der Installation der neuen Version! Nachdem das Update erfolgreich durchgeführt wurde, können Sie den alten Pfad entfernen.

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

- verschieben Sie das alte Verzeichnis an einen neuen Ort (z.B. verschieben Sie dokeos/ nach dokeos_old/)
- entpacken Sie Dokeos 1.6.1 in das Verzeichnis der alten Version (z.B. entpacken Sie Dokeos 1.6.1 nach dokeos/)
- gehen Sie zum nächsten Schritt

3.4. Die nachfolgenden Dateien müssen für alle readable und writeable sein:

- dokeos/claroline/inc/conf/claro_main.conf.php (falls vorhanden)
- dokeos/home/*.html

Auf Linux, Mac OS X und BSD Betriebssystemen können Sie hierfür den CHMOD 666 Befehl verwenden. In Windows müssen Sie vielleicht die Verzeichnis Eigenschaften prüfen.

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 müssen für alle readable, writeable und executable sein:

- dokeos/claroline/inc/conf/
- dokeos/claroline/garbage/
- dokeos/claroline/upload/
- dokeos/archive/
- dokeos/courses/
- dokeos/home/

Auf Linux, Mac OS X und BSD Betriebssystemen können Sie hierfür den CHMOD 777 Befehl verwenden. In Windows müssen Sie vielleicht die Verzeichnis Eigenschaften prüfen.

3.6. Öffnen 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) öffnen 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önnen nachfolgende Tabellen aus der dokeos_main Datenbank entfernt werden, wenn man ein Update von 1.5.5 oder älter durchgführt, vorausgesetzt, Sie benutzen diese nicht für bestimmte Anpassungen Ihrer Dokeos Installation:

- `todo`
- `pma_bookmark`
- `pma_column_comments`
- `pma_pdf_pages`
- `pma_relation`
- `pma_table_coords`
- `pma_table_info`

Diese Tabellen kann man entfernen, indem man sich als Dokeos User mit der Datenbank verbindet und folgende Abfrage durchführt: DROP TABLE dokeos_main.my_table; where dokeos_main is the main dokeos database name and my_table is each of the preceding tables (für jede Tabelle wiederholen)
Eine Bereinigung der nicht mehr benutzten Felder hat ebenfalls den Code beeinflußt: 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. Ändern/ergänzen Sie von Ihnen angepaßten Code dementsprechend, falls dies notwendig ist.
Unter den gleichen Umständen wie bei der Entfernung von Tabellen können auch die nachfolgenden Felder entfernt werden, solange sie nicht von Ihrem speziellen Code benutzt werden, indem Sie folgende Abfrage durchführen: 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önnen auf diese Weise folgende Felder entfernen:

- `_dokeos_main_`.`cours`.`versionDb`
- `_dokeos_main_`.`cours`.`versionClaro`
- `_dokeos_main_`.`cours`.`cahier_charges`
- `_dokeos_main_`.`faculte`.`bc`
  # die Tabelle `faculte` wurde seit 1.6 umbenannt in `course_category`
- `_cours_`.`announcement`.`code_cours`
- `_cours_`.`course_description`.`upDate`

## 4. Problembehandlung

In Zukunft werden wir auch Anleitungen für 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 frühere Nachrichten, um zu sehen, ob es bereits eine Antwort auf Ihre Frage gibt. Wir führen auch eine Liste von Häufig gestellte Fragen.

## 5. Administration

Um die Dokeos Administration zu benutzen, öffnen Sie den Browser, gehen Sie zu Ihrer Dokeos Adresse und loggen Sie sich als Administrator ein. Dann sehen Sie einen Link für "Plattform Administration" imKopfbereich der Seite.

## 6. LDAP

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

Kompilieren
Linux Server: Es könnte sein, daß Sie PHP mit LDAP Unterstützung neu kompilieren müssen. Neuere Distributionen erlauben auch Download von rpms für zusätzliche Pakete.

LDAP in Dokeos aktivieren
In (Dokeos Verzeichnis)/claroline/inc/conf/claro_main.conf.php, etwa in Zeile 90, sehen Sie
//for new login module
//uncomment these to activate ldap
//$extAuthSource['ldap']['login'] = "./claroline/auth/ldap/login.php";
//$extAuthSource['ldap']['newUser'] = "./claroline/auth/ldap/newUser.php";
Entfernen Sie die // vor den beiden letzten Zeilen, um LDAP zu aktivieren

Einstellungen
Fragen Sie den Administrator des LDAP server für die Einstellungen:

- ldap Server Name
- ldap Server Port (gewöhnlich 389)
- ldap dc

Diese Werte müssen Sie eingeben in (Dokeos Verzeichnis)/claroline/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 gewünscht, können Sie Kursleiter/Student Stauts entsprechend der Einstellungen auf dem LDAP Server an Dokeos Benutzer vergeben. Dies ist allerdings kein Standardfeld, Sie müssen dazu den Code ein wenig verändern. claroline/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ösung, zunächst einfach $statut = STUDENT anzugeben; und Kursleitern dann über die Dokeos Administration Rechte zu vergeben.

Geschützte LDAP Server
Einige LDAP Server unterstützen keine anonymous Benutzung der Verzeichnis Dienste. In diesem Fall benötigen 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