Manual talk:Installing MediaWiki/LQT Archive 1

Moving a DB
Hi,

I would like to move a previous installation of mediawiki + postgresql from a mac osx system to a linux/Ubuntu system. What are the steps that I should follow?

MySQL Installation Instructions Unclear
"If you know the root password on your database, the MediaWiki installation script can create a new database for you." Huh? How can one "know" or use a password for a database that hasn't yet been created?

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, daß Sie Apache, PHP und MySQL installiert haben. Dann müssen Sie sich das MediaWiki Softwarepaket beschaffen 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 schwierig sein für den durchschnittlichen Computeranwender, 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 Fehlersuche siehe Handbuch: Installationsfehler und Symptome

Herunterladen von 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. Dies wird gewöhnlich ausgeführt mit Programmen wie 7-zip (quelltextoffene Software), WinZip, WinRar oder IZArc unter Windows. 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 die Dateien noch nicht auf Ihren Server hochgeladen haben, tun Sie das jetzt. Laden Sie die Dateien in ein Verzeichnis auf Ihrem Webserver hoch, indem Sie einen FTP-Client wie z.B. FileZilla (quelltextoffene Software, Windows) 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 irgend ein Verzeichnis auf Ihrem Server kopieren und dann eine Symbolische Verknüpfung von Ihrem Webserver zu dieser Datei erstellen.

Vorbereiten der Dateiverzeichnisse
MediaWiki muß in der Lage in das Verzeichnis config zu schreiben, wenn das Installationsprogramm läuft. Wenn Sie das noch nicht getan haben, so müssen Sie jetzt die Zulassungseinstellungen für das Unterverzeichnis config so ändern, daß es für den Webserver beschreibbar wird. Wenn Sie FileZilla benutzen, klicken Sie mit der rechten Maustaste auf das Verzeichnis config, wählen Sie "Attribute" aus und prüfen "Schreiben" unter "Eigentümer" aus. Wenn es Sie stattdessen nach einer Kennzahl auffordert oder wenn Sie eine Kommandozeilen-Schnittstelle benutzen, nennen Sie die Ziffer 755 (unter Linux geben Sie 756 an, nicht bei Red Hat Linux). Alternativ können Sie die Zulassungs-Einstellungen mit einem "control panel", welches durch Ihren Web-Datenbankbetreiber bereigestellt wird, verändern.

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

Wenn Sie Administrationsrechte haben, können Sie unter Unix oder Linux den Befehl chmod 755 config in Ihrem wiki-Verzeichnis ausführen lassen.

Erstellen Sie eine Datenbank
Wenn Sie das root-Paßwort in Ihrer Datenbank kennen, kann das Installationsprogramm von MediaWiki eine Datenbank für Sie erstellen. Wenn dies der Fall ist, springen Sie im Text zum Abschnitt "Das Installationsprogramm ablaufen lassen" weiter unten auf dieser Seite. Wenn Sie das root-Paßwort 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 von wiki zu speichern.

MySQL
create database wikidb; grant 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 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-Paßwort 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 Clienten von MySQL. Geben Sie folgenden Befehl für den Clienten ein:

Postgres
Wenn 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, daß 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 Verpackungs- verfahren, 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 Paßwort 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 Paßwort 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 muß 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_cfg to wikiuser;" psql -d wikidb -c "grant select on pg_ts_cfgmap 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_cfg 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 obengenanntenAnweisungen 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
Wenn alle oben genannten Schritte durchgeführt sind, können Sie die Installation in einem Webbrowser beenden. Einzelheiten siehe im Handbuch: Konfigurationsanweisungen.