Manual:Installing MediaWiki/de

MediaWiki installiert sich selbst, indem es ein interaktives webbasiertes Installationsskript verwendet. Bevor dieses Script ausgeführt werden kann, müssen einige Dinge erledigt werden: siehe Voraussetzungen oder Kurzanleitung zur Installation für Experten.

Die Installation von MediaWiki kann für den durchschnittlichen Computeranwender schwierig werden, der keine Erfahrung mit Apache, PHP und MySQL/MariaDB hat. Die meisten Benutzer, die eine Wiki-Software verwenden möchten, können von der Verwendung eines freien MediaWiki-Servers oder über ein Software-Bundle profitieren.

Web-Browser
Lade die MediaWiki tar-Datei von der offiziellen Download-Seite herunter. Wenn du eine Produktionsumgebung verwendest, sollte man in der Regel die aktuellste stabile Version (mediawiki-.tar.gz) einsetzen.

Kommando-Zeile (*nix machine)
Um MediaWiki, die letzte stabile Version, auf einen *nix-Rechner herunterzuladen, kann der folgende Befehl verwendet werden:

Alternativ kannst du cURL benutzen.

Die heruntergeladenen Dateien liegen im -Format vor, sodass sie vor der Verwendung entpackt werden müssen. Entpacke die Dateien lokal oder auf deinem Server. Unter Windows werden dafür gewöhnlich Programme wie 7-Zip (quelltextoffene Software), WinZip, WinRAR oder IZArc benutzt. Unter Linux und Mac OS X kannst du die Datei entpacken (untar), indem du folgenden Befehl anwendest:

tar -xf mediawiki-*.tar.gz

Git (für Entwickler)
Entwickler hingegen sollten besser von Git herunterladen, um ein lokales Repository mit dem neuesten Code in der Entwicklungsumgebung einzurichten.

Sie müssen auch Abhängigkeiten manuell über installieren.

Dateien auf den Server hochladen
Wenn du die Dateien noch nicht auf deinen Webserver hochgeladen hast, tu dies jetzt.

Lade die Dateien in das Webverzeichnis deines Webservers hoch, in dem du entweder:


 * 1) das entpackte Verzeichnis direkt kopierst oder
 * 2) einen FTP-Clienten wie FileZilla (Open Source Software, Windows, OSX und Linux) oder Cyberduck (OSX) nutzt.
 * 3) cPanel File Manager benutzt (siehe unten)

Wenn dein Kopier- oder FTP-Programm eine Option zur Umwandlung des Dateinamens in Kleinbuchstaben hat (change file names to lowercase), musst du diese ausschalten.

Wenn du Apache installiert hast, steht das korrekte Verzeichnis in deiner -Datei (es ist die DocumentRoot-Richtlinie, normalerweise   oder ). Hinweis: Dies änderte sich in Ubuntu 14.04 mit Apache 2.4.7, wo die ursprüngliche Konfigurationsdatei für Apache-Server-Einstellungen und -Verzeichnisse  ist.

Wenn du einen Linux- oder Unix-Server benutzt, kannst du stattdessen die Dateien in ein beliebiges Verzeichnis des Servers kopieren und dann einen symbolischen Link zu diesem Ordner im Web-Verzeichnis Ihres Servers erstellen.

Benenne den hochgeladenen Ordner (oder den symbolischen Link) so um, wie du ihn in der URL haben willst. Wenn dein Web-Server z. B. wie  läuft, würde eine Umbenennung zu einem  -Verzeichnis bedeuten, dass du dein Wiki über   erreichst. Benutze nicht, wenn du es als einen Kurzlink benutzen möchtest. (Und richte Kurzlinks nicht ein, bis du das Installationsskript gestartet hast.)

Dieser (umbenannte) Ordner wird nun als  bezeichnet.

cPanel Datei-Manager
cPanel ist ein beliebtes Administrationstool, das von vielen Webhostern verwendet wird. Diese Methode ist sehr effizient, da die Dateien auf dem Server selbst entpackt werden.


 * Wechsle in das Verzeichnis, in dem du deinen Wiki-Ordner haben möchtest.
 * Lade die Datei mediawiki-1.xx.x.tar.gz hoch. Möglicherweise musst du „Neu laden“ anklicken, um ihn zu sehen.
 * Entpacke die Datei mediawiki-1.xx.x.tar.gz. Noch einmal „Neu laden“.
 * Überprüfe, ob der Ordner mediawiki-1.xx.x vorhanden ist.
 * Lösche die Datei tar.gz.
 * Den Ordner „mediawiki-1.xx.x“ in „w“ umbenennen.

Eine Datenbank erstellen
Sofern du das root-Passwort deiner Datenbank kennst, kann das Installationsprogramm von MediaWiki eine Datenbank für dich erstellen. Sollte das der Fall sein, springe im Text zum Abschnitt „Das Installationsprogramm ablaufen lassen“ weiter unten auf dieser Seite. Wenn du das root-Passwort nicht kennst, z. B. wenn du auf einem gemieteten Server bist, musst du eine neue Datenbank erzeugen. Derzeit musst du entweder MariaDB/MySQL oder Postgres benutzen, um die aktuellen Inhalte des Wikis zu speichern. Wenn du dir nicht sicher bist, welche Datenbank du auswählen sollst, benutze MariaDB, da diese am besten von MediaWiki unterstützt wird.

SQLite
SQLite ist eine eigenständige Datenbankbibliothek, die die Datenbankinhalte in einer einzigen Datei speichert. Wenn PHP das -Modul hat, wird keine weitere Einrichtung benötigt.

Auf der Installationsseite musst du einen Datenbanknamen (ein frei wählbarer Name) und das SQLite-Datenbankverzeichnis auswählen. Für das Datenbankverzeichnis versucht das Installationsprogramm, ein Unterverzeichnis außerhalb des Dokument-Root-Verzeichnisses zu benutzen und erstellt es bei Bedarf. Wenn dieses Verzeichnis nicht sicher ist (z. B. für das Web lesbar), dann solltest du es manuell ändern, damit es nicht für das gesamte Web zugänglich ist.

MariaDB/MySQL
MediaWiki wird dich nach der Datenbank und dem Benutzernamen fragen und versuchen, diese zu erstellen, wenn sie noch nicht vorhanden sind. Wenn das von MediaWiki aus nicht möglich ist, kann man das mit verschiedenen Control-Panels wie PhpMyAdmin machen, die oft bei den Shared-Hosts verfügbar sind oder man kann sich mit ssh bei seinem Hoster anmelden und die Befehle in eine MySQL-Eingabezeile eingeben. Siehe die entsprechende Dokumentation. Alternativ kann auch der Host-Provider ein Konto für dich einrichten.

Wenn deine Datenbank nicht auf dem gleichen Server wie dein Webserver läuft, musst du den zugehörigen Webserverhostnamen – im folgenden Beispiel mediawiki.example.com – wie folgt eingeben:

PostgreSQL
Wenn du PostgreSQL verwendest, musst du entweder eine Datenbank und einen Benutzer für dich erstellen lassen oder einfach den Namen eines PostgreSQL-Benutzers mit „Superuser“-Rechten in das Konfigurationsformular eingeben. Dieser Datenbankbenutzer wird häufig postgres genannt.

Hier folgt eine Anleitung, wie du den größten Teil der Einstellungen vornehmen kannst. Dies gilt für ein unixähnliches System. In diesem Beispiel werden wir eine Datenbank namens wikidb erstellen, die einem Benutzer namens wikiuser gehört. Führe – wie der Benutzer – die folgenden Schritte auf der Kommandozeile aus:

createuser -S -D -R -P -E wikiuser (gib dann das Passwort ein) createdb -O wikiuser wikidb

oder du gibst, als Superuser (standardmäßig „postgres“), die folgenden Befehle in die Datenbank-Eingabezeile ein:

Achtung: die Liste bekannter Probleme beim Betrieb von MediaWiki mit PostgreSQL sollte beachtet werden.

Das Installationsskript ausführen
Wenn alle oben genannten Schritte abgeschlossen sind, kann die Installation über einen Webbrowser abgeschlossen werden, indem die URL der index.php im Browser aufgerufen wird – bitte die in beschriebenen Anweisungen beachten.

Das Installationsprogramm fordert dich auf, die Datei herunterzuladen und diese unter dem Namen  zu speichern.

Alternativ kann das Installationsprogramm über die Befehlszeile ausgeführt werden:, wobei die entsprechenden Konfigurationsparameter hinzugefügt werden müssen.

Nächste Schritte
Diese sind zwar optional, lassen deine Website aber viel besser wirken.



Auf dem Laufenden bleiben
Abonniere unsere Mailingliste über Mitteilungen zu Versionsankündigungen.

Einmal installiert, sollte man immer auf dem Laufenden bleiben, was die neuen Versionen angeht, und seinen Server entsprechend schützen!

Hilfestellung bei der Installation

 * Lese die FAQ zur Installation und Konfiguration
 * Chatten mit MediaWiki-Entwicklern, Systemadministratoren und Benutzern:
 * Die Mailingliste mediawiki-l ist eine stark frequentierte Liste, auf der du um Unterstützung bitten kannst

Siehe auch

 * - listet die Wiki-Seiten auf, welche die MediaWiki-Meldungen verlinken. Dazu müssen diese Seiten erstellt oder die Meldungen bearbeitet werden.
 * - Links zu erweiterten Konfigurationseinstellungen.
 * - um eine bessere und benutzerfreundlichere URL zu den Artikelseiten zu erreichen.
 * - um mehrere Instanzen von MediaWiki mit einem einzigen Set von MediaWiki-Dateien einzurichten.