Manual:Script de configuração

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Config script and the translation is 78% complete.
Outdated translations are marked like this.
Other languages:
MediaWiki-2020-icon.svg Guia de instalação • Sobre o MediaWiki
Help-browser.svg Destaques • Requisitos para a instalação
Preferences-system.svg Download • Instalação • Configuração


The 1.13alpha Config script

Depois de ter carregado/instalado o MediaWiki no servidor web, a primeira coisa que você precisa fazer é completar a configuração básica, executando o script de configuração fornecido. Este script permite que você passe ao MediaWiki as informações necessárias a fim de obter o wiki instalado e funcionando.

Abrindo o formulário de instalação do MediaWiki

Nos exemplos a seguir, supõe-se que o seu site esteja localizado em http://www.example.com/ que fica fisicamente situado em seu servidor no endereço /home/example/web. Você precisará ajustar os exemplos para serem usados nos locais apropriados, de acordo com sua situação.

  1. Use seu navegador para ir até a página wiki principal. Este é o arquivo index.php que fica dentro da pasta acessível via web que você instalou no MediaWiki, e é tipicamente /w/index.php (por exemplo, http://www.example.com/w/index.php, supondo que você instalou o MediaWiki em /home/example/web/w). (Você não deve ter usado /wiki/ se você quiser usar Short URL).
  2. Você verá a versão do MediaWiki instalado e um link que diz "Por favor configure a wiki primeiro." Clique no link para iniciar o script de configuração. Para referência (caso você queira ir lá diretamente), ele fica situado dentro do diretório mw-config (então, usando o exemplo acima, você iria para http://www.example.com/w/mw-config/index.php).
    • Installer directory was called config before version 1.17.
  1. If the script spots any configuration errors then it will not allow you to continue. See below for details about the error messages you might encounter, and what to do if you do.
  1. If all the tests pass, you will be presented with a form to fill in the information that MediaWiki now requires.

Usando o script de configuração

Siga as instruções no formulário para preencher as entradas exigidas (recorra à tabela seguinte se você estiver incerto sobre o que inserir) e depois disso clique no botão "Instalar o MediaWiki!". Agora o script instalará as tabelas ou criará o banco de dados e criará um arquivo de configuração.

Depois que o script de instalação tenha encerrado sua execução com sucesso, um arquivo chamado LocalSettings.php será criado no diretório mw-config (config nas versões mais antigas). Este arquivo contém todas informações necessárias para que o MediaWiki rode. Como ele armazena a senha do usuário em formato texto, é fortemente sugerido que você cria uma conta de base de dados específica pra o wiki (ou seja, não root). (Consulte Usuário de base de dados na tabela abaixo)

  1. Mova este arquivo para o diretório principal do wiki (se você instalou o MediaWiki em /home/example/web/w, mova para lá)
  2. Defina as permissões mais rigorosas no arquivo LocalSettings.php
  3. Defina o chmod 600 e o chown <webserver owner> (O proprietário lê e escreve, nenhuma outra permissão)
  1. Set stringent permissions on the LocalSettings.php file.
    • Set chmod 600 and chown <webserver owner> (Owner read and write, no other permissions).

Uma vez que você tenha feito tudo o que foi dito anteriormente, sua wiki deve estar pronta para uso. Navegue para endereço que você instalou (em nosso exemplo http://www.example.com/w/index.php) e comece a editar!

Campo Explicação
Nome wiki O nome da wiki. Será exibido como o título principal para as meta-páginas, assim como em toda a interface em si. Ele não pode conter o termo "MediaWiki" ou o símbolo "#". Uma palavra curta, sem pontuação é preferível.
E-mail de contato Este é o endereço administrativo de e-mail principal para o wiki, e geralmente aparece como admin@localhost. Ele será exibido em algumas mensagens de erro e de todas as notificações de e-mail.
Idioma Este menu drop-down define o idioma para a interface wiki. Esteja ciente de que nem todas as localizações estão completas. O Unicode (UTF-8) é o conjunto de caracteres padrão para todas as opções.
Direitos autorais e Licenças Três escolhas estão disponíveis:
  • Sem metadados de licença (não recomendado para wikis públicas)
  • GNU Free Documentation License
  • Creative Commons Attribution Share Alike

Destas, apenas a licença Creative Commons Attribution Share-Alike é compatível com a Wikipédia em ambas as direções, e Attribution em uma direção.

Nome de usuário administrador e senha Crie um nome de usuário e senha. Os administradores têm a capacidade de bloquear os usuários de editar e realizar manutenções de rotina na wiki.
Cache de objeto Duas opções estão disponíveis:

Sem cache

Memcached

O Memcached proporcionará um aumento de desempenho. Forneça os endereços e portas do servidor no campo fornecido, separadas por uma vírgula. O MediaWiki também detectará o Turck MMCache, eAccelerator, APC e XCache. No entanto, esses programas não são recomendados se a wiki será executada em vários servidores de aplicativos.

Host do banco de dados O host no qual o banco de dados está localizado. Se o banco de dados está localizado no mesmo host que o servidor web, use localhost.
Se você estiver executando o MySQL usando um arquivo socket diferente (por exemplo, mysql no localhost, usando --socket=/tmp/mysocketfile), defina o host do banco de dados para:"localhost:/tmp/mysocketfile". Às vezes os sockets são chamados de portas. Se você tem um número de porta para o seu host do banco de dados, siga a mesma sintaxe:"my.host.url:port".
Nome do banco de dados. O nome do banco de dados MySQL ou PostgreSQL criado para servir o seu wiki.
Se você tem conta de superusuário do servidor de banco de dados e poderá usá-lo nesta página de formulário, então digite o nome do banco de dados que você deseja que seja criado para a sua wiki.

Se você está instalando em um site hospedado pelo Yahoo, pode ser necessário definir o nome do banco de dados para "mysql".
Nome de usuário do banco de dados. O nome de usuário usado para acessar o banco de dados da sua wiki.
Se você tem conta de superusuário do servidor de banco de dados e irá usá-lo neste formulário, então simplesmente preencha o nome de usuário do banco que você deseja que seja criado para sua wiki. Caso contrário, crie o usuário de banco de dados, e tenha certeza que o usuário tem permissões de SELECT, INSERT, UPDATE, e DELETE na base de dados do MediaWiki. Para efetuar a instalação, o usuário deve também ter as permissões CREATE e INDEX. É fortemente recomendado que você não use uma conta de superusuário, uma vez que a senha do usuário é armazenada em formato texto.
Senha do banco de dados A senha de usuário usado para acessar o banco de dados da sua wiki.
Se você tem conta de superusuário do servidor de banco de dados e irá usá-lo neste formulário, então simplesmente preencha com o nome de usuário do banco de dados que deseja que seja usado para a base de dados para seu wiki. Opcionalmente, forneça uma senha para a base de dados que já esteja criada para servir seu wiki.
Conta de superusuário/senha de superusuário O nome de usuário e senha do usuário root da base de dados, se você tiver. Se não tiver esta senha, deixe como está. Se você tem a senha, você poderá pular os estágios acima de criar uma base de dados e usuário manualmente, já que este formulário poderá fazer isso para você.
Prefixo da tabela do banco de dados (somente para MySQL) Um prefixo opcional para preceder o nome de cada tabela que será criada na sua base de dados wiki. Se você planeja ter vários wikis, pode querer usar um prefixo, como "w1_", de forma que todas tabelas associadas com seu primeiro wiki terão o prefixo "w1_". Isto permitirá que você instale diversos wikis usando a mesma bases de dados, por torna os nomes únicos. Por exemplo, o nome genérico "archive" torna-se "w1_archive", sendo então possível adicionar outra instalação do MediaWiki sem sobrescrever as tabelas.
Porta do banco de dados (Somente para Postgres) este é o número da porta na qual o Postgres está instalado. O valro padrão 5432 deve funcionar para a maioria das instâncias.
Schema para mediawiki / Schema para tsearch2 (Somente Postgres) O nome do schema no qual inserir seu wiki. O valor padrão "mediawiki" deve antender a maioria dos propósitos. Para usar mais de um wiki na mesma base de dados, tanto o nome do schema quanto o nome do usuário devem ser mudados, preferenciamente para o mesmo nome, para evitar confusão. O valor padrão "public" para tsearch2 provavelmente nunca terá de ser mudado.
Conjunto de caracteres do banco de dados Atualmente, há três opções para esta seção:

UTF-8 compatível com versões anteriores (Backwards-compatible UTF-8): Esta opção é usada ao atualizar o software do MediaWiki. Além disso, esta é uma boa opção para aqueles usuários que preferem um conjunto de caracteres mais antigo e mais estável.

UTF-8 experimental para MySQL 4.1/5.0 (Experimental MySQL 4.1/5.0 UTF-8): Esta é uma nova versão do UTF-8, que permite que o usuário habilite o suporte ao Unicode para servidores MySQL 4.1 e 5.0. Esta versão é bem legível, mas ocupa mais espaço.

Binário experimental para MySQL 4.1/5.0 (Experimental MySQL 4.1/5.0 Binary): Esta versão é unicode, mas não legível.

Ambos conjuntos experimentais de caracteres não estão bem documentados, e podem causar problemas na configuração do MediaWiki.

Erros de instalação

Ao rodar o script de configuração, ele fará várias verificações em seu sistema, e dirá se existe algum problema.

  • Após a instalação, se seu servidor estiver redirecionando para uma url inexistente, tente voltar e pressionar parar antes que a página redirecione e carregue o Localsettings.php.

Adicone a seguinte linha após $wgSitename: $wgServer = http://your.servername.com;

  • Parse error: parse error, expecting `T_STRING' in [...]\wiki\includes\Namespace.php on line 52
    Certifique-se de que você tem a versão apropriada do PHP para a versão do MediaWiki que está instalando.
  • Attempting to connect to database server as wikiuser...failed with error [2004] Can't create TCP/IP socket (10106).
    Geralmente encontrado na internet que você deve ligar os named pipes na configuração do MySQL, mas isto não me ajudou (apareceu no Win2000 com MySQL 5.0)
  • "Warning: main() [function.main]: open_basedir restriction in effect. File(/convertLinks.inc) is not within the allowed path(s):"
    aparentemente, a include path às vezes precisa ser configurada. Coloque [ php_value include_path '/var/www/vhosts/yourhost.com/httpdocs/pathtowiki' ] ems eu arquivo .htaccess.
  • (MediaWiki 1.10.1&1.11.2) Após rodar o script 1. aparece o texto: 'Setup has completed, your wiki is configured.' Ao selecionar o 'your wiki' abre uma nova tela com o endereço: $mwindex e o erro '404: The page cannot be found'.
    O caminho para php5isapi.dll está errado. No gerenciador do IIS, vá para web sites, clique com o direito em web site, vá para Propriedades e então, na aba home directory, clique em Configure, encontre o php nos arquivos listados, clique em Editar e corrija o caminho. (C:\progra~1\php\php5is~1) deve ser ("C:\program files\php\php5isapi.dll")
  • Warning: getrusage() is not supported in this PHP build
    Fazemos verificações function_exists para getrusage, então se você vir esta mensagem de erro, provavelmente significa que deve relatar um bug.
  • Parse error: syntax error, unexpected T_LNUMBER, expecting ';' in .../wiki/includes/GlobalFunctions.php on line 75
  • Make sure you have the appropriate version of PHP for the version of MediaWiki you are installing.
  • Attempting to connect to database server as wikiuser...failed with error [2004] Can't create TCP/IP socket (10106).
  • Often found in the internet that you should turn on named pipes in the MySQL configuration, but this did not help me (this appeared under Win2000 with MySQL 5.0)
  • "Warning: main() [function.main]: open_basedir restriction in effect. File(/convertLinks.inc) is not within the allowed path(s):"
  • Apparently the include path sometimes needs to be set. Put [ php_value include_path '/var/www/vhosts/yourhost.com/httpdocs/pathtowiki' ] in your .htaccess file.
  • (MediaWiki 1.10.1&1.11.2) After 'Running the script' 1. The text is: 'Setup has completed, your wiki is configured.' Selecting 'your wiki' opens a new screen with the address: http://localhost:8080/mediawiki/index.php and the error '404: The page cannot be found'.
  • Path to php5isapi.dll is incorrect. In IIS manager go to web sites right click on web site go to properties then go to home directory tab and then click on configure find php in the list and then click edit and fix the path (C:\progra~1\php\php5is~1) Should be ("C:\program files\php\php5isapi.dll")
  • Warning: getrusage() is not supported in this PHP build
  • We do function_exists checks for getrusage, so if you see this error message, probably means you should file a bug.
  • Parse error: syntax error, unexpected T_LNUMBER, expecting ';' in .../wiki/includes/GlobalFunctions.php on line 75
  • Creating tables...Query "CREATE TABLE `user` ( user_id int" ..."You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'TYPE=InnoDB' at line 20 (localhost)".
    Na versão mais recente do MySQL, a sintaxe TYPE= foi mudada para ENGINE=. Modifique o script tables.sql inteiro.
  • In the latest version of MySQL, TYPE= syntax has been changed to ENGINE=. Modify the entire tables.sql script.
  • Warning: domdocument::domdocument() expects at least 1 parameter, 0 given in C:\xampp\htdocs\w\includes\Preprocessor_DOM.php on line 566
    Fatal error: Call to undefined method domdocument::loadXML() in C:\xampp\htdocs\w\includes\Preprocessor_DOM.php on line 568
    Defina $1 no LocalSettings.php.
  • Creating tables... using MySQL 4 table defs...Query "CREATE TABLE `v_job` ( job_id int(9) unsigned NOT NULL auto_increment, job_cmd varchar(255) NOT NULL default , job_namespace int NOT NULL, job_title varchar(255) binary NOT NULL, job_params blob NOT NULL default , PRIMARY KEY job_id (job_id), KEY (job_cmd, job_namespace, job_title) ) TYPE=InnoDB " failed with error code "Specified key was too long; max key length is 1024 bytes (h41mysql79.secureserver.net)
  • Set $wgParserConf ['preprocessorClass'] = 'Preprocessor_Hash'; in LocalSettings.php.
  • Creating tables... using MySQL 4 table defs...Query "CREATE TABLE `v_job` ( job_id int(9) unsigned NOT NULL auto_increment, job_cmd varchar(255) NOT NULL default , job_namespace int NOT NULL, job_title varchar(255) binary NOT NULL, job_params blob NOT NULL default , PRIMARY KEY job_id (job_id), KEY (job_cmd, job_namespace, job_title) ) TYPE=InnoDB " failed with error code "Specified key was too long; max key length is 1024 bytes (h41mysql79.secureserver.net)
  • Aviso: ini_set() foi desabilitado por razões de segurança em .../includes/AutoLoader.php na linha 5
  • Se ocorrer o erro no MySQL 'DB connection refused', é possível que a porta padrão no arquivo PHP do Apache ('php.ini') esteja errada.
  • Seu sistema possui uma combinação de versões PHP e libxml2, que são de buggy e podem causar corrupção de dados ocultos no MediaWiki e em outros aplicativos da web. Atualize para o PHP 5.2.9 ou posterior e libxml2 2.7.3 ou posterior! ABORTING (http://bugs.php.net/bug.php?id=45996 para detalhes).
    Como o erro indica, atualize um ou faça o downgrade de um.

[TODO: Esta seção deve listar todas as mensagens de erro potenciais e como corrigi-las. Ou talvez eles deveriam estar em uma página separada (depende de quantos existem, eu acho... --HappyDog 22:05, 29 de agosto de 2007 (UTC)]

Erros de configuração

[Pendente: Esta seção deve listar todos os erros que podem ocorrer ao enviar o formulário, e como lidar com eles. Ou talvez em uma página separada, se necessário]

  • E quanto ao $wgSecretKey e.g.

Atenção: A chave $wgSecretKey é insegura, gerada com mt_rand (). Considere mudá-lo manualmente.

a) o que é e b) qual é a solução?

Resposta: significa que o seu sistema não suporta /dev/urandom então a chave foi gerada com mt_rand(). Você pode editar manualmente o campo wgProxyKey em LocalSettings.php.


  • A chave especificada era muito longa

Configurações avançadas

Ver também

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Config_script/pt-br&oldid=4772419"