Manual:Installing MediaWiki/de

MediaWiki installiert sich selbst, indem es ein interaktives webbasiertes Installationsskript verwendet. Bevor Sie dieses Installationsskript starten können, müssen Sie einige Dinge erledigen. Versichern Sie sich, dass Sie Apache, PHP und MySQL installiert haben. Dann müssen Sie das MediaWiki Softwarepaket herunterladen und die MediaWiki-Software auf Ihren Server hochladen. Sie müssen auch eine neue Datenbank für Ihr Wiki erstellen. Wenn erforderlich, richten Sie ein Konto auf Ihrem Webserver ein, indem Sie den Instruktionen der Installationsanweisung folgen.

Die Installation von MediaWiki kann für den durchschnittlichen Computeranwender schwierig werden, der keine Erfahrung mit Apache, PHP und MySQL hat. Die meisten Anwender, die Wiki-Software nutzen möchten, profitieren von der Anwendung eines freien Wiki-Hosts (siehe auch Liste von Wiki-Hosts unter WikiBooks).

Für Informationen über mögliche Fehler, siehe Handbuch: Installationsfehler und Symptome

Herunterladen der MediaWiki-Software
Laden Sie MediaWiki von der offiziellen Download-Site oder über "Subversion" (Software zur Versionskontrolle) herunter. 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

Sollten Sie die Dateien noch nicht auf Ihren Server hochgeladen haben, laden sie diese Dateien auf den Server hoch, indem sie ein FTP-Programm wie z.B. FileZilla (quelltextoffene Software, Windows, Linux) oder Cyberduck(OSX) verwenden. Wenn Sie Apache installiert haben, wird das korrekte Verzeichnis in der Datei httpd.conf angegeben. Wenn Sie Linux oder Unix verwenden, können Sie stattdessen die Dateien in irgendein Verzeichnis auf Ihrem Server kopieren und dann eine Symbolische Verknüpfung von Ihrem Webserver zu dieser Datei erstellen.

Vorbereiten der Dateiverzeichnisse
MediaWiki muss in der Lage sein, in das Verzeichnis "mw-config" zu schreiben, während das Installationsprogramm läuft. Wenn Sie das noch nicht getan haben, so müssen Sie jetzt die Zugriffsrechte für das Unterverzeichnis "mw-config" so ändern, dass es für den Webserver beschreibbar wird.

FileZilla
Wenn Sie FileZilla benutzen, klicken Sie mit der rechten Maustaste auf das Verzeichnis "mw-config", wählen Sie "Attribute" aus und setzen "Schreiben" unter "Eigentümer". Wenn Sie stattdessen aufgefordert werden, eine Kennzahl einzugeben, oder wenn Sie eine Kommandozeilen-Schnittstelle benutzen, geben Sie die Zahl 755 (unter Linux geben Sie 777 an, nicht bei Red Hat Linux). Alternativ können Sie die Zugriffsrechte mit einem "control panel", welches durch Ihren Web-Datenbankbetreiber bereitgestellt wird, verändern.

Abhängig von der Serverkonfiguration müssen Sie in einigen Fällen alle Einstellungen (777) in FileZilla auswählen, damit das Installationsgrogramm von MediaWiki laufen kann.

Linux oder Unix
Normalerweise reicht es, wenn der Webserver Zugriff auf das Verzeichnis "mw-config" bekommt. Dazu muss man wissen, wie User heißt, unter dem der Webserver läuft. Bei Apache könnte das "wwwrun" oder "www-data" sein.

chown www-data mw-config

Das reicht im Normalfalls schon.

Alternativ kann man auch (wie unter FileZilla beschrieben) das Verzeichnis auf die Rechte 777 setzen. Das sollte man nach der Installation aber auf jeden Fall ändern, weil diese Einstellung unsicher ist.

chmod 777 mw-config

Die Rechte 755 reichen nur aus, wenn Eigentümer des Verzeichnis "config" und Benutzer des Webservers identisch sind.

Erstellen Sie eine Datenbank
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 MySQL oder Postgres benutzen, um die aktuellen Inhalte des Wikis zu speichern.

MySQL
create database wikidb; grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'localhost' identified by 'password'; flush privileges; \q Wenn Ihre Datenbank nicht auf dem gleichen Server wie Ihr Webserver läuft, müssen Sie den zugehörigen Webserverhostnamen eingeben, wie dies - in meinem Beispiel mediawiki.example.com - folgt: grant index, create, select, insert, update, delete, alter, lock tables on wikidb.* to 'wikiuser'@'mediawiki.example.com' identified by 'password';
 * Vor der Installation von MediaWiki müssen Sie eine MySQL-Datenbank erzeugen und einen Benutzer einrichten. Sie können dies tun, indem Sie Systemsteuerungen wie z.B. PhpMyAdmin benutzen, die häufig bei freigegebenen Hosts verfügbar sind. Im anderen Fall können Sie ssh (Netzwerkprotokoll) nutzen um sich in Ihrem Host anzumelden und die Befehle in einer MySQL-Eingabeaufforderung einzugeben. Schauen Sie sich die entsprechende Dokumentation an. Alternativ setzen Sie sich mit Ihrem Host-Provider in Verbindung, damit dieser ein Benutzerkonto für Sie einrichten kann.
 * Laden Sie MySQL5.0 herunter und installieren Sie es. Es sollte sich selbst einrichten in /usr/local/mysql.
 * Prüfen Sie ob der Datenbankserver läuft mit dem Befehl /usr/local/mysql/bin/mysqladmin status; wenn nicht benutzen Sie den Befehl sudo/usr/local/mysql/bin/safe_mysqld & (bei Fedora Core 5 wenden Sie an /usr/bin/mysqld_safe).
 * Eine andere Möglichkeit anfänglich den Datenbankserver zu starten ist das configure script zu starten, das am Ursprung der Installation verfügbar ist. Dieses erzeugt die ursprünglichen Tabellen und startet automatisch den mysql daemon (Dienstprogramm).
 * Legen Sie ein root-Passwort auf Ihrem Datenbankserver an mit dem Befehl /usr/local/mysql/bin/mysqladmin -u root password yourpassword
 * Legen Sie ein Passwort in MySQL für Ihr Wiki an - geben Sie folgenden Befehl in Ihren Computer ein: /usr/local/mysql/bin/mysql -u root -p mysql
 * Dieser startet die Eingabeaufforderung für Clients von MySQL. Geben Sie folgenden Befehl für den Client ein:

Postgres
Sofern Sie Postgres einsetzen, müssen Sie entweder eine Datenbank und einen Benutzer für sich erzeugt haben, oder Sie statten in der Konfiguration den Namen eines Postgresbenutzers mit "superuser"-Privilegien aus. Dieser Datenbankbenutzer wird häufig postgres genannt. Auf der Datenbank, die MediaWiki verwenden soll, müssen sowohl plpgsql als auch tsearch2 installiert sein. tsearch2 wird verwendet für die Suche nach Text in Ihrem wiki. Das Installationsprogramm wird versuchen plpgsql zu installieren, aber Sie werden tsearch2 selbst installieren müssen. Hier ist ein Weg dargestellt, wie das Meiste vom Setup erledigt wird. Dies gilt für ein unixähnliches System und es wird vorausgesetzt, dass Sie bereits die plpgsql- und tsearch2-Module installiert haben.

In diesem Beispiel werden wir eine Datenbank erstellen namens wikidb, 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 (then enter the password) createdb -O wikiuser wikidb createlang plpgsql wikidb

Das Hinzufügen von tsearch2 zu Ihrer Datenbank ist kein einfacher Schritt. Dieser wird hoffentlich für Sie bereits erledigt sein durch irgendwelche Verpackungsverfahren, die das tsearch2-Module installiert haben.

Die oben dargestellten Schritte sind nicht alle notwendig, da der Installateur versuchen wird einige von ihnen zu erledigen, wenn er mit Superusernamen und Passwort ausgestattet wird.

Für die Installation von tsearch2 zu Ihrer wikidb-Datenbank unter Windows führen Sie die folgenden Schritte aus: Das ist Alles!
 * 1) Suchen Sie tsearch2.sql (befindet sich vermutlich unter .\PostgreSQL\8.x\share\contrib) und kopieren dieses in das Verzeichnis postgresql\8.x\bin
 * 2) Geben Sie in die Kommandozeile im Verzeichnis postgresql\8.x\bin den Befehl psql wikidb < tsearch2.sql -U wikiuser ein.
 * 3) Dieser Befehl wird Sie nach dem Passwort für wikiuser auffordern.

Punkt 2. scheint nur unter Windows zu funktionieren, da unter Debian-Linux 4.0 (etch) nur dem Anwender von postgres erlaubt ist die Sprache C zu benutzen. So muss es da heißen:

su - postgres -c psql wikidb < tsearch2.sql

Hernach müssen Sie Wiki-Benutzern ausgewählte Rechte für die Tabellen von tsearch2 gewähren und den genauen Ort einfügen:

su - postgres psql -d wikidb -c "grant select on pg_ts_config to wikiuser;" psql -d wikidb -c "grant select on pg_ts_config_map to wikiuser;" psql -d wikidb -c "grant select on pg_ts_dict to wikiuser;" psql -d wikidb -c "grant select on pg_ts_parser to wikiuser;" psql -d wikidb -c "update pg_ts_config set locale = current_setting('lc_collate') where ts_name = 'default' and prs_name='default';"

Wenn Sie eine Fehlermeldung ähnlich wie "ERROR: relation "pg_ts_cfg" does not exist" erhalten, während die obenstehenden Anweisungen ausgeführt werden, versuchen Sie tsearch2 nochmal zur Datenbank wikidb zu installieren. Doch statt den obengenannten Anweisungen führen Sie die folgenden 2 getrennten Schritte aus:

1) su - postgres 2) psql wikidb -f tsearch2.sql

Dann führen Sie die obengenannten Anweisungen für die Gewährung der Rechte erneut aus.

Das Installationsprogramm ablaufen lassen
Sobald alle oben genannten Schritte durchgeführt sind, können Sie die Installation in einem Webbrowser beenden. Hierzu rufen Sie in Ihrem Webbrowser die Seite auf, unter der Ihr Wiki zu erreichen ist. Z.B. www.webseite.de/wiki. Dort wird der konkrete Installationsprozess zu Ende geführt. Einzelheiten siehe im Handbuch: Konfigurationsanweisungen.