Manual:Maintenance scripts/pt-br

Os scripts de manutenção são usados para executar várias tarefas administrativas, de importação, manutenção, elaboração de relatórios e atualização. Os scripts são escritos em PHP e ficam no subdiretório maintenance das instalações do MediaWiki.

There are dozens of scripts with varying degrees of general utility and quality - because of this, it is best to carefully read the documentation on a script before using it. If a script is not documented, this often indicates that additional care should be taken.

Configuração
The  and   configuration variables must be set in order to run some maintenance scripts. The values for these variables differ based on the database engine that is being used to power your installation of MediaWiki.

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 , then the following SQL would create such a user who can exercise superuser privileges on localhost.:

Once the account exists, the account name should be set in the  configuration variable. Like other configuration variables,  should be set in LocalSettings.php. A password for  must be set in the   configuration variable.

PostgreSQL
PostgreSQL uses a different security model than MySQL and the same PostgreSQL server account used for day-to-day operation of the MediaWiki installation must also be used for running the maintenance scripts. This is necessary to ensure that the owner for new tables created by the maintenance scripts is set correctly. Simply set  to   and    to.

Executando os scripts
The maintenance scripts must then be run from the command line.

Required program: PuTTY or any terminal emulator


 * Step 1: Download and run PuTTY, a terminal emulator.
 * Step 2: In PuTTy, under the Host Name (or IP address) enter the IP Address of your web hosting site (Contact your website provider if necessary) and click Open.


 * Step 3: A command screen will pop up. At the login as: line enter the FTP user name.


 * Step 4: Enter the FTP password.


 * Step 5: Change the current directory to the maintenance subdirectory. You can type  to see what folder you are currently in. The maintenance folder is in the root mediawiki folder.


 * Step 6: Execute the maintenance script that needs to be run:


 * If you get an error (for example: php.exe is no valid Win32 application), try the following:


 * No Windows, o comando é;

''Se o seu script não funcionar, e despejar um monte de mensagens de erro, a primeira coisa a fazer é definir a variável de ambiente  para apontar para o diretório raiz da sua instalação do MediaWiki. Isso ajudará os scripts a encontrar os arquivos necessários, e é particularmente relevante quando executar scripts de manutenção fornecidos por extensões de terceiros.''

Opções de linha de comando padrão
Almost every PHP script in /maintenance supports several standard options:
 * --help : Exibe a mensagem de ajuda
 * --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, 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, 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), max for no limit (will be used by default if omitted) and default for no change. Available only since MediaWiki 1.17.
 * --quiet : Suprime a saída sem erro
 * --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.

Instâncias do MediaWiki que usam links simbólicos
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 Caso contrário, você obterá este erro: A copy of your installation's LocalSettings.php must exist and be readable in the source directory.

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

Lista de scripts de manutenção
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.).

maintenance/archives

 * upgradeLogging.php

maintenance/benchmarks

 * Benchmarker.php
 * bench_HTTP_HTTPS.php
 * bench_delete_truncate.php
 * bench_if_switch.php
 * bench_strtr_str_replace.php
 * bench_utf8_title_check.php
 * bench_wfBaseConvert.php
 * bench_wfIsWindows.php
 * benchmarkHooks.php
 * benchmarkPurge.php

maintenance/language

 * StatOutputs.php
 * alltrans.php
 * checkDupeMessages.php
 * checkExtensions.php
 * checkLanguage.inc
 * checkLanguage.php
 * countMessages.php
 * date-formats.php
 * digit2html.php
 * dumpMessages.php
 * generateCollationData.php
 * generateNormalizer.php
 * langmemusage.php
 * languages.inc
 * messageTypes.inc
 * messages.inc
 * rebuildLanguage.php
 * transsat.php
 * validate.php
 * writeMessagesArray.inc

maintenance/locking

 * LockServerDaemon.php

maintenance/orcale

 * alterSharedConstraints.php

maintenance/storage

 * checkStorage.php
 * compressOld.php
 * dumpRev.php
 * moveToExternal.php
 * orphanStats.php
 * ecompressTracked.php
 * resolveStubs.php
 * storageTypeStats.php
 * testCompression.php
 * trackBlobs.php

maintenance/term

 * MWTerm.php

Ver também

 * Manual:Writing maintenance scripts
 * Manual:System administration
 * Manual:Upgrading
 * maintenance/README
 * Categoria:Site management extensions