Voraussetzungen¶

Als Unterbau für MediaWiki wird LAMP installiert mit ein paar PHP-Erweiterungen. Wahlweise kann auch nginx statt Apache eingesetzt werden, worauf hier nicht weiter eingegangen wird.

• apache2

• libapache2-mod-php

• php

• php-mysql

• mysql-server

• php-xml

• php-mbstring

Befehl zum Installieren der Pakete:

sudo apt-get install apache2 libapache2-mod-php php php-mysql mysql-server php-xml php-mbstring 

Oder mit apturl installieren, Link: apt://apache2,libapache2-mod-php,php,php-mysql,mysql-server,php-xml,php-mbstring

Zunächst muss dem root-Benutzer von MySQL noch ein Passwort vergeben werden. Hierfür melden wir uns zunächst als root bei MySQL an. Ab Ubuntu Focal Fossa muss man zum Anmelden bei MySQL root-Rechte haben.

sudo mysql -u root 

Nun wird das Passwort des root-Benutzers in der MySQL-Eingabeaufforderung geändert:

ALTER USER 'root'@'localhost'
IDENTIFIED WITH mysql_native_password BY 'MysqlRootPasswort_BitteÄndern';
FLUSH privileges;
QUIT; 

Aus den Paketquellen (veraltete Version)¶

Mediawiki kann aus den offiziellen Paketquellen installiert werden. Dies wird allerdings nicht empfohlen, da es sich hier meist um veraltete, nicht mehr unterstützte Versionen handelt (Versionszyklus 🇬🇧). Aktuellere Versionen und eine alternative Installationsmethode gibt es weiter unten.

Mediawiki ist in den offiziellen Paketquellen von Ubuntu enthalten und kann über das folgende Paket installiert werden ^[1]:

• mediawiki (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install mediawiki 

Oder mit apturl installieren, Link: apt://mediawiki

manuelle Installation aktueller, unterstützter Versionen¶

Es gibt mehrere unterstützte Versionen 🇩🇪. Von der Downloadseite 🇩🇪 sucht man sich die gewünschte Version, kopiert den Link auf die "stabile" oder die "LTS"-Version (zur Zeit 1.35.1) und fügt ihn hinter wget ein:

cd /tmp/
wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.1.tar.gz 

Nun wird das Archiv entpackt, in das Root-Verzeichnis des Webservers kopiert und das Archiv anschließend gelöscht:

tar -xzvf mediawiki-1.35.1.tar.gz
sudo mv mediawiki-1.35.1 /var/www/html/mediawiki
rm mediawiki-1.35.1.tar.gz 

Der Benutzer und Benutzergruppe müssen noch angepasst werden an die von Apache:

cd /var/www/html
sudo chown www-data:www-data -R mediawiki/ 

Mysql einrichten¶

Zunächst muss man sich wieder als Superuser ^[3] bei MySQL anmelden:

mysql -u root -p    # Oben vergebenes MysqlRootPasswort_BitteÄndern eingeben nach `Enter` 

In der Mysql-Konsole legt man einen Benutzer und eine Datenbank für das MediaWiki an. wikiuser und wikidb können verändert werden, sind der Konsistenz dieses Artikels wegen jedoch so gewählt.

CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'wikiuserPasswort_BitteÄndern';
CREATE DATABASE wikidb;
GRANT ALL ON wikidb.* TO 'wikiuser'@'localhost';
QUIT; 

PHP einrichten¶

Die aktuelle Version von PHP ist die Version 7.4. Der Pfad zur php.ini ist dann /etc/php/7.4/apache2/php.ini . Hier kann die maximale Datei-Upload-Größe festgelegt werden, in diesem Beispiel 20 MB:

   upload_max_filesize = 20M

Grundkonfiguration¶

auf set up wiki klicken

Die MediaWiki-Installation setzt sich im Browser fort. Steht einem auf dem Server ein Browser zur Verfügung, so kann man einfach http://localhost/mediawiki aufrufen. Falls dies nicht möglich, weil zum Beispiel kein XServer vorhanden ist, so sollte es möglich sein, ihn an einem anderen Computer mit seiner IP-Adresse zu erreichen: http://IP_ADRESSE_DES_SERVERS/mediawiki

Einmalig muss das Setup durch Klick auf den Link "set up the wiki" durchgeführt werden.

Mit der Datenbank verbinden¶

Datenbankeinstellungen

Die zuvor erstellte Datenbank wikidb wird hier für MediaWiki eingerichtet.

Wie im Bildschirmfoto gezeigt, muss hier für Name der Datenbank die zuvor erstellte Datenbank genannt werden, in diesem Fall wikidb, und das Feld "Präfix der Datenbanktabelle" bleibt leer. Der "Name des Datenbanknutzers" ist analog wikiuser mit zugehörigem "Passwort des Datenbanknutzers".

Nach Klick auf "Weiter" wird man gefragt, ob man "dasselbe Datenbankkonto wie während des Installationsvorgangs verwenden" möchte. Dies ist der Fall.

LocalSettings.php¶

Hier muss gegebenenfalls die URL des Servers angepasst werden, in diesem Beispiel zu beispiel.de:

1

$wgServer = "http://beispiel.de";

Diese Datei muss noch ins Stammverzeichnis der MediaWiki-Installation kopiert werden:

Nach /etc/mediawiki/ (bei Installation aus den Paketquellen)

cd ~/Downloads/
sudo cp LocalSettings.php /etc/mediawiki/ 

oder nach /var/www/html/mediawiki/ (bei manueller Installation) kopiert werden:

cd ~/Downloads/
sudo cp LocalSettings.php /var/www/html/mediawiki/ 

Da hier auch die Anmeldedaten für die Datenbank hinterlegt sind, müssen der Benutzer und die Benutzergruppe sowie die Zugriffsrechte angepasst werden:

cd /var/www/html/mediawiki
sudo chown root:www-data LocalSettings.php
sudo chmod 440 LocalSettings.php 

Nun kann mit Klick auf enter your wiki das angelegte Wiki betreten werden. Darin wird das weitere Vorgehen beschrieben.

Administration über das Webinterface¶

Im Vergleich zu einem "normalem" Benutzerkonto hat das Administratorkonto wesentlich mehr Rechte. Meldet man sich als Administrator an und klickt auf den Link "Spezialseiten" auf der linken Seite, so sind einige Einträge fett geschrieben. Diese Funktionen stehen nur einem Administratorkonto zur Verfügung. Hierzu gehören:

• Nicht beobachtete Seiten

• Benutzer freigeben

• Benutzer sperren

• Gelöschte Beiträge

• Gelöschte Seiten anzeigen

• Inhaltsmodell einer Seite ändern

• Seiten importieren

• Versionsgeschichten vereinen

Sicherungen der Daten¶

Damit bei einem Defekt nicht alle Daten verloren gehen, müssen natürlich Sicherungen erfolgen. Hierzu müssen zwei Sachen gesichert werden:

• die Datenbank des Wikis

• Das Root-Verzeichnis des Wikis

Updates einspielen bei manueller Installation¶

Dieser Abschnitt soll sich nur mit dem Update einer LTS-Version befassen mit einem sogenannten Minor-Update. Möchte man auf eine neuere Version upgraden, sollte man sich folgende Seite anschauen: Manual Upgrading 🇬🇧.

Hier am Beispiel von Version 1.31.11 auf 1.31.12.

Zuerst wird ein Terminal geöffnet und die Datenbank gesichert:

mysqldump --user=wikiuser --password=wikidb_userpassword wikidb > BackupMediawiki.sql 

Nun geht man in das Verzeichnis tmp. Dort lädt man die aktuelle Version herunter, die anschließend entpackt wird.

cd /tmp
wget https://releases.wikimedia.org/mediawiki/1.31/mediawiki-1.31.12.tar.gz
tar -xzvf mediawiki-1.31.12.tar.gz
rm mediawiki-1.31.12.tar.gz
cd mediawiki-1.31.12/ 

Bei der Aktualisierung wird der Ordner images/ und die Datei LocalSettings.php von der alten Version übernommen.

rm -R images/
sudo cp -R /var/www/html/mediawiki/images/ ./
sudo cp /var/www/html/mediawiki/LocalSettings.php ./ 

Damit die neue Version die alte Version ersetzen kann, wird die alte Version in einen Backup-Ordner verschoben:

sudo mkdir /var/www/backup
sudo mv /var/www/html/mediawiki/ /var/www/html/backup/mediawiki27-02-2020 

Nun wird die neue Version dorthin kopiert:

cd /tmp/
sudo mv mediawiki-1.31.12/ /var/www/html/mediawiki 

Nun werden noch die Benutzer, Benutzergruppen und Zugriffsrechte angepasst:

cd /var/www/html/
sudo chown -R www-data:www-data mediawiki/
cd mediawiki/
sudo chown root:www-data LocalSettings.php
sudo chmod 440 LocalSettings.php 

Nun sollte die neue Version aufrufbar sein.

Erscheinungsbild¶

Viele Einstellungen für das Erscheinungsbild lassen sich in der Datei LocalSettings.php im Wurzelverzeichnis des Wikis tätigen. Unter anderem werden darüber Erweiterungen geladen.

Eine Übersicht aller Konfigurationseinstellungen findet sich hier 🇩🇪, ein Handbuch für die Datei LocalSettings.php gibt es auf dieser Seite 🇩🇪.

Erweiterungen¶

Mithilfe von Erweiterungen lassen sich das Erscheinungsbild und die Funktionsweise von MediaWiki erweitert anpassen. Diese werden von der MediaWiki-Seite heruntergeladen und in die lokale MediaWiki-Instanz integriert 🇩🇪. Eine Übersichtsseite mit weiterführenden Links gibt es hier 🇩🇪.

Neben bestehenden Erweiterungen 🇩🇪 können auch selbst entwickelte unkompliziert genutzt werden. Bei der Entwicklung kommt PHP zum Einsatz.