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. You should carefully read the documentation on a script before using it; if a script isn't documented, take additional care running it.

Configuração
The  and   configuration variables must be set in order to run maintenance scripts that need to alter the structure of the database (like ) if the user configured in  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.

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
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. You don't need to set  or   at all.

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.


 * Passo 6: Execute o script de manutenção que precisa ser executado:


 * 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; : 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 : Variáveis globais de saída no final do processamento para depuração
 * --memory-limit &lt;value&gt; : Define o limite de memória para o script. Aceita números ordinários, abreviaturas php.ini padrão (1024K, 20M, 1G), max se não houver limite (será usado por padrão se omitido) e default se não houver alterações. Disponível desde o MediaWiki 1.17.
 * --quiet : Suprime a saída sem erro
 * --wiki &lt;id&gt; : ID wiki para wiki farms. Pode ser  ou   do formulário. O arquivo LocalSettings.php será executado com as constantes   e   definida adequadamente.

Instâncias do MediaWiki que usam links simbólicos
Nos casos em que os arquivos php do MediaWiki tem link simbólico em uma instalação central, você terá que especificar ao script de manutenção o caminho do arquivo LocalSettings.php. Por exemplo:

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
Em muitos hosts compartilhados, você não terá acesso ao shell. As seguintes extensões podem ser úteis para executar scripts de manutenção através da web: Extension:Maintenance e Extension:MaintenanceShell.

Lista de scripts de manutenção
Instead of this probably-outdated list,


 * View its generated documentation summary.
 * View its generated documentation summary.

Aqui está a lista de arquivos incluídos no subdiretório maintenance localizado no diretório raiz de uma instalação do MediaWiki. Você pode contribuir para este manual, mantendo esta lista atualizada, acrescentando uma descrição do propósito específico destes arquivos e de como um administrador deve usá-los (os exemplos de linha de comando, etc.)

Ver também

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