Handbuch:Installation von MediaWiki

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Installing MediaWiki and the translation is 98% complete.
Outdated translations are marked like this.
MediaWiki-2020-icon.svg Handbuch:Installationsanleitung About MediaWiki
Help-browser.svg Features Installation requirements
Preferences-system.svg Downloading Installing Configuring


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.

Für Informationen über mögliche Fehler siehe Manual:Errors and Symptoms#Installation Errors

Herunterladen der MediaWiki-Software

Web-Browser

Laden Sie die tar-Datei zu MediaWiki von der offiziellen Download-Seite herunter. Generell gilt: Wenn Sie eine Produktionsumgebung verwenden, sollten Sie die letzte stabile Version verwenden, also mediawiki-1.36.1.tar.gz.

Kommando-Zeile (*nix machine)

Um MediaWiki 1.36.1, die letzte stabile Version, auf einen *nix-Rechner herunterzuladen, kann der folgende Befehl verwendet werden:

wget https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.1.tar.gz

Alternativ können Sie cURL benutzen.

curl -O https://releases.wikimedia.org/mediawiki/1.36/mediawiki-1.36.1.tar.gz

Die heruntergeladenen Dateien liegen im .tar.gz-Format vor, sodass sie vor der Verwendung entpackt werden müssen. Entpacken Sie die Dateien lokal oder auf Ihrem 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 können Sie die Datei entpacken (untar), indem Sie folgenden Befehl anwenden:

tar xvzf mediawiki-*.tar.gz
Wenn Sie das Archiv als root:# dekomprimieren, sollten Sie den Eigentümer der Dateien möglicherweise danach mit chown ändern, sonst werden die Dateien unter dem Benutzer # 1000 (root) geführt, was möglicherweise nicht das ist, was Sie wollen.

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 Composer installieren.

Dateien auf den Server hochladen

Wenn Sie die Dateien noch nicht auf Ihren Webserver hochgeladen haben, tun Sie dies jetzt.

Laden Sie die Dateien in das Webverzeichnis Ihres Webservers hoch, in dem Sie entweder:

  1. das entpackte Verzeichnis direkt kopieren oder
  2. einen FTP-Clienten wie FileZilla (Open Source Software, Windows, OSX und Linux) oder Cyberduck (OSX) nutzen.
  3. by using cPanel File Manager (see below)

Wenn Ihr Kopier- oder FTP-Programm eine Option zur Umwandlung des Dateinamens in Kleinbuchstaben hat (change file names to lowercase), müssen Sie diese ausschalten.

Wenn Sie Apache installiert haben, steht das korrekte Verzeichnis in Ihrer httpd.conf-Datei (es ist die DocumentRoot-Richtlinie, normalerweise /var/www/ oder <apache-folder>/htdocs). 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 /etc/apache2/apache2.conf ist.

Wenn Sie einen Linux- oder Unix-Server benutzen, können Sie stattdessen die Dateien in ein beliebiges Verzeichnis des Servers kopieren und dann einen symbolischen Link zu diesem Ordner im Web-Verzeichnis Ihres Servers erstellen.

Benennen Sie den hochgeladenen Ordner (oder den symbolischen Link) so um, wie Sie ihn in der URL haben wollen. Wenn Ihr Web-Server z. B. wie http://localhost läuft, würde eine Umbenennung zu einem /w/-Verzeichnis bedeuten, dass Sie Ihr Wiki über http://localhost/w/index.php erreichen. Benutzen Sie nicht /wiki/, wenn Sie es als einen Kurzlink benutzen möchten. (Und richten Sie Kurzlinks nicht ein, bis Sie das Installationsskript gestartet haben.)

Merken Sie sich, dass in bestimmten Fällen, wie wenn ein lokales verwaltetes Verzeichnis (Repository) mit Git eingerichtet ist, der Server möglicherweise nach dem Aufrufen des index.php die Fehlermeldung "500 Internal server Error ("500 Interner Serverfehler")" zeigt. Dies ist möglicherweise ein Berechtigungsfehler, welcher durch das Ändern der Datei- und Verzeichnisberechtigungen behoben werden kann, indem man den folgenden Befehl in SSH nach dem Ändern des Verzeichnis zu "w" ausführt:
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

Dieser (umbenannte) Ordner wird nun als <MediaWiki-folder> 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.

  • Wechseln Sie in das Verzeichnis, in dem Sie Ihren Wiki-Ordner anlegen möchten.
  • Laden Sie die Datei mediawiki-1.xx.x.tar.gz hoch. Möglicherweise müssen Sie "Neu laden" klicken, um ihn zu sehen.
  • Entpacken Sie die Datei mediawiki-1.xx.x.tar.gz. Noch einmal „Neu laden“.
  • Überprüfen Sie, ob der Ordner mediawiki-1.xx.x vorhanden ist.
  • Löschen Sie die Datei tar.gz.
  • Den Ordner „mediawiki-1.xx.x“ in „w“ umbenennen.

Eine Datenbank erstellen

Sofern Sie das root-Passwort in Ihrer Datenbank kennen, kann das Installationsprogramm von MediaWiki eine Datenbank für Sie erstellen. Sollte das der Fall sein, springen Sie im Text zum Abschnitt „Das Installationsprogramm ablaufen lassen“ weiter unten auf dieser Seite. Wenn Sie das root-Passwort nicht kennen, z. B. wenn Sie auf einem gemieteten Server sind, müssen Sie eine neue Datenbank erzeugen. Derzeit müssen Sie entweder MariaDB/MySQL oder Postgres benutzen, um die aktuellen Inhalte des Wikis zu speichern. Wenn Sie sich nicht sicher sind, welche Datenbank Sie auswählen sollen, benutzen Sie MariaDB, da dies 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 pdo-sqlite-Modul hat, wird keine weitere Einrichtung benötigt.

Auf der Installationsseite müssen Sie einen Datenbanknamen (welcher alles sein kann) und das SQLite-Datenbankverzeichnis angeben. Wenn Ihre Datenbank nicht auf dem gleichen Server wie Ihr Webserver läuft, müssen Sie den zugehörigen Webserverhostnamen — im folgenden Beispiel mediawiki.example.com — wie folgt eingeben: Wenn dieses Verzeichnis nicht sicher ist (z. B. für das Web lesbar), dann sollten Sie es manuell ändern, damit es nicht für das gesamte Web zugänglich ist.

MariaDB/MySQL

MediaWiki wird Sie nach der Datenbank und dem Benutzernamen fragen und versuchen, diese zu erstellen, falls sie noch nicht vorhanden sind. Wenn das von MediaWiki aus nicht möglich ist, können Sie verschiedene Control Panels wie PhpMyAdmin verwenden, die oft von Shared-Hosts zur Verfügung gestellt werden oder Sie können sich mit ssh bei Ihrem Hoster anmelden und die Befehle in eine MySQL-Eingabezeile eingeben. Bitte lesen Sie die entsprechende Dokumentation. Alternativ kann auch der Host-Provider ein Konto für Sie einrichten.

CREATE DATABASE wikidb;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;

Wenn Ihre Datenbank nicht auf dem gleichen Server wie Ihr Webserver läuft, müssen Sie den zugehörigen Webserverhostnamen – im folgenden Beispiel mediawiki.example.com – wie folgt eingeben:

GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'password';
Warning Warning: MySQL/MariaDB unter UNIX/Linux protokolliert alle Abfragen, die an die Datenbank gesendet werden, in einer Datei, die auch das Passwort enthält, das für das Benutzerkonto verwendet wird. Wenn Sie Bedenken haben, löschen Sie Ihre .mysql_history-Datei, nachdem Sie diese Abfragen ausgeführt haben. Diese Datei befindet sich in Ihrem Home-Verzeichnis (~/.mysql_history).


PostgreSQL

Wenn Sie PostgreSQL verwenden, müssen Sie entweder eine Datenbank und einen Benutzer für sich anlegen 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 Sie die meisten Einstellungen vornehmen können. 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ühren Sie - wie der Benutzer - die folgenden Schritte auf der Kommandozeile aus:

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

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

CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'password';
CREATE DATABASE wikidb WITH OWNER wikiuser;

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 Manual: Konfigurations-Skript beschriebenen Anweisungen beachten.

Das Installationsprogramm fordert Sie auf, die Datei LocalSettings.php herunterzuladen und diese unter dem Namen LocalSettings.php-path zu speichern.

Alternativ können Sie das Installationsprogramm über die Befehlszeile ausführen: php maintenance/install.php, wobei die entsprechenden Konfigurationsparameter hinzugefügt werden müssen.

Nächste Schritte

Diese sind zwar optional, lassen Ihre Website aber viel besser wirken.

Auf dem Laufenden bleiben

Abonnieren Sie unsere Mailingliste über Mitteilungen zu Versionsankündigungen.

Nach der Installation stellen Sie sicher, dass Sie mit den Versionen auf dem neuesten Stand bleiben und halten Sie Ihren Server sicher!

Hilfestellung bei der Installation

Siehe auch