====== Installationsanleitung ======
^ Version ^ Status ^ Datum ^ Autor ^ URL ^
| 0.1| Entwurf| 26.08, 03.09.2020 | Koch Joel| |
| 0.2| Finish| 16.09, 17.09.2020 | Koch Joel| |
| 0.3| Ergänzungen| 18.09.2020 | Koch Joel| |
| 1.0| Review und Freigabe| TT.MM.JJJJ| Vorname Nachname| |
===== 1. Kurzfassung =====
//In dieser Anleitung wird beschrieben, wie man auf einen Ubuntu Server den Moodle Server installiert. Die Installation des Servers erfolgt über die Kommandozeile. Die Basis installation und die Konfiguration jedoch, wird auf dem grafischen Interface auf der Webseite erledigt. Zur Konfiguration gehört auch die Authentifizierung durch einen LDAP-Server.//
===== 2. Installation =====
==== 2.1 Kern und Zusätzliche Software ====
Zunächst muss Apache, MySQL und PHP installiert werden. Dies geht wie folgt:
sudo apt install apache2 mysql-client mysql-server php libapache2-mod-php
Nun setzen wir das Rootpasswort für MySQL:
sudo mysql_secure_installation
Wir wählen die Passwortsicherheit LOW aus, setzen aber trotzdem ein sicheres Passwort.
Nachdem setzen des Passworts kommen ein paar Fragen die man alle mit Yes beantworten kann.
Danach wird noch zusätzliche Software installiert:
sudo apt install graphviz aspell ghostscript clamav php7.4-pspell php7.4-curl php7.4-gd php7.4-intl php7.4-mysql php7.4-xml php7.4-xmlrpc php7.4-ldap php7.4-zip php7.4-soap php7.4-mbstring
sudo service apache2 restart
Für das installieren vom Moodle Paket benutzen wir Git:
sudo apt install git
==== 2.2 Moodle ====
cd /opt
Den Moodle Code herunterladen:
sudo git clone git://git.moodle.org/moodle.git
Ins Verzeichnis mit dem heruntergeladenen Code wechseln:
cd moodle
Nun listen wir alle Versionen auf:
sudo git branch -a
Danach wählen wir eine davon aus:
sudo git branch --track MOODLE_39_STABLE origin/MOODLE_39_STABLE
sudo git checkout MOODLE_39_STABLE
Jetzt kopieren wir das lokale Repository zu /var/www/html:
sudo cp -R /opt/moodle /var/www/html/
sudo mkdir /var/moodledata
sudo chown -R www-data /var/moodledata
sudo chmod -R 777 /var/moodledata
sudo chmod -R 0755 /var/www/html/moodle
=== 2.2.1 MySQL ===
Als nächstes konfigurieren wir das MySQL file:
sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
Diese 3 Statements muss man bei den Basic Settings in der letzten Zeile einfügen:
default_storage_engine = innodb
innodb_file_per_table = 1
(Beim Zeitpunkt dieser Doku funktionierte dieses Statement nicht:)
innodb_file_format = Barracuda
\\ Damit diese Änderungen auch richtig implementiert werden, restarten wir MySQL;
sudo service mysql restart
Jetzt müssen wir die Moodle Datenbank erstellen und konfigurieren:
sudo mysql -u root -p
CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
"passwordformoodledude" und "moodledude" auf deine Anforderungen ändern.
create user 'moodledude'@'localhost' IDENTIFIED BY 'passwordformoodledude';
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO 'moodledude'@'localhost';
quit;
Dann müssen wir die Berechtigungen ändern damit wir die Installation von Moodle sauber durchführen können:
sudo chmod -R 777 /var/www/html/moodle
Danach öffnest du deinen Browser und gehst zu -> http://IP.VON.DEINEM.SERVER/MOODLE
===== 3. Konfiguration =====
==== 3.1 Basiskonfiguration von Moodle ====
Die bevorzugte Sprache oder die vorgegebene.
var/moodledata
Wähle --> mysqli
Host Server --> localhost
Datenbank --> moodle
User --> ... (Der Benutzer den du beim aufsetzen der Datenbank erstellt hast)
Password --> ... (Das Passwort das du für den Benutzer erstellt hast)
Tables Prefix --> mdl_
Da wir die Basiskonfiguration auf dem Webinterface gemacht haben, müssen wir diese Berechtigungen noch ändern.
sudo chmod -R 0755 /var/www/html/moodle
==== 3.2 Zusätzliche Konfiguration ====
Gehe zu Seiten Administration --> Server --> Systempfade
Path to du --> /usr/bin/du
Path to apsell --> /usr/bin/aspell
Path to dot --> /usr/bin/dot
Sichere deine Änderungen
Das Quarantäne Verzeichnis erstellen:
sudo mkdir /var/quarantine
Den Besitzer ändern:
sudo chown -R www-data /var/quarantine
Nun navigiere zur Seitenadmininstration -> Plugins -> Antivirus Plugins -> Antivirus Plugins verwalten
Aktivere ClamAV Antivirus
Gehe zu Einstellungen
Setze die richtigen Einstellungen
ClamAV Pfad: /usr/bin/clamscan
Quarantäne Pfad: /var/quarantine
Speichern
===== 4. LDAP =====
==== 4.1 Installation ====
Da wir nun alle Konfigurationen am Moodle fertig gemacht haben, können wir mit der Authentifizierung beginnen.
\\ Für das gehen wir zuerst zur Seitenadministration -> Plugins -> Plugins installieren\\
Danach installieren wir ein Plugin von der Moodle Website.
{{:technische-dokumentationen:installationsanleitungen:moodle_install_plugins.png?400|}}
Auf der Website angelangt, suchen wir nach LDAP. Eines der ersten sollte LDAP (Sync Plus) sein.
{{:technische-dokumentationen:installationsanleitungen:moodle_ldap_sync_plus.png?400|}}
Genau dieses Plugin brauchen wir. Also wählen wir die neueste Version aus und installieren es auf unseren Computer. Danach gehen wir zurück zur Plugins Installieren Seite und ziehen den ZIP Ordner in das Feld hinein. Sobald es installiert ist, geht es weiter zum Konfigurieren.
==== 4.2 Konfiguration ====
Als erstes konfigurieren wir die LDAP Verbindung. Für das müssen wir zu -> Plugins -> Plugins Übersicht. Wenn man dann auf zusätzliche Plugins klickt, kommt das neu installierte Plugin. Wir gehen dann zu den Einstellungen und konfigurieren sie so. ((https://docs.moodle.org/19/de/Authentifizierung_%C3%BCber_LDAP)) ((https://docs.moodle.org/39/en/LDAP_authentication))
Server Settings
Host URL --> Die IP-Adresse des LDAP-Servers
Bind Settings
Distinguished Name --> Den Bind-User muss man hier angeben. Beispiel: cn=admin,dc=rafisa,dc=org
Password --> Das Passwort für den Bind-User.
User lookup Settings
User Type --> Welchen Nutzertyp deinen LDAP Server benutzt. Beispiel: posixAccount (rfc2307)
Contexts --> Wo die zu synchronisierenden Benutzer sind. Beispiel: ou=people,dc=rafisa,dc=org
Search Subcontexts --> Yes
Dereference Alias --> Yes
User Attribute --> uid
Member Attribute --> memberuid
Member Attribute uses dn --> 0
LDAP Password Expiry Settings
Expiry Warning --> 10
Damit diese Authentifizierung auch benutzt wird, muss man sie noch aktivieren. Für das gehen wir wieder zu Plugins -> Plugins Übersicht -> zusätzliche Plugins.
Dann klicken wir hier drauf:
{{:technische-dokumentationen:installationsanleitungen:moodle_authentifizierung.png?400|}}
Und klicken dann auf das Auge. Auch kann man es noch mit den Pfeilen nach oben verschieben damit es die bevorzugte Authentifizierungsmethode ist.
==== 4.3 Synchronisierungs Vorgang ====
Damit die User auch Synchronisiert werden, muss man noch einen Vorgang konfigurieren.
Für das geht man zu Seiten Adminstration -> Server -> Geplante Vorgänge.
Dann bei **LDAP users sync job (Sync Plus)** diese Veränderungen vornehmen.
Minute --> */5
Hour --> *
Day --> *
Month --> *
Day of Week--> *
Die Checkbox wo Disabled steht noch unchecken damit der Vorgang aktiviert wird.
Was das nun macht, ist, dass dieser Vorgang jede 5 Minuten gestartet wird.
Wenn man möchte, kann man dies auch gerade Testen in denn man die Einstellungen speichert und dann auf "Run Now" klickt.
===== 5. Testing =====
==== Moodle-Installation ====
^ Testfall Nr. | #1 |
^ Beschreibung | Das Verbinden mit dem Moodle Server |
^ Vorgehen | Den Internetbrowser seiner Wahl öffnen |
| ::: | Dann zu **IP.ADRESSE.VOM.SERVER/moodle** gehen |
^ Voraussetzung / Umfeld | Die Moodle Installation wurde richtig durchgeführt |
^ Erwartetes Resultat | Die Verbindung wird ohne Probleme hergestellt. |
^ OK / nicht OK | OK |
^ Aufgetretene Fehler / Bemerkungen | Keine |
==== LDAP-Verbindung ====
^ Testfall Nr. | #2 |
^ Beschreibung | Das Anmelden via LDAP funktioniert |
^ Vorgehen | Mit den Benutzerdaten von einem LDAP Benutzer sich im Moodle einloggen |
^ Voraussetzung / Umfeld | Die LDAP Verbindung ist richtig konfiguriert und die Benutzer sind synchronisiert. |
^ Erwartetes Resultat | Man kann sich einloggen |
^ OK / nicht OK | OK |
^ Aufgetretene Fehler / Bemerkungen | Keine |
===== 6. Auswertung =====
//Ich konnte bei diesem langwierigen Projekt viel über den Moodle Server lernen. Leider funktionierte nicht alles von Anfang an wie es sollte, da der Authentifizierungs Prozess sehr schwierig war zu konfigurieren. Die einzelnen Einstellungen hatten nämlich keine Ähnlichkeit gegenüber den anderen Server die wir aufgesetzt haben. Somit musste ich viele Informationen recherchieren und ausprobieren. Nach langer recherche jedoch, konnte ich das System zum laufen bringen und die Freude war umso grösser, als das System endlich lief.//
===== 7. Quellenverzeichnis =====
https://docs.moodle.org/39/en/Step-by-step_Installation_Guide_for_Ubuntu