Moodle/Installation

Systemanforderungen

Voraussetzung für die Installation

• PHP
• Datenbanksystem
  • MySQL, PostgreSQL, Oracle, MS SQL oder andere relationale Datenbanken

Moodle wurde in Linux entwickelt und nutzt PHP, Apache und MySQL (auch als LAMP-Plattform bezeichnet). Es wurde getestet mit PostgreSQL und unter Windows XP und Mac OS X und Netware 6 Umgebungen.

Web Server Software. Am häufigsten wird Apache, genutzt. Moodle sollte aber auch unter jedem anderen Web Server laufen, der PHP unterstützt, wie IIS auf Windows Plattformen.

1. PHP Skript-Sprache (Version 4.1.0 oder jünger). PHP 5 wird ab der Version 1.4. von moodle unterstützt.
2. einen funktionierenden Datenbankserver: MySQL oder PostgreSQL werden von moodle vollständig unterstützt.

Diese Voraussetzungen werden von den meisten Anbietern Webspace ohne Probleme erfüllt. Sollten Sie jedoch mit einem Hosting-Anbieter zusammen arbeiten, der diese Optionen nicht anbietet, fragen Sie warum und wechseln Sie ggfs. den Anbieter.

Wenn Sie moodle auf Ihrem eigenen Rechner betreiben wollen und Sie mit diesen Begriffen noch wenig anfangen können, dann finden Sie alle Informationen in unserem Leitfaden: Installation von Apache, MySQL und PHP. Er enthält Schritt-für-Schritt Anleitungen zur Installation auf den gängigsten Plattformen.

Downloaden, entpacken und an die richtige Stelle kopieren

Moodle liegt als komprimiertes Paket oder über CVS für Sie bereit. Detailerklärungen finden Sie auf der Downloadseite http://moodle.org/

Nach dem Download packen Sie das Archiv oder die CVS Dateien aus. Im neuen Verzeichnis quot;moodle" finden Sie eine Reihe von Dateien und Ordnern.

Sie können den gesamten Ordner in ein Dokumentenverzeichnis Ihres Webservers kopieren, dann finden Sie Moodle unter folgender Adresse http://yourwebserver.com/moodle, oder Sie kopieren alles direkt in das Hauptverzeichnis. Moodle finden Sie dann unter http://yourwebserver.com.

Wenn Sie moodle auf Ihren lokalen PC herunterladen und dann auf den Webserver hochladen, ist es am einfachsten, wenn Sie moodle als eine gepackte Datei herunterladen, auf den Server kopieren und dort entpacken. Ein web hosting interfaces wie Cpanel erlaubt Ihnen Archivpakete mit dem Dateimanager auf dem Server zu entpacken.

# wget https://download.moodle.org/download.php/direct/stable402/moodle-latest-402.tgz
# tar -xf moodle-latest-402.tgz
#  chown -Rc web76:client1 moodle

Verzeichnisstruktur

config.php - enthält Grundeinstellungen für moodle. Diese Datei erstellen Sie selbst aus der Datei config-dist.php oder mit der automatischen Installationsroutine

• install.php - erstellt automatisch die Datei config.php

• version.php - beschreibt die gerade installierte Version von Moodle

• index.php - die Startseite

• admin/ - verwaltet die gesamte Anwendung
• auth/ - Plugin Module um Anwender zu identifizieren
• blocks/ - Plugin-Module für Blöcke uafden Kursseiten
• calender/ - Kalender
• course/ - Anzeige und Verwaltung der Kurse
• doc/ - Hilfedateien für Moodle (z.B. diese Seite)
• files/ - Anzeige und Verwaltung hochgeladener Dateien
• lang/ - Texte in verschiedenen Sprachen
• lib/ - Bibliotheken des Kerns von Moodle
• login/ - Steuerung des Login und der Anmeldungen
• mod/ - alle Moodle Kursmodule
• pix/ - Grafische Gestaltung der Seiten
• theme/ - Vorlagen für die visuelle Gestaltung der Seiten (Themes/Skins).
• user/ - Anzeige und Verwaltung von Benutzern

Installationsskript zur Erstellung der config.php-Datei

Rufen Sie das Installationsskript (install.php) direkt auf, mit dem Webbrowser http://yourserver.de/install.php.

(Die Installationsroutine versucht einen cookie zu setzen. Wenn sch ein popup-Fenster öffnet müssen Sie den Cookie bestätigen!)

Moodle erkennt, dass eine Konfiguration erforderlich ist und führt Sie über mehrere Schritte durch die Erstellung der Konfigurationsdatei config.php. Am Ende versucht moodle die Datei an der richtigen Stelle abzuspeichern. Sollte dies nicht erfolgen, könenn sie die Datei config.php abspeichern und manuell in das Hauptverzeichnis von moodle auf dem Server kopieren.

Die Installationsroutine überprüft die Servereinstellungen und gibt bei Bedarf Empfehlungen zur Behebung von Problmen. Zumeist sollte es reibungslos ablaufen. Im folgenden finden Sie einige Informationen, falls der Ablauf stockt.

Web-Server Einstellungen

Stellen Sie zunächst sicher, dass Ihr Webserver automatisch die Index.php Datei aufruft (evtl ergänzend zur index.html, default.htm etc).

In Apache erfolgt diese Einstellung in der httpd.conf Datei. Darin sollte z.B. folgender Text stehen:

DirectoryIndex index.php index.html index.htm 

index.php muss in dieser Übersicht aufgeführt sein. Am besten steht es sogar ganz am Anfang der Liste.

Zweitens, Wenn Sie Apache 2 verwenden, dann sollte die Variable AcceptPathInfo on gestellt sein. Sie läsdt Argumente wie http://server/file.php/arg1/arg2 zu. Es ist wichtig relative Links zwischen Ressourcen zuzulassen und die Leistungssteigerung zu ermöglich. Sie können dies durch das Einfügen der der folgenden Zeile in die Datei httpd.conf file zulassen.

AcceptPathInfo on 

Drittens: erfordert Moodle einige PHP-Einstellungen, damit es arbeiten kann. Zumeist sind diese bereits als Grundeinstellungen vorhanden. Einige PHP-Server (besonders solche mit älteren Versionen) müssen entsprechend eingestellt werden. Sie finden die Einstellungen in der PHP-Konfigurationsdatei (php.ini):

magic_quotes_gpc = 1  (erwünscht, nicht erforderlich)
magic_quotes_runtime = 0  (erforderlich) 
file_uploads = 1
session.auto_start = 0
session.bug_compat_warn = 0

Wenn Sie keinen Zugriff auf die Dateien httpd.conf oder php.ini auf Ihrem Server haben, oder wenn andere Anwendungen andere Einstellungen erfordern, dann können sie die Einschreibungen überschreiben.

Erstellen Sie eine Datei mit Namen .htaccess im Hauptverzeichnis von Moodle mit der Definition der folgenden Einstellungen. Dies ist jedoch nur bei Apache Servern möglich und auch nur dann wenn das Überschreiben zulässig ist.

DirectoryIndex index.php index.html index.htm
<IfDefine APACHE2>
    AcceptPathInfo on
</IfDefine>

php_flag magic_quotes_gpc 1
php_flag magic_quotes_runtime 0
php_flag file_uploads 1
php_flag session.auto_start 0
php_flag session.bug_compat_warn 0

Sie können nun auch die maximale Dateigröße festlegen, die hochgeladen werden darf:

LimitRequestBody 0
php_value upload_max_filesize 2M
php_value post_max_size 2M

Am einfachsten kopieren Sie die Beispieldatei aus lib/htaccess und bearbeiten Sie nach Ihren Vorstellungen. Sie finden dort weitere Informationen. Rufen Sie in der Unix Shell folgenden Befehl auf:

cp lib/htaccess .htaccess

Eine Datenbank erstellen

Erstellen Sie nun eine leere Datenbank (z.B. "moodle") in Ihrem Datenbanksystem mit dem Nutzer (z.B. "moodleuser") der auf diese Datenbank zugreifen kann. Richten Sie in jedem Falle ein Passwort ein, wenn Sie einen Online-Server nutzen, damit niemand anderer auf Ihre Datenbank zugreifen kann.

Wenn Sie einen gehosteten Server verwenden, haben Sie evtl eine Oberfläche zur Einrichtung einer neuen Datenbank.

Klick auf das "MySQL Databases" Icon.

1. Eingabe von "moodle" in das Datenbankfeld und Klick auf "Datenbank hinzufügen".
2. Nutzernamen und sicheres Passwort eingeben, das Sienicht noch an anderer Stelle verwenden, und Klick auf "Nutzer hinzufügen".
3. Verwenden Sie jetzt den "Nutzer zur Dtaenbank hinzufügen" Button, damit der neue Nutzer Datenbankzugriff erhält "ALLE" Rechte für die neue Datenbank.
4. Der Nutzername und der Datenbankname kann durch den Cpanel Account bereits vordefiniert sien. Wenn Sie diese Daten bei der moodle Installation angebern - verwenden Sie bitte den vollständigen Eintrag.

Aufruf für MySQL unter Unix(Beispiel):

  # mysql -u root -p
  > CREATE DATABASE moodle;
  > GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.*
          TO moodleuser@localhost IDENTIFIED BY 'yourpassword';
  > quit
  # mysqladmin -p reload

Aufruf für PostgreSQL (Beispiel):

  # su - postgres
  > psql -c "create user moodleuser createdb;" template1
  > psql -c "create database moodle;" -U moodleuser template1
  > psql -c "alter user moodleuser nocreatedb;" template1

(Für MySQL empfehle ich den Gebrauch von phpMyAdmin zur Bearbeitung der Datenbank).

Ab der Version 1.0.8 unterstützt Moodle Vorzeichen für die Datenbanktabellen. Dadurch können Sie die gleiche Datenbank mit mehreren Moodle-Installationen oder anderen Webanwendungen nutzen.

Ein Datenverzeichnis erstellen

Moodle braucht nun etwas Speicherplatz für hochgeladene Dateien wie Kursdokumente und Nutzerbilder.

Das Installationsskript versucht ein solches Verzeichnis zu erstellen. Falls dies nicht gelingt, legen Sie ein solches Verzeichnis selber an. Erstellen Sie an einer beliebigen Stelle auf Ihrem Server für diesen Zweck ein Verzeichnis. Aus Sicherheitsgründen sollte dierses Verzeichnis NICHT für jedermann direkt übers Web zugreifbar sein. Am besten richten Sie es ausserhalb des Programmverzeichnisses ein, oder Sie schützen es mit Hilfe einer .htaccess-Datei mit folgendem Inhalt:

deny from all

Prüfen Sie ob Moodle in diesem Vezeichnis Dateien ablegen darf, indem Sie überprüfen, ob die WebServer Software (z.B. Apache) für dieses Verzeichnis Schreiberlaubnis hat. Auf Unix-Rechnern lautet die Einstellung für das Verzeichnis "nobody" oder "apache". Geben Sie den Nutzern die Rechte zum Schrreiben, Lesen und Ausführen.

Auf Cpanel Systemen können Sie den "Dateimanager" verwenden, um den Ordner zu finden und die "Zugriffsrechte anzupassen". Auf einigen gehosteten Servern müssen Sie die Zugriffsrechte für die Gruppe definieren, damit andere Nutzer Ihre Dateien nicht lesen oder verändern können.

Der Administrator für Ihren Server unterstützt Sie bei Problemen. Auf einihgen Servern ist die PHP-Einstellung "Safe Mode" erforderlich. Der Administrator wird diese Einstellung für Sie vornehmen.

5. Die Administrationsseite starten

Nachdem die Datei config.php angelegt wurde, wird nun die Adminseite aufgerufen, die Sie durch die weitere Konfiguration führt. Beim ersten Aufruf der Seite müssen Sie der GPL-Lizenzvereinbarung zustimmen bevor das Setup fortgesetzt wird.

Moodle richtet nun die Datenbank ein und erstellt die erforderlichen Tabellen in der Datenbank. Zuerst werden die Datenbanktabellen erstellt. Sie sehen auf dem Bildschirm eine Reihe von SQL-Meldungen und Bestätigungsmeldungen in roter oder grüner Schrift. Dies sieht in etwa so aus:

CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category int(10) unsigned NOT NULL default '0', password varchar(50) NOT NULL default , fullname varchar(254) NOT NULL default , shortname varchar(15) NOT NULL default , summary text NOT NULL, format tinyint(4) NOT NULL default '1', teacher varchar(100) NOT NULL default 'Teacher', startdate int(10) unsigned NOT NULL default '0', enddate int(10) unsigned NOT NULL default '0', timemodified int(10) unsigned NOT NULL default '0', PRIMARY KEY (id)) TYPE=MyISAM

SUCCESS

...und so weiter, gefolgt von: Main databases set up successfully.

. Speichern Sie die Datei in einen Webverzeichnis und rufen Sie sie mit dem Browser auf. Nun können Sie alle Einstellungen von PHP ablesen. Prüfen Sie diese Schritte und und versuchen Sie dann die Admin-Seite erneut aufzurufen.

Scrollen Sie nun bis zum Ende der Seite und drücken Sie den Button "Continue/Weiter" .

Danach sehen Sie eine Reihe von Anzeigen, die das Erstellen der Tabellen für die verschiedenen Module von Moodle bestätigen. Wie zuvor sollten alle Einträge grün sein.

Drücken Sie nun am Fuß der Seite wieder den "Continue/Weiter" Button.

Nun sehen Sie ein Formular mit dem Sie weitere Einstellungen an Ihrem Moodle vornehmen können, wie z.B. die voreingestellte Sprache, SMTP hosts und so weiter. Sie müssen nicht alle Einstellungen sofort vornehmen. Sie können die Einstellungen jederzeit im Administrationsmenu nachbearbeiten. Am Fuß der Seite finden Sie wieder einen Button "Ändern der Einstellungen/Save changes" Button.

Wenn (und wirklich nur dann) das Setup stecken bleibt, dann hat Ihr Server womöglich ein "buggy referrer" Problem. Dieses ist jedoch leicht zu beheben: Setzen Sie in der Datei config.php die Variable secureforms auf off und starten Sie die Adminseite erneut.

Als nächstes sehen Sie eine Vielzahl von Statusmeldungen von der Einrichtung der erforderliche Tabellen in der Datenbank für die verschiedenen moodle Module. Sie sollten - wie zuvor - in grüner Schrift bestätigt sein.

Scrollen Sie jeweils nach unten auf derSeite und bestätigen Sie den "Fortsetzen/Weiter" Link.

Auf der nächsten Seite legen Sie weitere Einstellungen Ihrer Seite fest (z.B. Name der Seite, Formate, Beschreibungen und so weiter). Füllen Sie alle Angaben aus (Änderungen können Sie jederzeit über das Administrationsmenu vornehmen) und klicken Sie auf "Änderungen bestätigen/Save changes".

Als letzten Schritt legen Sie die Zugangsdaten für den Administrator von Moodle fest. Tragen Sie Ihren eigenen Name, E-Mail etc. ein und klicken Sie auf "Änderungen bestätigen/Save changes". Nicht alle Felder müssen ausgefüllt werden. Falls Sie etwas vergessen haben, werden Sie automatisch daran erinnert.

Stellen Sie unbedingt sicher, dass Sie sich den Benutzernamen und das Passwort für den Administrationszugang merken. Er ist erforderlich für spätere Verwaltungen auf Moodle.

Wenn aus irgend einem Grund der Installationsprozess unterbrochen wurde bevor Sie die Zugangsdaten für den Admin erstellt haben, so können Sie den voreingestellten Adminzugang mit den Nutzernamen "admin", mit Passwort "admin" verwenden. ;.)

Erstellen und löschen von Kursen

• Erstellen und bearbeiten von Nutzerzugängen
• Verwaltung von Dozentenzugängen
• Veränderungen von Einstellungen,die für die gesamte Seite gelten.

Die Installation ist jetzt noch nicht ganz abgeschlossen. Sie haben noch eine wichtige Sache zu erledigen (siehe nächster Abschnitt über cron jobs

6. Einen Cron-Job einrichten

Moodle/Cron

Kurs anlegen

Moodle/Kurs