Manual:Installing MediaWiki on Windows Server 2012 R2

Ziel dieser Anleitung ist es einen schnellen und einfachen Weg aufzuzeigen, MediaWiki auf einem Windows Server 2012 (R2) zu installieren.

In diesem Artikel wird der Internet Information Server (IIS) anstatt dem Apache Webserver verwendet.

Zusätzlich erklärt dieser Guide, wie die wichtigsten Erweiterungen in diesem Setup installiert werden und worauf man achten sollte.

Voraussetzungen
Die folgende Software ist für eine Installation erforderlich: Die folgende Software ist erforderlich, um die aufgeführten Erweiterungen zu installieren:
 * Administrativer Zugang zum Windows Server 2012 R2
 * MySQL Datenbank (Link)
 * 7-Zip (Link)
 * Notepad++ (Link)
 * Java SDK (Link)
 * GNU DiffUtils (Link)

Java SDK
Installiere das Java SDK (here).

Füge  als Umgebungsvariable hinzu.

Die Umgebungsvariablen sind unter "Systemsteuerung" > "System" > "Erweiterte Systemeinstellungen" zu finden.

Die Umgebungsvariable sollte auf den Installationsverzeichnis des JDK zeigen.

Internet Information Service (IIS)
Um den IIS zu installieren folge diesen Schritten: Um die Installation zu verifizieren rufe http://localhost im Browser auf, die IIS 8 splash Seite sollte erscheinen.
 * 1) Öffne den Server Manager.
 * 2) Klicke auf "Rollen und Features hinzufügen".
 * 3) Wähle "Rollen" aus.
 * 4) Wähle deinen Server aus.
 * 5) Füge die Rolle "Webserver (IIS)" hinzu.
 * 6) Unter der Rolle "Webserver (IIS)" füge folgendes hinzu
 * 7) Allgemeine HTTP-Features > HTTP-Umleitung
 * 8) Anwendungsentwicklung  > CGI</tt>

Lade MediaWiki herunter und extrahiere den Inhalt unter:

C:\inetpub\wwwroot\<DeinWikiVerzeichnisName></tt>.

Um zu überprüfen, dass das MediaWiki nicht noch weiter geschachtelt ist muss folgender Pfad stimmen:

C:\inetpub\wwwroot\<DeinWikiVerzeichnisName>\extensions\.</tt>

PHP
Um PHP zu installieren gibt es mehrer Wege. Zum einen kann PHP selbst heruntergeladen und konfiguriert werden.

Zum anderen kann PHP über den Webplattform Installer von Microsoft bezogen werden.

Webplatform Installer
Empfehlenswert ist es den Microsoft Webplatform Installer 5.0 zu verwenden um PHP zu beziehen.

Sobald der IIS Manager geöffnet wird, erscheint ein Dialog-Fenster mit der Möglichkeit, den Installer herunterzuladen.

Damit kann nach der favorisierten PHP Version gesucht werden und der Installer konfiguriert PHP für den IIS vor.

PHP 7.x führt aufgrund einiger Änderungen zu PHP 5.x zu Warnungen beim Ausführen einzelner .php</tt> Dateien der Erweiterungen.

Referenzen als Parameter werden in PHP 7.x nicht mehr mit einem  angegeben, dieses Zeichen muss entfernt werden.

Sobald die Debug-Einstellungen in der LocalSettings.php</tt> (nach der Installation von MediaWiki) werden in den Ausgaben die betroffenen Funktionen der Erweiterungen angegeben.

Um diese zu finden ist es ratsam mit Notepad++ nach den fehlerhaften Funktionen in den .php</tt> Dateien zu suchen.

MySQL Server
Installiere den MySQL Community Server, indem den Anweisungen der Installation gefolgt wird.

Stelle sicher das Visual C++ Redistributable 2013 bereits installiert ist.

Man kann es von der offiziellen Microsoft Seite herunterladen oder den MySQL Installer versuchen lassen, es zu installieren.

Software für die Erweiterungen
Installiere die für die Erweiterungen erforderliche Software, welche oben angegeben ist.

Jede der Erweiterungen ist optional zu installieren, jedoch wird die PDFHandler Erweiterung beispielsweise seit MediaWiki 1.21 mitgeliefert.

Um die aktualisierte PATH</tt> Umgebungsvariable zu testen kann die Kommandozeile (cmd.exe)</tt> verwendet werden.

Stelle sicher die Kommandozeile mit administrativen Rechten zu starten ("Als Administrator öffnen").

Gebe einfach nur die Namen der ausführbaren Dateien an und überprüfe, ob Windows diese von überall finden kann: Sollten die einzelnen Programme antworten ist es sehr wahrscheinlich, dass MediaWiki und die Erweiterungen diese finden und ausführen können.

SyntaxHighlight
Um diese Erweiterung zu installieren wird Pygments benötigt. Dies kann man über eine Python Installation beziehen und die Version 2.7.14 reicht dafür vollkommen aus.

Dennoch kann auch die Version 3.6.4 verwendet werden. Dort muss jedoch pip3</tt> zum installieren genutzt werden.

Nach der Installation muss über die Kommandozeile in dem Ordner Scripts</tt> mithilfe von pip2</tt> Pygments installiert werden: Danach ist die pygmentize.exe</tt> in dem Ordner zu finden. Den Pfad zu dieser ausführbaren Datei muss in der LocalSettings.php</tt> angegeben werden - siehe dazu XXXXXXXXXXX Konfiugration XXXXXXX.

MediaWiki
Öffne den Browser und navigiere zu: http://localhost/&#x3C;DeinWikiVerzeichnis&#x3E;/index.php.

Folge den Anweisungen zur lokalen MediaWiki Installation.

Sollte die PECL-Erweiterung intl für PHP fehlen, füge die DLL einfach deiner php.ini</tt> (Konfigurationsdatei für PHP) Datei hinzu und starte den MediaWiki Installationsvorgang erneut: Die DLL (Bibliothek) sollte im \ext\</tt> Verzeichnis (Verzeichnis für Erweiterungen) liegen.

Sollte alles gefunden und die Installationsumgebung erfolgreich geprüft worden sein, kann die Installation fortgesetzt werden.

SyntaxHighlight
Zu empfehlen ist die Version 3.6.2 (64-Bit). Um dann Pygments zu installieren kann folgender Befehl verwendet werden: Zusätzlich sollte der Nutzer  unter dem Register "Sicherheit" die   die Sicherheitsinformationen "Ändern / Schreiben / Lesen" erhalten.

Die Erweiterung ist seit MediaWiki 1.21 mitgeliefert, es muss nach dem typischen

nur der Pfad zu Pygments gesetzt werden: Für weitere Informationen bei Fehlern siehe auch phabricator task.

VisualEditor
Nachdem NodeJS (für den Parsoid Server) und die Erweiterung heruntergeladen und installiert wurde kann der Parsoid Server heruntergeladen, installiert und konfiguriert werden.

Zunächst muss  aktualisiert werden: Des Weiteren werden die Windows-Build-Tools benötigt:

Navigiere dann zu dem Verzeichnis in das der Parsoid Server installiert werden soll. Für den Fall, dass man den Ordner gern selbst benennen möchte, kann beim  Folgendes als Parameter mitgeben werden: Nach dem Parsoid beim   registriert ist, können die veralteten Packages aktualisiert werden: Danach sollte im Installationsverzeichnis die Konfiguration festgelegt werden.

Dazu muss die config.example.yaml kopiert und in config.yaml geändert werden.

Folgendes sollte in dieser config.yaml auskommentiert werden, damit die besser lesbare localsettings.js verwendet wird. Siehe Parsoid Setup für weitere Informationen zum Konfigurieren.

Danach in den LocalSettings.php wie auf der Erweiterungsseite beschrieben konfigurieren.

Damit Parsoid im Hintergrund nach einem Neustart des Servers automatisch läuft kann eine Aufgabe in der Aufgabenplanung erstellt werden.

Diese ruft dann eine Batchdatei auf in der folgender Aufruf enthalten ist: