Kézikönyv:Karbantartószkriptek

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Maintenance scripts and the translation is 48% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎čeština • ‎русский • ‎हिन्दी • ‎中文 • ‎日本語 • ‎한국어
Community Noun project 2280.svg Felhasználók Octicons-terminal.svg Rendszergazdák Source code project 1171.svg Fejlesztők OOjs UI icon language-ltr.svg Fordítók

A karbantartószkriptek számos adminisztratív, importálási, karbantartási, lekérdezési és frissítési feladatot ellátnak. A szkriptek PHP nyelvűek és a maintenance könyvtárban találhatóak

Sok, különböző funkcionalitású szkript létezik. Mindig figyelmesen olvasd el a dokumentációt használat előtt; ha nincs ilyen, akkor futtatáskor légy még körültekintőbb.

Beállítás

The $wgDBadminuser and $wgDBadminpassword configuration variables must be set in order to run maintenance scripts that need to alter the structure of the database (like Kézikönyv:Update.php ) if the user configured in Manual:$wgDBuser doesn't have enough permissions. Alternatively, you can pass the --dbuser and --dbpass parameters to the script. The values for these variables differ based on the database engine that is being used to power your installation of MediaWiki. If not configured, it will use the user configured in Manual:$wgDBuser .

MySQL

Some of the maintenance scripts require database permissions that, for security reasons, the main MediaWiki database account should not have. A separate database account with 'superuser' privileges for just the MediaWiki database should be created (if it does not already exist.) If the database that you use for MediaWiki is called wikidb, then the following SQL would create such a user who can exercise superuser privileges on localhost.:

GRANT ALL PRIVILEGES ON wikidb.* TO 'wikidbadmin'@'localhost' IDENTIFIED BY 'strong-password';

Amint létezik a felhasználó, nevét rögzíteni kell a $wgDBadminuser változóban. Ahogy más, hasonló beállítások, ez is a LocalSettings.php fájlban tárolódik. Ezután a $wgDBadminpassword változóban be kell állítani a jelszót is.

PostgreSQL

A PostgreSQL a MySQL-től eltérő biztonsági modellt használ, és ugyanazon felhasználói fiók segítségével lehet elvégezni a szükséges karbantartást. Fontos, hogy a karbantartószkriptek által létrehozott táblák tulajdonosi jogai helyesen legyenek konfigurálva. A $wgDBadminuser és $wgDBadminpassword változókat nem kell beállítani.

A szkriptek futtatása

Example of IP address and FTP user name and password on the Godaddy.com hosting site.

A szkripteket a parancssorból kell futtatni. Users who do not access the server directly from its terminal will usually establish a connection through ssh. For Linux/Unix users this is by using the ssh client in a shell. For Windows users the use of a ssh client application such as the one introduced below is required.

Szükséges program: PuTTY vagy hasonló emulátor

  • 1. lépés: töltsd le és futtasd a PuTTY-t.
A Host Name (or IP address) mezőben add meg a webszerver IP-címét.
  • 2. lépés: a Host Name (or IP address) mezőben add meg a webszerver IP-címét (kérdés esetén keresd fel a szolgáltatód), majd kattints az Openre.
A login as: mezőbe írd be az FTP felhasználónevet.
  • 3. lépés: egy parancssori ablak jelenik meg. A login as: sorban add meg az FTP felhasználónevet.
A FTP user name@IP Address's password line: sorban add meg az FTP-jelszót.
  • 4. lépés: add meg a jelszót.
A parancssor.
  • 5. lépés: navigálj a „maintenance” mappába. Az aktuális könyvtárat a pwd paranccsal kérdezheted le. A mappa a telepítés főkönyvtárában található.
$ cd maintenance
  • 6. lépés: futtasd a szkriptet:
$ php rebuildall.php
Ha hibát jelez a program (például php.exe is no valid Win32 application), próbáld meg a következőt:
$ php-cgi rebuildall.php
Windows alatt a következőképp néz ki a parancs:
$ C:\path\to\php\php-win.exe C:\path\to\mediawiki\maintenance\rebuildall.php
Ha nem sikerül a futtatás, és sok hibaüzenetet kapsz, először próbáld meg, hogy az MW_INSTALL_PATH környezeti változó a főkönyvtárra mutasson. Ez segít a szkripteknek megtalálni a szükséges fájlokat, és részben fontos lehet harmadik féltől származó szkriptek futtatásakor.

Általános parancssori opciók

Almost every PHP script in /maintenance supports several standard options:

--help
Displays help message
--conf <path>
Location of LocalSettings.php, if not default (at parent directory of the script)
--dbuser <username>
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 <password>
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 <value>
Set memory limit for the script. Accepts ordinary numbers, standard php.ini abbreviations (1024K, 20M, 1G), max for no limit (will be used by default if omitted) and default for no change. (bevezetve: 1.17)
--quiet
Suppress non-error output
--wiki <id>
Wiki ID for wiki farms. This may be of the form dbname or dbname-prefix. LocalSettings.php will be run with the MW_DB and MW_PREFIX constants defined accordingly.
--profiler
Profiler output format (usually "text"). (bevezetve: 1.22)
--mwdebug
Enable built-in MediaWiki development settings. (bevezetve: 1.31)

MediaWiki installs that use symlinks

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

Otherwise you will get this error:

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 Manual:Wiki family#Shared Settings ) where common part is located outside of /w directory and accessed using relative link (require_once "../ExtensionSettings.php";). In this case maintenance scripts will not work when running them in /w/maintenance directory. Run them from /w directory instead:

$ php maintenance/rebuildall.php

No shell access

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

Karbantartószkriptek listája

Az alábbi elavult lista helyett

Here is the list of files included in the maintenance 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.

maintenance/

maintenance/archives

maintenance/benchmarks

maintenance/dev/includes

maintenance/language

maintenance/oracle

maintenance/storage

maintenance/term

Lásd még