Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- minikurse:raspberry:dokuwiki_basis:lektionen:lektion_04 [2025/06/22 22:50] – strangelove
+++ minikurse:raspberry:dokuwiki_basis:lektionen:lektion_04 [2025/06/23 23:19] (aktuell) – [DokuWiki herunterladen und vorbereiten] strangelove
@@ Zeile 3: / Zeile 3: @@
 <WRAP round info 90% center>
 Ziel dieser Lektion:
-Du installierst DokuWiki in das bestehende Webverzeichnis deines Raspberry Pi und richtest es vollständig ein – inklusive Admin-Zugang.
+Du installierst DokuWiki lokal auf deinem Raspberry Pi, richtest die ersten Einstellungen ein und behebst typische Einsteigerfehler.
 </WRAP>
-===== DokuWiki herunterladen (lokal) =====
+===== DokuWiki herunterladen und vorbereiten =====
-. Rufe auf deinem Hauptrechner die Seite auf:
-→ https://download.dokuwiki.org/
-. Lade die aktuelle Version als `.tgz`-Datei herunter (z. B. `dokuwiki-2024-XX-XX.tgz`)
-. Entpacke die Datei auf deinem Rechner. Du erhältst einen Ordner mit dem Namen `dokuwiki-...`.
+  - Rufe https://download.dokuwiki.org auf
+  - Lade die aktuelle Stable-Version als `.tgz`-Datei herunter
+  - Entpacke den Inhalt lokal auf deinem Rechner (z. B. `dokuwiki-2024-XX-XX`)
 ===== Dateien auf den Raspberry Pi übertragen =====
-Nutze FileZilla oder ein anderes SFTP-Tool. Einstellungen für die Verbindung:
+Nutze FileZilla (SFTP), um die entpackten Dateien auf den Pi zu übertragen.
+Verbindungsdaten:
 ^ Einstellung       ^ Wert                         ^
@@ Zeile 23: / Zeile 21: @@
 | Host              | raspberrypi.local            |
 | Benutzername      | pi                           |
-| Passwort          | (dein Passwort)              |
+| Passwort          | (dein gesetztes Passwort)    |
 | Port              | 22                           |
-. Verbinde dich mit dem Raspberry Pi
+So gehst du vor:
-. Navigiere rechts zum Ordner `/var/www/html`
-. Lösche die Datei `index.html`, falls vorhanden
-. Ziehe den **Inhalt** des `dokuwiki-...`-Ordners (nicht den Ordner selbst!) in das Webverzeichnis `/var/www/html`
-===== Dateirechte setzen =====
+  * Verbinde dich per SFTP mit deinem Pi
+  * Wechsle in das Verzeichnis: `/var/www/html`
+  * Lösche ggf. vorhandene `index.html`
+  * Übertrage den gesamten Inhalt des lokalen `dokuwiki-…`-Ordners nach `/var/www/html`
-Wechsle in ein Terminal oder SSH:
+<WRAP round tip 85%>
+Hinweis zur Nutzung von FileZilla:
+Falls du beim Löschen oder Überschreiben von Dateien Probleme bekommst, kannst du den Besitz des Zielverzeichnisses vorübergehend an den Benutzer `pi` übergeben – so lassen sich Änderungen via SFTP komfortabler vornehmen:
 <code bash>
-sudo chown -R www-data:www-data /var/www/html
+sudo chown -R pi:www-data /var/www/html
 sudo chmod -R 755 /var/www/html
-sudo systemctl restart apache2
 </code>
+Nach dem Upload solltest du die Dateiberechtigungen wieder korrekt setzen (siehe nächster Abschnitt).
+</WRAP>
+===== Dateiberechtigungen korrekt setzen =====
+Damit DokuWiki korrekt funktioniert:
+<code bash>
+sudo chown -R www-data:www-data /var/www/html
+sudo find /var/www/html -type d -exec chmod 755 {} \;
+sudo find /var/www/html -type f -exec chmod 644 {} \;
+</code>
+→ Apache hat jetzt vollständige Rechte, und alle Dateien sind korrekt lesbar/ausführbar.
+<WRAP info 90%>
+🔍 **Was bedeuten 755 und 644 bei `chmod`?**
+Diese Zahlen sind sogenannte **numerische Dateiberechtigungen**, bei denen jede Ziffer für die Rechte einer Benutzergruppe steht:
+  * Erste Ziffer → **Besitzer**
+  * Zweite Ziffer → **Gruppe**
+  * Dritte Ziffer → **Alle anderen**
+Die Ziffern stehen für:
+  * `7` = Lesen (4) + Schreiben (2) + Ausführen (1) → volle Rechte
+  * `5` = Lesen (4) + Ausführen (1)
+  * `4` = Lesen (4)
+**Beispiele:**
+  * `755` = Besitzer darf alles, Gruppe & andere dürfen lesen + ausführen
+  * `644` = Besitzer darf lesen + schreiben, Gruppe & andere dürfen nur lesen
+So stellst du sicher, dass z. B. HTML/PHP-Dateien korrekt ausgeführt und gelesen werden können, aber nicht jeder diese ändern darf.
+</WRAP>
 ===== DokuWiki im Browser installieren =====
-Öffne auf deinem Hauptrechner:
+Öffne den Browser auf deinem Rechner:
-– http://raspberrypi.local/install.php
+- `http://raspberrypi.local/install.php`
-– oder: http://192.168.2.123/install.php
+- oder direkt per IP: `http://192.168.X.X/install.php`
-→ Du solltest nun das Installationsformular von DokuWiki sehen.
+→ Es erscheint das Installationsformular von DokuWiki.
-===== DokuWiki konfigurieren =====
+===== Konfiguration im Web-Installer =====
-Trage ein:
+Trage folgende Informationen ein:
-– Wiki-Titel: z. B. „Mein Pi-Wiki“
+  * **Wiki-Titel**: z. B. „Mein Pi-Wiki“
-– Admin-Benutzername und Passwort
+  * **Admin-Benutzername** und **Passwort**
-– E-Mail-Adresse (optional bei rein lokalem Betrieb)
+  * **E-Mail-Adresse**: optional bei lokalem Einsatz
-– Sprache: Deutsch
+  * **Sprache**: Deutsch
-– Lizenz: „Keine Lizenz (privat)“ oder „Creative Commons“
+  * **Lizenz**: „Privat“ oder „Creative Commons“
-– ACL aktivieren: Haken setzen
+  * **ACL aktivieren**: Haken setzen
-Klicke dann auf **„Speichern“**.
+Dann auf **„Speichern“** klicken.
 ===== Funktion prüfen =====
-Nach dem Speichern wirst du weitergeleitet auf:
+- Startseite: `http://raspberrypi.local/doku.php?id=start`
+- Adminbereich: `http://raspberrypi.local/doku.php?do=admin`
-– http://raspberrypi.local/doku.php?id=start
+→ DokuWiki sollte jetzt betriebsbereit sein.
-– oder mit IP: http://192.168.2.123/doku.php?id=start
-Admin-Oberfläche:
+===== Fehler: Setup Error (datadir/pages fehlt) =====
-– http://raspberrypi.local/doku.php?do=admin
+Wenn du folgenden Fehler siehst:
+> The datadir ('pages') is not found, isn't accessible or writable.
+Dann:
+- Überprüfe, ob du **den gesamten Ordner** (inkl. `data`, `conf`, `lib`) übertragen hast
+- Setze die Berechtigungen nochmals korrekt (siehe oben)
+===== Fehler: xml_parser_create fehlt =====
+Wenn diese Fehlermeldung erscheint:
+> Call to undefined function xml_parser_create()
+→ Die PHP-XML-Erweiterung fehlt. Installiere sie mit:
+<code bash>
+sudo apt update
+sudo apt install php-xml
+sudo systemctl restart apache2
+</code>
 ===== Was du jetzt kannst =====
 <WRAP round important 90% center>
-– DokuWiki vollständig lokal installieren
+  * DokuWiki vollständig auf dem Pi installieren und einrichten
-– Admin-Zugang einrichten
+  * Dateiberechtigungen korrekt setzen
-– Webbasierte Oberfläche über Browser verwalten
+  * Typische Fehler wie 403 oder Setup-Fehler lösen
+  * Apache mit PHP-XML für DokuWiki konfigurieren
 </WRAP>
 ===== Nächste Schritte =====
-Weiter mit:
+→ [[minikurse:raspberry:dokuwiki_basis:lektionen:lektion_05|Lektion 5 – Zugriff im lokalen Netzwerk (WLAN/LAN)]]
-[[minikurse:raspberry:dokuwiki_basis:lektionen:lektion_05|Lektion 5 – Zugriff im lokalen Netzwerk (WLAN/LAN)]]
 ----