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

- Webserver - wir empfehlen Apache
- PHP
- MySQL Datenbankserver

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:

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

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

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

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

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

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

- dokeos/main/inc/conf/
- dokeos/main/garbage/
- dokeos/main/upload/
- dokeos/main/img/default_courses_img/
- dokeos/archive/
- dokeos/courses/
- dokeos/home/

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:

- dokeos/main/inc/conf/configuration.php (wenn vorhanden)
- dokeos/home/*.html

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

- Schtzen Sie ihre Konfigurationsdatei: Vergewissern Sie sich, da�niemand die Datei berschreiben kann. Die Konfigurationsdatei befindet sich hier: (Dokeos Verzeichnis)/main/inc/conf/configuration.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 mssen Sie eventuell ein "root" Benutzer sein, um die Erlaubnisse zu ver�dern.
- Installationsverzeichnis schtzen: falls das (Dokeos Verzeichnis)/main/install Verzeichnis weiterhin erreichbar ist, k�nte jemand ber Ihre vorhandene Installation neu installieren (Sie k�nten Daten verlieren). Verschieben Sie das Verzeichnis ausserhalb der Webverzeichnisse, wo es nicht mehr fr einen Browser erreichbar ist, �dern Sie den Verzeichnisnamen, oder bearbeiten Sie die Eigenschaften, damit niemand das Verzeichnis lesen oder Dateien darin ausfhren kann.
- Verbesserte Sicherheit: Die Dateien fr alle lesbar machen, erleichtert die Installation und hilft bei Problemen fr die, welche keine Adminsitrator Erfahrung haben. Es ist aber sicherer, den Eigentmer des Apache Prozesses (oft als apache oder www-data bezeichnet) auch zum Eigentmer aller Dokeos Verzeichnisse und Dateien zu machen. So brauchen diese Dateien lediglich fr den Apache Prozess readable und writeable zu sein, nicht aber fr alle.
- Ihre Dokeos Installation konfigurieren: In der Administration von Dokeos, k�nen 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 "Ankndigungen" benutzt phpMailer (ein anderes freies Software Projekt) und die Einstellungen fr dieses Werkzeug k�nen angepa� werden in der (Dokeos Verzeichnis)/main/inc/conf/mail.conf.php Datei.

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

- 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�hsten Schritt

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

- dokeos/main/inc/conf/configuration.php (falls vorhanden)
- dokeos/home/*.html

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:

- dokeos/main/inc/conf/
- dokeos/main/garbage/
- dokeos/main/upload/
- dokeos/main/img/default_courses_img/
- dokeos/archive/
- dokeos/courses/
- dokeos/home/

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:

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

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

- ldap Server Name
- ldap Server Port (gew�nlich 389)
- ldap dc

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