MediaWiki installieren

Mediawiki dürfte jedem von der Wikipedia her bekannt sein. Die meisten nutzen die Software, wenige aber wissen, wie diese funktioniert. Im Grunde schade, da die Mediawiki eine mächtige Software ist, die ihre Muskeln im Bereich der Dokumentenverwaltung spielen lässt. Auch viele kleine technische Projekte nutzen Mediawiki.

Ziel dieses Tutorials ist:

• Installieren der Mediawiki auf dem Webserver an der Konsole (ssh Zugriff)
• Grundlegende erste Schritte und einfache Anpassungen
• Erweiterung der Software um ein Mobile Frontend
• Umzug / Sicherung einer mySQL Datenbank

Voraussetzung ist ein Linux Webserver mit

• ssh Zugang
• Apache2 Webserver mit PHP und mySQL

Eine leere Datenbank anlegen

Zuerst benötigen wir eine neue leere mySQL Datenbank. Hierzu empfiehlt es sich, einen eigenen Datenbank-User (falls noch nicht geschehen) anzulegen. Gebt folgendes als Root ein:

sudo mysql -p

Danach an der Konsole folgende Befehle eingeben:

CREATE USER 'neueruser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON * . * TO 'neueruser'@'localhost';
FLUSH PRIVILEGES;
exit

SELECT user FROM mysql.user; (zeigt alle User der Datenbank)

neueruser: Das ist der Username für den mySQL Nutzer
password: Das ist sein Passwort
Bitte entsprechend anpassen!
Nun legen wir für den Nutzer noch eine neue Datenbank an:

mysqladmin -uneueruser -p create WIKIDB

Beachtet hier die Parameter -u und -p. Beim Parameter -u schreibt Euren Nutzernamen direkt dahinter.

Mediawiki downloaden, entpacken und vorbereiten

Wir laden nun die Software herunter. Dazu wechselt in das dafür vorgesehene Verzeichnis auf Eurem Server. Ich verwende jetzt einfach einmal das Standard Verzeichnis /var/www/ , Ihr könnt aber ein anderes beliebiges verwenden.

cd /var/www

Wir holen uns nun die Software. Unter dem Mediawiki Downloadbereich findet Ihr immer die aktuelle Version und den Downloadlink. Passt folgenden Befehl entsprechend der aktuellen Version an:

sudo wget http://releases.wikimedia.org/mediawiki/1.25/mediawiki-1.25.1.tar.gz

Entpackt wird das dann mit einem

sudo tar -zvxf mediawiki-1.25.1.tar.gz

Ihr habt jetzt ein neues Verzeichnis mediawiki-1.25.1. Je nach Geschmack lasst Ihr den Namen so, benennt das Verzeichnis um, oder setzt einen Symlink. Wer gerne mit Versionen experimentiert, wird wohl den Link verwenden, den er dann einfach von Version auf Version umhängt.
Variante umbenennen:

mv /var/www/mediawiki-1.25.1 /var/www/mediawiki

Variante Link: ln -s /var/www/mediawiki-1.25.1 /var/www/mediawiki Jetzt verschaffen wir noch einen Zugriff auf das Verzeichnis für unseren Apache Webserver:

chown -R root:www-data /var/www/mediawiki
chmod 750 -R /var/www/mediawiki

Und noch Schreibrechte für den Upload von Bildern (falls gewünscht):

chmod 770 -R /var/www/mediawiki/images

Apache 2 konfigurieren

Jetzt binden wir noch einen Alias in unsere Apache2 Konfiguration mit ein.

nano /etc/apache2/sites-enabled/@000-default

(Die Datei liegt in /etc/apache2/sites-available/000-default.conf)

Nachfolgend die Variante mit Alias wählen!
Im Bereich <VirtualHost *:80> und/oder <VirtualHost *:443> fügt folgenden Abschnitt mit ein:

Alias /mediawiki /var/www/mediawiki
     <Directory /var/www/mediawiki>
      Options FollowSymLinks
      AllowOverride All
      DirectoryIndex index.php index.htm index.html
      Order allow,deny
      allow from all
     </Directory>

Die Zeile Alias /mediawiki /var/www/mediawiki legt fest, dass Ihr Eure Wiki mittels EURE_WEB_ADRESSE/mediawiki aufrufen könnt. Das macht Sinn, wenn noch andere Webanwendungen auf dem Server liegen. Wollt Ihr, dass die Wiki direkt über Eure Adresse aufgerufen wird, dann könnt Ihr dies direkt im Abschnitt <VirtualHost *:80> regeln:

<VirtualHost *:80>
       ServerName EUER_SERVERNAME
       ServerAlias EUER_SERVERNAME XXX.XXX.XX.XX
       ServerAdmin webmaster@localhost

       DocumentRoot /var/www/mediawiki
       <Directory />
               Options FollowSymLinks
               AllowOverride All
       </Directory>
       <Directory /var/www/mediawiki>
        ...
                  
       </Directory>

Speichert die Änderung ab und startet den Apache neu durch:

/etc/init.d/apache2 restart

Mediawiki einrichten

Ruft nun Eure Mediawiki in Eurem Browser auf (wir gehen jetzt von der Variante /mediawiki aus, ansonsten einfach nur die Domäne aufrufen)
EUER_DOMÄNE/mediawiki
Wir bekommen sogleich folgenden Hinweis:

LocalSettings.php not found
Please set up the wiki first.

Klickt auf den angezeigten Link und wir können mit der Konfiguration beginnen. Stellt die gewünschte Sprache ein und klickt auf weiter...

de-Deutsch
de-Deutsch

Auf der folgenden Seite bekommt Ihr unter Umständen Hinweise zu falschen Serverkonfigurationen, oder falls eine Datei fehlen sollte. Wenn alles okay ist, geht auch hier auf weiter...

Im nächsten Dialog muss nun die Datenbank angebunden werden:

Datenbanksystem: MySQL
Datenbankserver: localhost
Datenbankname: WIKIDB (z.B.)
Benutzerkonto für die Datenbank. User und Passwort merken!

Danach folgen grundlegende Einstellungen zur Datenbank. Ich empfehle folgende:

Speicher-Engine: InnoDB
Datenbankzeichensatz: UTF-8

Danach legen wir unseren ersten Nutzer fest und wollen noch weitere Einstellungen vornehmen:

Name des Wiki
User, Passwort, E-Mail-Adresse
Ja, es sollen weitere Konfigurationseinstellungen vorgenommen werden.

Im dann folgenden Dialog können noch einige weitere Dinge festgelegt werden. Wichtig zumindest ist die Zugriffsberechtigung. Wollt Ihr, dass nur Ihr die Texte editieren könnt, dann empfiehlt sich folgende Einstellung:

Profil: ausschließlich berechtigte Benutzer

Prüft nach, ob die Einstellungen zu der E-Mail Adresse passen und aktiviert den Upload von Bildern, falls Ihr dies verwenden möchtet. Auch kann an der Stelle gleich ein anderes Logo festgelegt werden. Dies lässt sich aber im Nachgang auch noch ändern:

Das Hochladen von Dateien ermöglichen

Jetzt sind die Vorbereitungen erledigt. Klickt dann nochmal auf Weiter um die Installation zu beginnen.

Das war es. Es wird die LocalSettings.php heruntergeladen. Diese muss dann wieder auf Euren Server hochgeladen werden und in das /var/www/mediawiki Verzeichnis kopiert werden. Ihr könnt das auch manuell machen:

vi /var/www/mediawiki/LocalSettings.php

Öffnet die heruntergeladene Datei mit einem Texteditor (unter Windows am besten mit dem notepad++ und kopiert den Inhalt in vi. Mit der rechten Maustaste wird alles eingefügt.

Hinweis: Der vi Editor - Editmodus: Taste "i" drücken. Editmodus verlassen: "ESC" drücken. Speichern: Tasten ":w" und beenden mit Tasten ":q"

Danach noch den Besitzer neu setzen:

chown root:www-data /var/www/mediawiki/LocalSettings.php

Jetzt können wir unsere Wiki aufrufen und uns anmelden.

Mobile Frontend installieren

Das Mobile Frontend ist eine Erweiterung für die Mediawiki. Ist diese aktiviert bekommen Besucher mit einem mobilen Endgerät die Seite entsprechend angepasst angezeigt. Allerdings ist in der mobilen Ansicht keine Sidebar mit den Menüeinträgen vorhanden. Die Philosophie ist vielmehr die, dass der User beispielsweise über eine Suchmaschine auf den gesuchten Seiteninhalt stößt und dann eine angepasste Version der Seite angezeigt bekommt.
Um die Erweiterung zu installieren müsst Ihr in das Extensions Verzeichnis der Mediawiki wechseln:

cd /var/www/mediawiki/extensions

Ladet die Erweiterung herunter:

wget https://extdist.wmflabs.org/dist/extensions/MobileFrontend-REL1_25-c193468.tar.gz

Die aktuelle URL erhaltet Ihr hier: Mobile Frontend

Packt das Paket aus:

tar -xzf MobileFrontend-REL1_25-c193468.tar.gz

Setzt nun den Benutzer richtig: chown -R /var/www/mediawiki/extensions/MobileFrontend Nun müssen wir nur noch dem Wiki die neue Erweiterung bekannt machen. Dazu editieren wir die LocalSettings.php:

nano /var/www/mediawiki/LocalSettings.php

Fügt dort folgende Zeilen ein:

require_once "$IP/extensions/MobileFrontend/MobileFrontend.php";
$wgMFAutodetectMobileView = true;

Das war es auch schon. Wenn Ihr nun mit einem Smartphone Eure Seite aufruft, sollte die Mediawiki jetzt etwas anders aussehen.

https einrichten (nebst htaccess Schutz)

Wenn wir noch eine Verbindung über https zulassen wollen, müssen wir dem Apache https als Erweiterung beibringen. Wechselt dazu in Euer Root Home:

cd /root

Danach legen wir unser Serverzertifikat an:

openssl genrsa -out server.key 4096
openssl req -new -key server.key -out server.csr

Jetzt werdet Ihr einige Angaben abgefragt:

Country Name (Ländercode): = DE
State or Province Name (Bundesland): = zB Bayern
Locality Name, eg. City (Stadt): = zB Nuernberg
Organization Name (Firmenname): = hier irgendwas eingeben wie privat, zuhause etc.
Organizational Unit Name (Abteilung) = bleibt leer
Common Name, eg. YOUR Name: = Euer Servername
Email Adress: = eine E-Mail Adresse
A challenge password: = bleibt leer
An optional company name: = bleibt leer

Dann generieren wir das Zertifikat. Ich mache das gleich mal für 10 Jahre, dann ist Ruhe:

openssl x509 -req -days 3650 -in server.csr -signkey server.key -out server.crt

Noch ein paar Rechte festlegen:

chmod 400 server.key

Jetzt müssen wir noch ein paar Änderungen in einigen Apache Konfigurationsdateien vornehmen:

nano /etc/apache2/sites-enabled/000-default

Am Ende der Konfigurationsdatei ergänzt folgende neue Sektion:

<VirtualHost *:443>
    DocumentRoot /var/www
    ServerName EUER_SERVERNAME
    SSLEngine on
    SSLCertificateFile /root/server.crt
    SSLCertificateKeyFile /root/server.key

  Alias /mediawiki /var/www/mediawiki
     <Directory /var/www/mediawiki>
      Options FollowSymLinks
      AllowOverride All
      DirectoryIndex index.php index.htm index.html
      Order allow,deny
      allow from all
   </Directory>

</VirtualHost>

EUER_SERVERNAME muss noch entsprechend eingetragen werden. Speichert die Änderung und editiert die ports.conf

nano /etc/apache2/ports.conf

und fügt ganz zum Schluss folgende Zeile ein:

NameVirtualHost *:443

Nun aktivieren wir das SSL Modul:

a2enmod ssl

Der Apache muss jetzt neu gestartet werden:

/etc/init.d/apache2 restart

Beachtet, dass das natürlich kein gekauftes Zertifikat ist. Euer Browser wird hier eine entsprechende Warnmeldung bringen. Aber Ihr wisst damit, warum diese Meldung kommt.

Wenn Ihr generell auf https umleiten wollt, auch wenn die Adresse über http abgerufen wird, müsst Ihr im Apache das Modul Rewrite aktivieren:

a2enmod rewrite
/etc/init.d/apache2 restart

Editiert die .htaccess:

nano /var/www/mediawiki/.htaccess

Fügt direkt unter RewriteEngine on diese Zeilen ein:

RewriteCond %{HTTPS} off
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

Nun werden sämtliche Anfragen auf das verschlüsselte https Protokoll umgeleitet.

Zu guter Letzt wollen wir generell verhindern, dass man von außen einfach einen Zugriff auf das Login der Owncloud bekommt. Wir blockieren das deshalb mit .htaccess und aktivieren eine darüberliegende Passwortabfrage.
Fügt deshalb in der .htaccess noch folgendes oben ein:

AuthType Basic
AuthName mediawiki
AuthUserFile /var/www/mediawiki/.htpasswd
require valid-user

Ihr seht, dass der Pfad zu dem dann erzeugtem Passwort im Dokumentenroot der Webanwendung liegt. Um das einwenig sicher zu machen, könnt Ihr durchaus dieses in ein anderes Verzeichnis legen, das außerhalb des Dokumentenroot liegt.

Das Passwort legt Ihr dann in diesem Verzeichnis (mittels cd dorthin wechseln!) mit einem

htpasswd -c .htpasswd username

an. Beim Befehl den Usernamen entsprechend Euren Vorstellungen ändern! Jetzt werdet Ihr zusätzlich nach einem Passwort gefragt.

Mediawiki updaten

Bevor Ihr Euere Mediawiki updatet, sichert Eure Datenbank und macht am besten eine Kopie Eures mediawiki Verzeichnisses. Dann ladet einfach das aktuelle Installationspaket herunter, entpackt den Tarball und kopiert diesen über Eure Installation. Passt dann wie in dem Tutorial hier beschrieben die Zugriffsberechtigungen an. Danach wechselt auf der Konsole in das maintenance Verzeichnis und führt das Update aus:

php update.php

Nach dem Update prüft die Datenbank auf Fehler:

mysqlcheck -hlocalhost -uDB_USER -pPASSWORT Datenbankname

Sollte es Fehler anzeigen, dann versucht diese mittels folgenden Befehl zu reparieren:

mysqlcheck -hlocalhost -uDB_USER -pPASSWORT Datenbankname --auto-repair

Danach sollte die Anwendung wieder sauber auf die Datenbank zugreifen können.

https://www.gargi.org/index.php?title=Mediawiki_installieren_und_nutzen