Benutzer:Zenith4237/Kiwix

Dieses Projekt wurde von Wikimedia Deutschland gefördert.

Der benutzte Raspberry Pi 3 Model B

Dieses Tutorial soll die Einrichtung eines Kiwix-Servers anhand eines Raspberry Pis 3 Modell B (kurz RPi / Pi) beschreiben. Dieser soll dann in einem Schulnetzwerk Wikipedia offline zur Verfügung stellen. Verwendet wurde Kiwix für ARM-CPUs (siehe unten) und die Version der englischen Wikipedia mit Bildern vom August 2017 (es gibt mittlerweile ein Update vom Mai 2018).

Was brauche ich?

• Grundlegende Kenntnisse von Netzwerken und Linux/Unix
• Raspberry Pi inklusive
  • Netzteil
  • (Micro) SD-Karte
  • gegebenenfalls USB-Stick

Da die Offlineversionen der Wikipedia recht groß sind (zweistellige Gigabyte-Anzahl, je nach Version) kann man entweder eine sehr große SD-Karte oder eine kleinere SD-Karte nur für das Betriebssystem verwenden und die Daten auf einem USB-Stick speichern (der dann an den Pi angesteckt wird). Zurzeit sind beide Varianten etwa gleich teuer.

• Falls nicht vorhanden: Ein Betriebssystem, in diesem Fall wurde Raspbian benutzt
• Kiwix für den Pi: kiwix-tools_linux-armhf.tar.gz (lädt automatisch die neueste Version)
• Eine Offlineversion der Wikipedia: Übersicht, aktuelle und vollständige englische Wikipedia (ohne Videos), alle Versionen im Überblick
• Zeit und Geduld

Prozedur

Vorbereitungen

Benötigte Dinge

• Benötigte Dateien herunterladen (Kiwix, gewünschte Version der Wikipedia)
• Wenn nötig: Raspbian herunterladen und auf die SD-Karte schreiben (Dokumentation auf raspberrypi.org)
• Kiwix und die gewünschte Version der Wikipedia nun entweder auf die große SD-Karte oder den USB-Stick kopieren
• Falls (wie in diesem Fall) kein Monitor genutzt wird: Nach der Installation von Raspbian auf der SD-Karte auf der boot-Partition die Datei SSH ohne Inhalt erstellen, damit SSH automatisch aktiviert wird (geht auf Unix-Systemen mit dem Befehl touch /mountpunkt/der/bootpartition/SSH)

RPi konfigurieren & Server starten

RPi an Netzteil und LAN

WLAN konfiguriert: Nur noch Strom und Daten USB-Stick nötig

raspi-config

• RPi mit eingesteckter SD-Karte an
  • ein lokales Netzwerk (LAN)
  • gegebenenfalls einen Monitor und eine Tastatur (nicht zwingend notwendig)
  • den Strom anschließen
• Ohne Monitor: IP-Adresse des Pis herausfinden und per SSH verbinden
• Anmelden, Username ist pi und Passwort raspbian
• Empfehlenswert: sudo raspi-config und Dinge wie den Hostnamen, ggf. WLAN, das Passwort, die Sprache, usw. konfigurieren (Navigation mit den Pfeiltasten und Tab, auch über SSH)
• Im Fall von Betrieb über WLAN: Pi nach Konfiguration des WLANs herunterfahren (sudo shutdown now), LAN-Verbindung trennen, Pi durch Aus- und wieder Einstecken hochfahren
• Für SSH erneut IP herausfinden und verbinden
• Statische IP-Adresse an den Pi vergeben und anschließend rebooten (sudo reboot)
• USB-Stick an den Pi anschließen, mounten (z. B. sudo fdisk -l, Partitionsnamen des USB-Sticks anhand der Größe herausfinden, etwa /dev/sda1, und mit mkdir /media/usb && sudo mount /dev/sda1 /media/usb mounten)
• Kiwix-Archiv mit tar -xzjf /weg/zum/archiv/name_des_archivs.tar.bz2 (es hieß bei mir kiwix-server-0.9-linux-armv5tejl.tar.bz2) entpacken und mit mv in den Ordner, in dem Kiwix laufen soll, kopieren (bei mir ~/kiwix)
• In den Ordner wechseln und den Server starten: cd /dein/kiwix/ordner und ./kiwix-serve /media/usb/name_der_wikipediaversion.zim
• Die Kommandozeile sieht aus, als würde sie hängen: Jetzt in einem beliebigen Browser eines Gerätes innerhalb des selben Netzwerkes die vorher vergebene IP-Adresse eingeben et voilà: Nach einem Klick auf Load sieht man die Kiwix-Wikipedia

Weitere Informationen

• Kiwix Homepage
• Dokumentation zu Kiwix-serve auf wiki.kiwix.org
• Überblick über die Kiwix-Versionen für verschiedene Betriebssysteme, ebenda

Fragen?

Bei Fragen gerne einen Abschnitt auf der Diskussionsseite erstellen.