Wikipedia:Technik/MediaWiki/Private Installation

MediaWiki – Private (lokale) Installation

Wie installiere ich auf meinem PC ein kleines lokales MediaWiki-Wiki? Es gibt auf den Seiten der deutschsprachigen Wikipedia, Meta oder der Wikibooks zahlreiche Anleitungen, die jedoch entweder schwer verständlich bzw. veraltet sind oder sich primär mit der MediaWiki-Installation für den Download der bestehenden Datenbank der Wikipedia befassen. Hier soll dagegen (vor allem) für Laien ein einfacher (und vor allem präziser) Weg gezeigt werden, sich zu Hause auf dem PC ein lokales Wiki zu installieren, in welchem man Texte für die Wikipedia in der gewohnten Umgebung offline vorbereiten, und natürlich auch Seiten aus der Wikipedia speichern kann. Möglich wäre es auch mit einer lokalen Installation innerhalb eines Firmen-Intranets ein Wiki für Dokumentationen bzw. als Wissensdatenbank aufzubauen, an dem mehrere Benutzer über das Netzwerk mitarbeiten können.

Die Software MediaWiki, welche die Wikipedia zum Laufen bringt, benötigt diverse Hintergrundprogramme. Hier wird die Variante der Installation mithilfe von XAMPP beschrieben, die wohl die einfachste ist.

Voraussetzungen, Downloads Bearbeiten

Folgende Programme – alles Freie Software bzw. Open Source – werden benötigt:

Speichere diese Dateien an einem Ort, wo sie auch später für eventuelle Neuinstallation im Originalzustand zur Verfügung stehen.

Für die (portable) Installation benötigst du ca. 600 MB für XAMPP und ca. 230 MB für Mediawiki. Solange du dein lokales Wiki nur zur Artikelvorbereitung und Speicherung von Material verwenden willst, benötigst du auf lange Sicht nur wenige hundert MB für die Seiten.

Zeitaufwand für die Installation: Mancherorts werden 30 Minuten veranschlagt, was für einigermaßen versierte Benutzer realistisch ist. Falls du die Software zum ersten Mal installierst, plane wesentlich mehr Zeit ein. Aber auch wenn man die Anweisungen genauer durchlesen muss und etwas mehr braucht, der Aufwand lohnt sich.

Installation von XAMPP Bearbeiten

XAMPP ist ein Softwarepaket, mit dem alle benötigten Programme gleich mitinstalliert werden. Für die Installation von XAMPP, wo sich später auch das lokale Wiki befinden wird, eignet sich eine kleine Partition, wenn nicht vorhanden, dann ein neuer Ordner am besten im Systemlaufwerk. Notiere dir alle Anmeldedaten (User, Passwort), die du festlegst, damit du später auch reinkommst.

Apache und MySQL / MariaDB zum Laufen bekommen Bearbeiten

  • nach einem Doppelklick auf den XAMPP-Installer wird der Installations-Assistent gestartet, wähle die oben genannten vier Komponenten aus
  • das Programm kann in einen Ordner (z. B. C:\XAMPP) installiert werden, für die portable Version kannst du z. B. den Ordner C:\PortableApps\XAMPP-Portable verwenden (passe also die Pfade in der folgende Anleitung entsprechend an)
  • nach Abschluss der XAMPP-Installation starte das XAMPP Control Panel (die xampp-control.exe im Ordner C:\XAMPP) - Lege dazu einfach eine Verknüpfung auf dem Desktop an: (rechte Maustaste) auf xampp-control.exe und Senden an - Desktop - Beachte: Das Control Panel solltest du immer mit (rechte Maustaste) Als Administrator ausführen starten, damit du z. B. ausreichende Rechte hast, um Konfigurationsänderungen abzuspeichern.
  • Falls du beim Start des "Apache" eine Fehlermeldung mit einem Port-Konflikt erhältst, dann ändere die Ports wie folgt ab:
  • im Control Panel unter Netstat zwei freie Ports suchen
  • in der Zeile Apache "Konfig" klicken und Apache (httpd.conf) wählen, im Editor die Zeile mit Listen (engl. für hören / lauschen) ändern z. B. in Listen 8080 und speichern
  • in der Zeile Apache "Konfig" klicken und Apache (httpd-ssl.conf) wählen, im Editor die Zeile mit Listen ändern z. B. in Listen 4433 und speichern
  • dann musst du noch in der XAMPP Control Panel Konfig (oben rechts) Dienste und Ports einstellen wählen und hinter Apache2.4 den Hauptport 8080 und den SSL-Port 4433 eintragen und speichern
  • den Apache-Webserver neu starten
  • möglicherweise kommen jetzt von der Microsoft Defender Firewall Sicherheitshinweise für den Apache HTTP Server und mysqld.exe, hier musst du einmalig die Kommunikation für private Netzwerke zulassen
  • um "Apache" und "MySQL" beim Start des XAMPP Control Panels mit zu starten, gehe in die Control Panel-Konfiguration und setze unter Module automatisch starten die Häkchen bei Apache und MySQL

Eine leere Datenbank und einen Datenbank-Benutzer anlegen Bearbeiten

  • rufe in deinem Browser diese Seite auf: http://localhost/phpmyadmin/, falls du den Port geändert hast, verwende diese Seite http://localhost:8080/phpmyadmin/ (und ändere alle folgenden Aufrufe entsprechend deines Ports ab)
  • rechts erhältst du Informationen zum Datenbank- und zum Webserver
  • wähle unter Anzeige-Einstellungen deine Sprache
  • klicke dann oben auf Datenbanken und Neue Datenbank anlegen
  • wähle einen Namen für die Datenbank z. B. WikiDB, als Zeichensatz utf8_unicode_ci und klicke Anlegen
  • den Hinweis: "Es wurden keine Tabellen in der Datenbank gefunden" kannst du ignorieren
  • klicke oben auf den Tab Rechte und dann auf Benutzerkonto hinzufügen
    • wähle einen Benutzernamen (Textfeld verwenden): z. B. WikiUser
    • wähle unter Hostname Lokal / localhost
    • gib das Passwort 2x ein
    • für die Option "Gewähre alle Rechte auf die Datenbank wikidb." sollte das Häkchen gesetzt sein
    • setze noch das Häkchen unter "Globale Rechte" bei Alle auswählen und klicke Ok (ganz links unten auf der Seite)
  • wenn alles geklappt hat, dann erscheint im Tab Benutzerkonten die Meldung: "Der Benutzer wurde hinzugefügt"

Dieser Benutzer ist der spätere Bürokrat und Administrator in dem neuen Wiki. Du hast dir hoffentlich Benutzername und Passwort notiert?

Editieren der php.ini Bearbeiten

Um sicherzugehen, dass der Apache-HTTP-Server während der Erstellung der Datenbanken keine Zeitüberschreitung verursacht, ändere die Konfigurationsdatei php.ini:

  • öffne die Datei php.ini (zu finden im Ordner C:\XAMPP\php) mit einem Editor deiner Wahl, suche max_execution_time und ändern diese in: max_execution_time = 600

Um sicherzustellen, dass die intl Extension erkannt wird:

  • suche ;extension=intl und ändere diese in extension=php_intl.dll bzw. entsprechend deinem System
  • speichere die php.ini und starte den Apache neu

Installation und Anpassung von MediaWiki Bearbeiten

Installation der Software Bearbeiten

  • kopiere das heruntergeladene MediaWiki-Archiv (z. B. mediawiki-1.35.1.tar.gz) in den htdocs-Ordner, also z. B. nach C:\XAMPP\htdocs
  • starte die sogenannte Eingabeaufforderung cmd.exe und wechsle in das genannte Verzeichnis: cd C:\XAMPP\htdocs
  • entpacke das Archiv mittels des tar-Befehls z. B.: tar xzvf mediawiki-1.35.1.tar.gz (das kann einige Zeit dauern ...)
  • benenne den entstandenen Ordner mediawiki-1.35.1 z. B. in mediawiki um, so dass sich die MediaWiki-Dateien im Ordner C:\XAMPP\htdocs\mediawiki befinden
  • die Datei mediawiki-1.35.1.tar.gz kannst du an dieser Stelle löschen, da du ja noch eine Kopie hast

Konfiguration des Wikis Bearbeiten

  • rufe im Browser die Seite: http://localhost/mediawiki auf (oder http://localhost:8080/mediawiki siehe oben)
  • es erscheint "MediaWiki 1.35.1 LocalSettings.php not found", klicke auf set up the wiki, damit wird der Konfigurations-Script aufgerufen, mit dem das neue Wiki grundkonfiguriert werden kann. Dieser Skript ist in mehrere Seiten aufgeteilt:
    • Seite Sprache: Sprache während des Installierens und Sprache des Wikis: Deutsch
    • Seite Willkommen bei MediaWiki!: Prüfung der Installationsumgebung, wenn Ok - Weiter
    • Seite Mit der Datenbank verbinden
      • Datenbanksystem: MariaDB, MySQL (oder kompatible Datenbanksysteme)
      • MariaDB/MySQL-Einstellungen:
        • Datenbankserver: localhost
        • Name der Datenbank z. B.: WikiDB
        • Präfix der Datenbanktabelle: (bleibt hier leer)
        • Name des Datenbankbenutzers: root (wie voreingestellt, lassen)
        • Passwort des Datenbankbenutzers: (voreingestelltes lassen, i.d.R. leer; nur falls in XAMPP das Passwort für root geändert wurde, hier ebenfalls eintragen)
    • Seite Einstellungen zur Datenbank:
      • Häkchen setzen bei: Dasselbe Datenbankkonto wie während des Installationsvorgangs verwenden
    • Seite Name
      • Name des Wikis z. B.: MyWiki
      • Name des Projektnamensraums: Entspricht dem Namen des Wikis: MyWiki
      • Administratorkonto: Dein Benutzername z. B.: WikiUser + 2x Passwort
      • E-Mail-Adresse: (kann frei bleiben)
      • Ja, es sollen weitere Konfigurationseinstellungen vorgenommen werden (da es hier vorerst einfacher ist z. B. Erweiterungen zu aktivieren)
    • Seite Optionen:
      • Profil der Benutzerberechtigungen: offenes Wiki
      • Lizenz: keine Lizenzangabe in der Fußzeile
      • E-Mail-Einstellungen: Ausgehende E-Mails ermöglichen deaktivieren
      • Benutzeroberflächen: Vector - Diese Benutzeroberfläche als Standard verwenden (bei MonoBook und Timeless das Häkchen lassen)
      • Erweiterungen: hier können verschiedene Erweiterungen, die bereits mit MediaWiki 1.35.1 mitgeliefert werden, aktiviert werden, z. B.: VisualEditor, WikiEditor, ImageMap und PdfHandler
      • Hochladen von Bildern und Dateien: Das Hochladen von Dateien ermöglichen
      • InstantCommons aktivieren - Häkchen setzen, den Rest so lassen
      • Erweiterte Konfiguration: Kein Objektcaching
    • Seite Installieren: Installation starten und die Ergebnisse abwarten, wenn alles Ok ist:
    • Seite Fertig! - LocalSettings.php herunterladen!
  • diese Datei LocalSettings.php in das Verzeichnis C:\XAMPP\htdocs\mediawiki (bzw. C:\PortableApps\XAMPP-Portable\htdocs\mediawiki) kopieren
  • und zum Schluss im Browser die Seite: http://localhost/mediawiki/index.php/Hauptseite aufrufen
  • wenn die Hauptseite korrekt angezeigt wird, sollte dein neues Wiki funktionieren - du kannst mit dem Editieren beginnen

Wenn etwas unstimmig ist oder fehlt wird man zurückgerufen. Falls etwas gar nicht funktioniert, ist eine völlige Neuinstallation die beste Lösung: deinstalliere XAMPP mit allen Unterordnern und lösche alle vielleicht verbliebene Unterordner bzw. Dateien (zum Teil ist ein Neustart nötig) und installiere neu.

Weitere Anpassungen Bearbeiten

Die Sicherheit kann über http://localhost/security/ überprüft werden (siehe auch apachefriends.org/...html#1217).Dies ist besonders bei Wikis, die von einem Netzwerk zugänglich sind, von Bedeutung.

Die weiteren Anpassungen betreffen verschiedene Konfigurationsänderungen sowie das Installieren von Erweiterungen, die nicht automatisch von Anfang an vorhanden sind, sei es das Hochladen von Bildern, Ändern des Logos, Anlegen neuer Namensräume usw. Es gibt zwei grundsätzliche Wege, das Wiki anzupassen:

Andere Anleitungen Bearbeiten

Die folgenden Links erfolgen ohne Gewähr für die Stimmigkeit bzw. Aktualität; die Anleitungen können aber zum Vergleich herangezogen werden. Außerdem beinhalten sie hier nicht behandelte Themen wie Download eines Dumps der deutschsprachigen Wikipedia usw.

FAQ

allgemein

XAMPP

  • apachefriends.org - hier sind Links zu Anleitungen (und Downloads, FAQs usw.) für Windows, Linux, Mac OS x und Solaris
  • sourceforge.net - hier gibt es weitere Downloads, unter anderem auch die portablen Versionen

MediaWiki