Manual:Maintenance scripts/de

Wartungsskripte werden genutzt, um verschiedene Aufgaben wie Verwaltung, Import, Wartung, Berichte und Aktualisierungen durchzuführen. Die Skripte sind in PHP geschrieben und liegen im -Unterverzeichnis von MediaWiki-Installationen.

Es gibt Dutzende von Skripten, die in ihrer Nützlichkeit und Qualität unterscheiden. Die Dokumentation eines Skripts sollte gründlich gelesen werden, bevor es genutzt wird. Undokumentierte Skripts sollten, wenn überhaupt, nur mit besonders großer Vorsicht verwendet werden.

Konfiguration
Die Konfigurationsvariablen  und   müssen gesetzt werden, um Wartungsskripte auszuführen, die die Struktur der Datenbank ändern müssen (wie ), wenn der in  konfigurierte Benutzer nicht über genügend Berechtigungen verfügt. Alternativ können die Parameter --dbuser und --dbpass an das Skript übergeben werden. Die Werte für diese Variablen unterscheiden sich je nach verwendete Datenbank, die für die Installation von MediaWiki verwendet wird. Wenn nichts konfiguriert wurde, wird der Nutzer verwendet, der in spezifiziert wurde.

MySQL
Einige der Wartungsskripte erfordern Zugriffsrechte auf die Datenbank, die der MediaWiki-Datenbank normalerweise aus Sicherheitsgründen nicht zur Verfügung stehen. Für den Zugriff auf die MediaWiki-Datenbank sollte ein zusätzlicher Datenbank-Account mit "Superuser"-Zugriffsrechten angelegt werden (wenn er nicht schon existiert). Wenn der Datenbankname  lautet, dann kann der Superuser auf localhost mit folgendem SQL angelegt werden:

Wenn der Accout einmal existiert, muss der Name in der Variablen  konfiguriert werden. Wie andere Konfigurationsvariablen muss  in  gesetzt werden. Das Passwort für  muss in der Konfigurationsvariable   gesetzt werden.

PostgreSQL
PostgreSQL nutzt ein anderes Sicherheitsmodell als MySQL, daher muss für die Wartungsskripte der gleiche PostgreSQL Server-Account genutzt werden, wie für die alltägliche Arbeit des MediaWiki. Damit ist sichergestellt, dass neue Tabellen durch das Wartungsskript mit dem korrekten Eigentümer angelegt werden. Daher werden §1 als auch §2 nicht benötigt.

Ein Script laufen lassen
Die Wartungsskripte müssen aus der Kommandozeile ausgeführt werden. Nutzer die nicht direkt auf die Kommandozeile des Server zugreifen können, werden normalerweise eine SSH-Verbindung verwenden. Unix/Linus-Benutzer verwenden dafür den SSH-Client in der Shell. Windows-Nutzer können das mit Windows 10 eingeführte SSH Kommandozeilentool nutzen oder alternativ ein zusätzliches Tool wie das unten gezeigte PuTTY oder das Windows-Subsystem für Linux.

Benötigtes Programm für Windows-Nutzer: PuTTY oder irgendein Terminal-Emulator


 * Schritt 1: Download und Start von PuTTY, ein Terminal-Emulator.
 * Schritt 2: In PuTTy, ist unter Host Name (or IP address) die IP Address der Web-Hosting Site einzugeben (Ggf. Provider kontaktieren), und auf Open zu klicken.


 * Schritt 3: Ein Kommandozeilenfenster öffnet sich. Bei login as: ist der FTP Benutzername anzugeben.


 * Schritt 4: Das FTP Passwort angeben.


 * Schritt 5: in das Wartungs-Unterverzeichnis wechseln. Der aktuelle Pfad wird mit  angezeigt. Das Verzeichnis 'maintenance' befindet sich im Hauptverzeichnis der MediaWiki-Installation.


 * Schritt 6: Ausführung des benötigten Wartungsskriptes:


 * Falls eine Fehlermeldung erscheint (z.B.: php.exe is no valid Win32 application), kann es so funktionieren:


 * In Windows lautet das Kommando:

Standard-Befehlszeilenoptionen
Fast jedes PHP-Skript in  unterstützt einige Standard-Optionen:
 * --help
 * Zeigt Hilfemitteilungen an


 * --conf &lt;path&gt;
 * Pfad der LocalSettings.php, falls nicht Standard (übergeordnetes Verzeichnis des Skriptes)


 * --dbuser &lt;username&gt;
 * Datenbank-Account, der anstelle des in LocalSettings.php angegebenen genutzt werden soll (wird für Skripte, die keinen Datenbankzugriff benötigen oder bei SQLite-Datenbanken nicht ausgewertet).


 * --dbpass &lt;password&gt;
 * Datenbank-Passwort, das anstelle des in LocalSettings.php angegebenen genutzt werden soll (wird für Skripte, die keinen Datenbankzugriff benötigen oder bei SQLite-Datenbanken nicht ausgewertet).


 * --globals
 * Ausgabe der globals am Ende der Verarbeitung für Debugzwecke.


 * --memory-limit &lt;value&gt;
 * Setzt eine Speicherbegrenzung für das Skript. Ganzzahlen und Standardabkürzungen der php.ini (1024K, 20M, 1G) werden akzeptiert,  für kein limit (Standard, wenn weggelassen) und   ergibt keine Änderung.


 * --quiet
 * Unterdrückung der Ausgabe (außer Fehlermeldungen)


 * --wiki &lt;id&gt;
 * Wiki ID für Wiki-Familien. Diese wird in der Form  oder   angegeben. in der LocalSettings.php sind entsprechend die Variablen   und   zu setzen.


 * --profiler
 * Ausgabeformat des Profiler (normalerweise "text").


 * --mwdebug
 * Aktiviert die eingebauten Einstellungen für Entwickler.

MediaWiki-Installationen, die Symlinks verwenden
Wenn die MediaWiki-Installation mit Hilfe symbolischer Links auf eine zentrale Installation verknüpft ist, muss die zum Wartungsskript gehörige LocalSettings.php spezifiziert werden. Zum Beispiel:

php maintenance/importImages.php --conf /var/wwwdata/website.org/wiki/LocalSettings.php /tmp/wikiimages .jpg .png .svg

Andernfalls wird folgende Fehlermeldung angezeigt:

A copy of your installation's LocalSettings.php must exist and be readable in the source directory.

MediaWiki-Installationen die gemeinsame Einstellungen verwenden (Wiki-Familien)
Wenn ein MediaWiki als Familie installiert ist um mehrere Einstellungen und Sprachen zu nutzen, werden die Einstellungen (LocalSettings.php) in einen gemeinsamen Teil und einen Sprach-Teil aufgeteilt (siehe ). Der gemeinsame Teil liegt dann außerhalb des /w Verzeichnisses und der Zugriff darauf erfolgt über eine relative Verzeichnisangabe. In solchen Fällen können die Wartungsskripte nicht direkt aus dem /w/maintenance Verzeichnis heraus aufgerufen werden. Sie sind stattdessen aus /w heraus zu starten:

Kein Shell-Zugriff
Bei vielen Hosting-Anbietern ist kein Shell-Zugriff möglich. Die folgenden Erweiterungen können (je nach MediaWiki-Version) helfen, werden aber nicht mehr gepflegt: und.

Liste der Wartungsskripte
Anstelle dieser eventuell veralteten Liste,


 * https://doc.wikimedia.org/mediawiki-core/master/php/ - Die automatisch generierte Kurzzusammenfassung lesen. (Files > File List > maintenance in den Tabs oder links in der Navigationsleiste)
 * https://doc.wikimedia.org/mediawiki-core/master/php/ - Die automatisch generierte Kurzzusammenfassung lesen. (Files > File List > maintenance in den Tabs oder links in der Navigationsleiste)

Hier eine Liste der Dateien im  Unterverzeichnis im Hauptverzeichnis der MediaWiki Installation. Jeder kann zu diesem Handbuch beitragen, durch Aktualisierung der Liste, Ergänzung kurzer Beschreibungen dieser Dateien, ihres Zweckes und wie sie zu nutzen sind (z.B. Kommandozeilen-Eingaben etc.). Bitte beachten: Alle Angaben sind ohne Gewähr.

Siehe auch

 * maintenance/README
 * maintenance/README
 * maintenance/README
 * maintenance/README
 * maintenance/README