☚ zurück

Dieses Kapitel beschreibt die Installation und Konfiguration von DokuWiki auf einem Raspberry Pi. Es werden die Einrichtung des Webservers (Apache2 & PHP), der Download und die Konfiguration von DokuWiki sowie die notwendigen Berechtigungen behandelt.

• Webserver (Apache2 & PHP) installieren
• DokuWiki (Download & Konfiguration)
• DokuWiki (Installation)

Apache2 ist ein Webserver, der Anfragen von Browsern entgegennimmt und Webseiten ausliefert. PHP ist eine serverseitige Scriptsprache, mit der dynamische Inhalte erzeugt werden können. Zusammen bilden sie die Grundlage, um DokuWiki auf dem Raspberry Pi im lokalen Netzwerk oder Internet bereitzustellen.

sudo apt update && sudo apt upgrade -y 
sudo apt install -y apache2 php libapache2-mod-php php-xml php-mbstring php-zip php-gd php-json php-curl php-opcache 
sudo systemctl restart apache2

Um sicherzustellen, dass Apache2 korrekt gestartet wurde und Webseiten ausliefern kann, sollte der Status des Servers überprüft werden.

sudo systemctl status apache2    # Zeigt den aktuellen Status von Apache2

Außerdem sollte man den Webserver über einen Browser testen:

• lokal auf dem Raspberry Pi: http://localhost
• von einem anderen Gerät im Netzwerk: http:<IP-Adresse des Raspberry Pi> ===== DokuWiki (Download & Konfiguration) ===== ++ Headless Raspberry Pi Das Herunterladen geschieht normalerweise auf dem Remote-Rechner. Dadurch stellt sich die Frage, wie DokuWiki auf den Raspberry Pi übertragen wird. Man könnte (nicht empfohlen) auch über VNC arbeiten. Damit wäre dieses Problem gelöst. Wir wollen jedoch lernen, wie man unter Linux auf der Konsole arbeitet. Es stehen zwei Methoden zur Auswahl: * ein SFTP-GUI-Client (z. B. FileZilla) * oder scp auf der Konsole <note tip> Im Kurs werden alle drei Methoden (VNC, FileZilla und scp) geübt. </note> === DokuWiki herunterladen === | |Die offizielle Website des DokuWiki.| DokuWiki wird über die offizielle Website DokuWiki heruntergeladen. Wir verwenden stets die Version: Stable. Beim Download kann zusätzlich angegeben werden, welche Sprachen oder Plugins enthalten sein sollen. <note tip> DokuWiki herunterladen: * https://www.dokuwiki.org/dokuwiki </note> Wir verwenden folgende Einstellungen: * Sprache: nur Englisch und Deutsch * Plugins: Alle Plugins aktivieren * Version: Wir wählen die Stable-Version || |Die Abbildung zeigt die von uns verwendeten Einstellungen zum Download von DokuWiki.| === Konfiguration === Nach dem Herunterladen muss die Datei (*.tgz) in das Verzeichnis /var/www/html kopiert und dort entpackt werden.

  sudo cp ~/dokuwiki-stable.tgz /var/www/html   # kopieren (User pi) nach /var/www/html
  cd /var/www/html                               # in das Verzeichnis wechseln
  sudo tar -xzf dokuwiki-stable.tgz             # auspacken (extrahieren)

  Anschließend muss sichergestellt werden, dass die Verzeichnisse und Dateien dem Benutzer und der Gruppe www-data zugeordnet sind, wie es für Apache HTTP Server erforderlich ist. Schließlich sollte das Verzeichnis noch „ordentlich“ umbenannt werden. Erst danach kann die eigentliche Installation von DokuWiki erfolgen.

  sudo chown -R www-data:www-data dokuwiki*   # Benutzer und Gruppe auf www-data setzen
  sudo mv dokuwiki* wiki                      # umbenennen

  === Wiki bearbeiten === Um produktiv arbeiten zu können kann der Benutzer (hier: pi) der Gruppe www-data hinzugefügt werden. Für ein Heimnetzwerk wie „BASELSYSTEM“ ist das eine gute Lösung. Für professionelle Ansprüche existieren natürlich auch andere Alternativen.

  sudo usermod -aG www-data pi
  newgrp www-data

  ++ ===== DokuWiki (Installation) ===== Die Installation von DokuWiki läuft nach folgendem Schema ab: Eine Installationsseite (hier: install.php) wird über den Webserver aufgerufen. Danach folgt man den Anweisungen für die jeweilige Installationsroutine. Zum Schluss sind häufig Aufräumarbeiten durchzuführen. Bei DokuWiki bedeutet das, dass die Installationsdatei auf dem Server gelöscht werden muss. Dieses Schema kann beliebig oft mit einer neuen Installation wiederholt werden, falls man das Wiki durch zu viel Experimentieren „zerschießen“ sollte.