Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- minikurse:raspberry:dokuwiki_basis:lektionen:lektion_04 [2025/06/23 01:48] – strangelove
+++ minikurse:raspberry:dokuwiki_basis:lektionen:lektion_04 [2025/06/23 23:19] (aktuell) – [DokuWiki herunterladen und vorbereiten] strangelove
@@ Zeile 1: / Zeile 1: @@
-====== 📝 Lektion 4 – DokuWiki installieren & konfigurieren ======
+====== Lektion 4 – DokuWiki installieren & konfigurieren ======
-<WRAP round info 80% center>
+<WRAP round info 90% center>
-Ziel: DokuWiki auf dem Raspberry Pi im lokalen Netzwerk installieren und nutzbar machen.
+Ziel dieser Lektion:
+Du installierst DokuWiki lokal auf deinem Raspberry Pi, richtest die ersten Einstellungen ein und behebst typische Einsteigerfehler.
 </WRAP>
-===== 📦 Schritt 1 – DokuWiki herunterladen =====
+===== DokuWiki herunterladen und vorbereiten =====
-<WRAP box>
+  - Rufe https://download.dokuwiki.org auf
-. Besuche https://download.dokuwiki.org
+  - Lade die aktuelle Stable-Version als `.tgz`-Datei herunter
-. Lade die aktuelle Stable-Version als `.tgz` herunter
+  - Entpacke den Inhalt lokal auf deinem Rechner (z. B. `dokuwiki-2024-XX-XX`)
-. Entpacke den Inhalt auf deinem Rechner (z. B. `dokuwiki-2024-XX-XX`)
+===== Dateien auf den Raspberry Pi übertragen =====
-</WRAP>
-===== 🔁 Schritt 2 – DokuWiki auf den Pi übertragen =====
+Nutze FileZilla (SFTP), um die entpackten Dateien auf den Pi zu übertragen.
-<WRAP box>
+Verbindungsdaten:
-Nutze FileZilla mit folgenden Einstellungen:
-- Protokoll: **SFTP**
+^ Einstellung       ^ Wert                         ^
-- Host: `raspberrypi.local`
+| Protokoll         | SFTP                         |
-- Benutzername: `pi`
+| Host              | raspberrypi.local            |
-- Passwort: (dein Raspberry-Pi-Passwort)
+| Benutzername      | pi                           |
-- Port: `22`
+| Passwort          | (dein gesetztes Passwort)    |
+| Port              | 22                           |
+So gehst du vor:
+  * 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`
+<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 pi:www-data /var/www/html
+sudo chmod -R 755 /var/www/html
+</code>
-Navigiere zu `/var/www/html`
+Nach dem Upload solltest du die Dateiberechtigungen wieder korrekt setzen (siehe nächster Abschnitt).
-→ Lösche ggf. die `index.html`
-→ Lade den **kompletten Inhalt** des DokuWiki-Ordners hoch
 </WRAP>
-===== 🔒 Schritt 3 – Dateiberechtigungen korrekt setzen =====
+===== Dateiberechtigungen korrekt setzen =====
-<WRAP box>
+Damit DokuWiki korrekt funktioniert:
-Damit Apache auf alle Dateien zugreifen und DokuWiki schreiben kann:
 <code bash>
@@ Zeile 39: / Zeile 52: @@
 sudo find /var/www/html -type f -exec chmod 644 {} \;
 </code>
-</WRAP>
-===== 🌐 Schritt 4 – DokuWiki im Browser aufrufen =====
+→ Apache hat jetzt vollständige Rechte, und alle Dateien sind korrekt lesbar/ausführbar.
-<WRAP box>
+<WRAP info 90%>
-Öffne einen Browser und gehe zu:
+🔍 **Was bedeuten 755 und 644 bei `chmod`?**
-- `http://raspberrypi.local/install.php`
+Diese Zahlen sind sogenannte **numerische Dateiberechtigungen**, bei denen jede Ziffer für die Rechte einer Benutzergruppe steht:
-- oder: `http://192.168.X.X/install.php` (eigene IP)
-Du solltest das DokuWiki-Installationsformular sehen.
+  * Erste Ziffer → **Besitzer**
-</WRAP>
+  * Zweite Ziffer → **Gruppe**
+  * Dritte Ziffer → **Alle anderen**
-===== 🧑‍💼 Schritt 5 – DokuWiki konfigurieren =====
+Die Ziffern stehen für:
-<WRAP box>
+  * `7` = Lesen (4) + Schreiben (2) + Ausführen (1) → volle Rechte
-Fülle die Felder wie folgt aus:
+  * `5` = Lesen (4) + Ausführen (1)
+  * `4` = Lesen (4)
-- Wiki-Titel: z. B. „Mein Pi-Wiki“
+**Beispiele:**
-- Admin-Benutzername + Passwort
-- Sprache: Deutsch
-- Lizenz: Privat oder Creative Commons
-- ACL aktivieren: ✅
-- E-Mail (optional bei lokalem Betrieb)
-Klicke danach auf **Speichern**
+  * `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>
-===== ✅ Schritt 6 – Installation testen =====
+===== DokuWiki im Browser installieren =====
+Öffne den Browser auf deinem Rechner:
+- `http://raspberrypi.local/install.php`
+- oder direkt per IP: `http://192.168.X.X/install.php`
+→ Es erscheint das Installationsformular von DokuWiki.
+===== Konfiguration im Web-Installer =====
+Trage folgende Informationen ein:
+  * **Wiki-Titel**: z. B. „Mein Pi-Wiki“
+  * **Admin-Benutzername** und **Passwort**
+  * **E-Mail-Adresse**: optional bei lokalem Einsatz
+  * **Sprache**: Deutsch
+  * **Lizenz**: „Privat“ oder „Creative Commons“
+  * **ACL aktivieren**: Haken setzen
+Dann auf **„Speichern“** klicken.
-<WRAP box>
+===== Funktion prüfen =====
-Nach der Installation:
 - Startseite: `http://raspberrypi.local/doku.php?id=start`
 - Adminbereich: `http://raspberrypi.local/doku.php?do=admin`
-</WRAP>
-===== ⚠️ Bekannte Fehler & Lösungen =====
+→ DokuWiki sollte jetzt betriebsbereit sein.
-<WRAP round danger 80% center>
+===== Fehler: Setup Error (datadir/pages fehlt) =====
-Fehler: `The datadir ('pages') ... is not found or not writable`
-</WRAP>
-<WRAP box>
+Wenn du folgenden Fehler siehst:
-Dieser Fehler tritt auf, wenn DokuWiki nicht vollständig hochgeladen wurde
-→ oder die Berechtigungen nicht korrekt sind.
-**Lösung:**
+> The datadir ('pages') is not found, isn't accessible or writable.
-<code bash>
+Dann:
-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>
-→ Danach erneut `install.php` aufrufen
+- Überprüfe, ob du **den gesamten Ordner** (inkl. `data`, `conf`, `lib`) übertragen hast
-</WRAP>
+- Setze die Berechtigungen nochmals korrekt (siehe oben)
-<WRAP round danger 80% center>
+===== Fehler: xml_parser_create fehlt =====
-Fehler: `Call to undefined function xml_parser_create()`
-</WRAP>
+Wenn diese Fehlermeldung erscheint:
-<WRAP box>
+> Call to undefined function xml_parser_create()
-Dieser Fehler bedeutet, dass die PHP-XML-Erweiterung fehlt.
-**Lösung:**
+→ Die PHP-XML-Erweiterung fehlt. Installiere sie mit:
 <code bash>
@@ Zeile 111: / Zeile 131: @@
 sudo systemctl restart apache2
 </code>
-</WRAP>
-===== 🧱 Was du jetzt kannst =====
+===== Was du jetzt kannst =====
 <WRAP round important 90% center>
-✓ DokuWiki vollständig auf dem Raspberry Pi einrichten
+  * DokuWiki vollständig auf dem Pi installieren und einrichten
-✓ Apache-Dateiberechtigungen korrekt setzen
+  * Dateiberechtigungen korrekt setzen
-✓ Fehlerquellen wie „403 Forbidden“ oder `xml_parser_create` erkennen und beheben
+  * Typische Fehler wie 403 oder Setup-Fehler lösen
+  * Apache mit PHP-XML für DokuWiki konfigurieren
 </WRAP>
-===== 🔗 Nächste Schritte =====
+===== Nächste Schritte =====
+→ [[minikurse:raspberry:dokuwiki_basis:lektionen:lektion_05|Lektion 5 – Zugriff im lokalen Netzwerk (WLAN/LAN)]]
-[[minikurse:raspberry:dokuwiki_basis:lektionen:lektion_05|Weiter zu Lektion 5 – Zugriff im lokalen Netzwerk]]
 ----
 <WRAP center small>
 (c) Olaf Droste Products
-📍 Immermannstr. 31, 44147 Dortmund – www.olaf-droste-products.net
+Immermannstr. 31, 44147 Dortmund – www.olaf-droste-products.net
 </WRAP>