Manual:Instalando o MediaWiki
Essa página encobre todos os passos para instalar e configurar manualmente o MediaWiki.
A instalação do MediaWiki requer familiaridade básica com web host. Será mais fácil se você já possuir alguma experiência com Apache (web server software), PHP e MySQL/MariaDB (database) Ajuda adicional disponível a partir de Project: Support desk
A seção Apêndices abaixo mostra algumas alternativas a instalação manual.
For a quicker local server setup of MediaWiki, refer to the Local development quickstart .
Verificando os Requisitos de Instalação
Verifique se o seu sistema corresponde aos requisitos de instalação.
Certifique-se também de verificar as Notas de lançamento da versão do MediaWiki que você planeja instalar.
Baixar o software MediaWiki
Baixe o arquivo tar do MediaWiki da página oficial de baixar.
If you are using MediaWiki in a production environment, the release manager has issued a strong recommendation that only versions listed at Version lifecycle and their end-of-life as the current "stable version", "legacy version" or "long-term support version" should be used in a production environment. Older versions may contain critical security vulnerabilities and other major bugs, including the threat of possible data loss and/or corruption. Geralmente, se estiver usando um ambiente de produção, você deseja executar a versão estável mais recente, que é MediaWiki 1.42.3.
Extraia o software MediaWiki
O arquivo baixado está no formato de arquivo .zip
ou .tar.gz
.
Você precisa descompactar este arquivo antes de usá-los.
Você pode descompactar o arquivo localmente (e depois carregá-lo via FTP para o servidor) ou diretamente no seu servidor.
No Windows, a descompactação pode ser feita com programas como 7-Zip (grátis), WinZip, WinRAR ou IZArc (grátis).
No Linux e Mac OS X, você pode descompactar o arquivo usando este comando:
tar -xzvf mediawiki-*.tar.gz
chown -R <new_owner_user> <mediawiki_folder>
Mais informações: Manual:Segurança#Permissões de arquivos
Fazer upload de arquivos para seu sevidor
Se você ainda não carregou os arquivos para o seu servidor web (ou copiou, se o software do seu servidor web é executado localmente no seu localhost
), faça-o agora.
É possível fazer o upload dos arquivos para o diretório de seu servidor web:
- copiando diretamente a pasta descompactada ou
- usando um cliente FTP como FileZilla (Windows, OSX e Linux) ou Cyberduck (Windows e OSX).
- usando software já fornecido pelo seu serviço de hospedagem, como o cPanel File Manager
Se sua ferramenta de carregamento tiver uma opção "alterar nomes de arquivo para minúsculas", então você deve desabilitar isso.
Se você usar o servidor web Apache HTTPD, o diretório correto será especificado em seu arquivo httpd.conf
na diretiva DocumentRoot
.
Por padrão, isso é /var/www/
ou <pasta-do-apache>/htdocs
.
A localização exata do arquivo httpd.conf
de configurações e diretórios do servidor Apache depende do seu sistema operacional.
No Debian e no Ubuntu, o arquivo de configurações e diretórios do servidor Apache é /etc/apache2/apache2.conf
.
No Red Hat e no Fedora, o arquivo é /etc/httpd/conf/httpd.conf
.
Renomeie a pasta que subiu como você quiser que seja na URL.
For example, if you rename the folder to wiki
, the URL will reflect this as example.com/wiki
.
Se o seu servidor web estiver sendo executado como http://localhost
, por exemplo, renomear para o diretório /w/
significaria que você acessaria sua wiki em http://localhost/w/index.php
.
/wiki/
se quiser configurá-lo como um URL curto após executar o script de instalação.
Definir o banco de dados
O script de instalação do MediaWiki solicitará um nome de banco de dados e um nome de usuário do banco de dados, para que o MediaWiki possa armazenar o conteúdo da wiki.
Se você já possui um servidor de banco de dados e sabe a senha do usuário "root" (admin), vá para a seção #Executar o script de instalação abaixo.
Se você não souber a senha do usuário root, por exemplo, se você estiver em um servidor hospedado, você terá que criar um novo banco de dados antes de executar o script de instalação do MediaWiki na próxima seção.
MariaDB/MySQL são os bancos de dados recomendados. PostgreSQL e SQLite têm suporte limitado e não devem ser usados a menos que haja uma razão para isso. Se não tiver certeza de qual banco de dados escolher, use MariaDB.
Após terminar a configuração do banco de dados, continue com #Executar o script de instalação abaixo.
SQLite
Nenhuma configuração adicional é necessária para SQLite se o módulo pdo-sqlite
para PHP estiver instalado no sistema.
Na página de instalação do SQLite, escolha um nome de banco de dados (que pode ser qualquer coisa) e o diretório do banco de dados SQLite. Para o diretório da base de dados, o instalador tentará usar um subdiretório fora do document root, e irá criá-lo se necessário. Se este diretório não for seguro (por exemplo, puder ser lido via web), mude-o manualmente para evitar que fique acessível a todos na web.
MariaDB/MySQL
Crie o banco de dados MariaDB/MySQL e o usuário do banco de dados.
- Use um software de painel de controle oferecido pelo seu serviço de hospedagem (exemplo: PhpMyAdmin)
- Use ssh para fazer login em seu host e digite os comandos abaixo em um prompt do MySQL. Consulte a documentação correspondente do seu provedor de hospedagem. Alternativamente, entre em contato com seu provedor de hospedagem para que ele crie uma conta para você.
Os comandos a seguir criam um banco de dados chamado my_wiki
, um usuário chamado wikiuser
e definem permissões para o usuário nesse banco de dados.
CREATE DATABASE my_wiki;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'database_password';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost' WITH GRANT OPTION;
Somente se o seu banco de dados não estiver sendo executado no mesmo servidor que o seu servidor web, você precisará fornecer o nome de host do servidor web apropriado (mediawiki.example.com
no exemplo abaixo):
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'mediawiki.example.com' IDENTIFIED BY 'database_password';
PostgreSQL
Se você estiver usando PostgreSQL, você precisará ter um banco de dados e um usuário criados para você ou fornecer o nome de um usuário PostgreSQL com privilégios de "superusuário" no formulário de configuração.
Com frequência, este é o usuário do banco de dados chamado postgres
Os seguintes comandos em uma linha de comando Linux, como usuário postgres, criam um usuário de banco de dados chamado wikiuser
, e um banco de dados chamado my_wiki
de propriedade do usuário chamado wikiuser
.
createuser -S -D -R -P -E wikiuser (então insira a senha) createdb -O wikiuser my_wiki
ou como superusuário (que por padrão é postgres) execute os seguintes comandos no prompt da base de dados:
CREATE USER wikiuser WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD 'database_password';
CREATE DATABASE my_wiki WITH OWNER wikiuser;
Atenção para a lista de problemas conhecidos ao rodar o MediaWiki com PostgreSQL.
Executar o script de instalação
Em seguida, conclua a instalação do MediaWiki acessando a URL de instalação do MediaWiki em seu navegador: Siga as instruções em Manual:Comando de Configuração .
Configuração extra
- Manual:Administração do sistema - Configuração adicional
- Manual:Administradores - Administração da Wiki
Mantenha atualizado!
Uma vez instalado, tenha certeza de manter atualizado, e manter seu servidor seguro!
Anexos
Alternativas à instalação manual
A instalação manual costuma ser o método preferido porque dá ao usuário mais controle e informações sobre como sua wiki é instalada, facilitando a solução de problemas e a manutenção. Processos, pacotes, conjuntos e serviços automatizados vêm com suas próprias idiossincrasias.
Em vez de instalar o MediaWiki manualmente, as opções alternativas podem ser mais fáceis:
- dispositivos de software pré-integrados
- serviços de hospedagem com instalação em 1 clique, ou wiki farms
- Pacotes de software
- Ao criar uma conta root, use uma senha que você se lembrará.
Consulte também o comparison of distribution options
Instruções específicas do sistema
As páginas listadas em Manual:Ajuda específica do sistema operacional fornecem instruções de instalação mais detalhadas destinadas a sistemas específicos.
Entretanto, na maioria dos casos, estes documentos por sistema são menos conservados e nem sempre podem estar atualizados. Primeiro consulte Instalando o MediaWiki (esta página) antes de examinar a documentação de instalação por sistema.
Executando múltiplas wikis
Consultar Manual:FAQ#Instalação e configuração.
Importar uma base de dados wiki existente
Consultar Manual:FAQ#Instalação e configuração.