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.

Existem dezenas de scripts com diferentes graus de utilidade geral e de qualidade - por causa disso, é melhor ler atentamente a documentação em um script antes de usá-lo. Se um script não estiver documentado, isso muitas vezes indica que cuidados adicionais devem ser tomados.

Configuração
As variáveis ​​de configuração  e   devem ser definidas a fim de executar alguns scripts de manutenção. <!- E quanto a instalações apoiadas em SQLite? -> Os valores para essas variáveis ​​diferem de acordo com o mecanismo de banco de dados que está sendo usado para alimentar sua instalação do MediaWiki.

MySQL
Alguns dos scripts de manutenção requerem permissões de banco de dados que, por razões de segurança, a conta do principal banco de dados do MediaWiki não deve ter. Uma conta de banco de dados separada com privilégios de 'superusuário' para apenas o banco de dados do MediaWiki deve ser criado (se ele ainda não existir.) Se o banco de dados que você usa para MediaWiki é chamado, então o seguinte código SQL criaria esse usuário que pode exercer privilégios de 'superusuário' no localhost.:

Uma vez que a conta existe, o nome da conta deve ser definido na variável de configuração. Como outras variáveis ​​de configuração,  deve ser definido no arquivo LocalSettings.php. Uma senha para  deve ser definida na variável de configuração.

PostgreSQL
O PostgreSQL utiliza um modelo de segurança diferente do MySQL e a mesma conta do servidor PostgreSQL utilizada para a operação do dia-a-dia da instalação do MediaWiki também deve ser utilizado para a execução dos scripts de manutenção. Isso é necessário para garantir que o proprietário para novas tabelas criadas pelos scripts de manutenção esteja definido corretamente. Simplesmente defina  para   e    para.

Executando os scripts
Os scripts de manutenção devem ser executados a partir da linha de comando.

Programa requerido: PuTTY ou qualquer emulador de terminal


 * Passo 1: Baixe e execute o PuTTY, um emulador de terminal.
 * Passo 2: No PuTTy, sob o nome do host (ou endereço IP) digite o endereço IP de seu site de hospedagem web (Entre em contato com seu provedor, se necessário) e clique em Open.


 * Passo 3: Uma tela de comando irá aparecer. Na linha login as:, digite o nome de usuário FTP.


 * Passo 4: Digite a senha FTP.


 * Passo 5: Altere o diretório atual para o subdiretório de manutenção. Você pode digitar  para ver em qual pasta você está atualmente. A pasta maintenance está na pasta raiz do Mediawiki.


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


 * Se aparecer um erro (por exemplo: php.exe is no valid Win32 application), tente o seguinte:


 * 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
Quase todos os scripts PHP no diretório /maintenance suportam várias opções padrão:
 * --help : Exibe a mensagem de ajuda
 * --conf &lt;path&gt; : Localização do arquivo LocalSettings.php, se não for o padrão (no diretório principal do script)
 * --dbuser &lt;username&gt; : Conta de banco de dados para uso, não é usado para os scripts que não exigem uma conexão de banco de dados ou quando o backend de banco de dados SQLite é utilizado.
 * --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