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 Manual:update.php), wenn der in Manual:$wgDBuser 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 der  gesetzt werden. Das Passwort für  muss in der Konfigurationsvariablen   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  oder   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
Almost every PHP script in  supports several standard options:
 * --help
 * Displays help message


 * --conf &lt;path&gt;
 * Location of LocalSettings.php, if not default (at parent directory of the script)


 * --dbuser &lt;username&gt;
 * Database account to use instead of the one specified in LocalSettings.php, not used for scripts that don't require a database connection or when SQLite database backend is used


 * --dbpass &lt;password&gt;
 * Database password to use instead of the one specified in LocalSettings.php, not used for scripts that don't require a database connection or when SQLite database backend is used


 * --globals
 * Output globals at the end of processing for debugging


 * --memory-limit &lt;value&gt;
 * Set memory limit for the script. Accepts ordinary numbers, standard php.ini abbreviations (1024K, 20M, 1G),  for no limit (will be used by default if omitted) and   for no change.


 * --quiet
 * Suppress non-error output


 * --wiki &lt;id&gt;
 * Wiki ID for wiki farms. This may be of the form  or  . LocalSettings.php will be run with the   and   constants defined accordingly.


 * --profiler
 * Profiler output format (usually "text").


 * --mwdebug
 * Enable built-in MediaWiki development settings.

MediaWiki-Installationen, die Symlinks verwenden
In cases where the MediaWiki php files are symlinked to a central installation, you will need to specify to the maintenance script the path of the LocalSettings.php file. For example:

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 installs that use shared settings (family type)
Sometimes MediaWiki is installed as a family for many languages and settings (LocalSettings.php) are split to common part and language parts (see ) where common part is located outside of /w directory and accessed using relative link. In this case maintenance scripts will not work when running them in /w/maintenance directory. Run them from /w directory instead:

Kein Shell-Zugriff
On many shared hosts, you won't have shell access. The following extensions may be useful to run maintenance scripts via the web: and.

Liste der Wartungsskripte
Instead of this probably-outdated list,


 * https://doc.wikimedia.org/mediawiki-core/master/php/ - View its generated documentation summary. (Files > File List > maintenance in the tabs or left-hand navigation sidebar)
 * https://doc.wikimedia.org/mediawiki-core/master/php/ - View its generated documentation summary. (Files > File List > maintenance in the tabs or left-hand navigation sidebar)

Here is the list of files included in the  subdirectory located at the root of a MediaWiki installation. You can contribute to this manual by keeping this list up to date, adding a description of these files' specific purpose and of how an administrator should use them (command line examples, etc.). Be aware that these were created and named on an ad hoc basis so have some usability issues.

Siehe auch

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