Como Instalar MediaWiki no Rocky Linux 9

MediaWiki é uma plataforma de software wiki livre e de código aberto que funciona perfeitamente no Rocky Linux, oferecendo uma poderosa solução de criação e gerenciamento colaborativo de conteúdo. Projetado originalmente para a Wikipedia, o MediaWiki agora é amplamente utilizado por diversas organizações e comunidades para construir e manter sites dinâmicos e ricos em informações. No Rocky Linux, uma distribuição Linux de nível empresarial conhecida por sua estabilidade e segurança, o MediaWiki se beneficia de um ambiente operacional robusto e confiável. Essa combinação garante que as instalações do MediaWiki no Rocky Linux possam lidar com altas cargas de tráfego e extensas contribuições de usuários, tornando-o uma escolha ideal para criar wikis abrangentes e escaláveis.

Este guia mostrará como instalar o MediaWiki no servidor Rocky Linux 9. Você instalará e configurará o MediaWiki com o LAMP Stack (Apache/Httpd, MySQL/MariaDB e PHP).

Pré-requisitos

Para completar este guia, certifique-se de ter o seguinte:

• Um servidor Rocky Linux 9.
• Um usuário não-root com privilégios sudo.
• Um nome de domínio apontado para um endereço IP do servidor.
• Um SELinux com status permissivo.

Instalando Dependências do LAMP Stack

O MediaWiki é um software wiki de código aberto baseado em PHP e MySQL/MariaDB. Para instalá-lo, você deve instalar o LAMP Stack (Apache/httpd, MySQL/MariaDB e PHP) em seu sistema Rocky Linux. Neste exemplo, você instalará o MediaWiki com PHP 8.1, então você precisa adicionar o repositório de terceiros.

Para começar, execute o comando abaixo para adicionar os repositórios EPEL e Remi ao seu servidor Rocky Linux.

sudo dnf install epel-release dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm

Neste momento, o MediaWiki requer PHP 8.1, então você deve habilitá-lo através do repositório Remi. Execute o comando abaixo para habilitar o repositório PHP 8.1 do repositório Remi.

sudo dnf module reset php  
sudo dnf module enable php:remi-8.1

Agora execute o seguinte comando para instalar as dependências do LAMP stack para o MediaWiki. Digite y para confirmar a instalação.

sudo dnf install httpd httpd-tools mariadb-server mariadb php php-mysqlnd php-gd php-xml php-intl php-mbstring php-json php-curl wget

Uma vez que a instalação esteja completa, execute o seguinte comando systemctl para iniciar e habilitar o serviço httpd.

sudo systemctl start httpd  
sudo systemctl enable httpd

Inicie e habilite o serviço MariaDB com o comando abaixo.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Por fim, verifique a versão do PHP usando o seguinte comando. Você deve obter o PHP 8.1 instalado em seu sistema Rocky Linux.

php -v  
php -m

Adicionando Serviços HTTP e HTTPS ao Firewalld

Após instalar o LAMP Stack, você precisa abrir as portas HTTP e HTTPS em seu servidor Rocky Linux. Em sistemas operacionais baseados em RHEL, o firewalld é usado para abrir e gerenciar o tráfego permitido ao servidor.

Adicione os serviços HTTP e HTTPS ao firewalld executando o seguinte comando.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent

Agora recarregue o firewalld para aplicar novas regras com o comando abaixo.

sudo firewall-cmd --reload

Uma vez recarregado, verifique a lista de regras no firewalld usando o comando abaixo. Você deve ver os serviços HTTP e HTTPS adicionados ao firewalld.

sudo firewall-cmd --list-all

Configurando o Servidor MariaDB

Agora que você permitiu o tráfego para o servidor web httpd, pode prosseguir para proteger o MariaDB através da utilidade mariadb-secure-installation e criar um novo banco de dados e usuário que serão usados pelo MediaWiki.

Para proteger a instalação do servidor MariaDB, execute o comando mariadb-secure-installation abaixo.

sudo mariadb-secure-installation

Durante o processo, você será questionado sobre algumas configurações do servidor MariaDB - Digite y para confirmar as alterações ou n para rejeitar a nova configuração:

• Mudar para autenticação unix_socket? Digite n e pressione ENTER. O usuário root padrão do MariaDB já está protegido. Você também pode habilitá-lo digitando y para sim.
• Mudar a senha do root?. Digite y para confirmar e configurar sua nova senha de root do MariaDB.
• Remover usuário anônimo?. Digite y para confirmar.
• Proibir login remoto do root? Digite y para confirmar. Apenas conexões locais serão permitidas se você usar o usuário root do MariaDB.
• Você pode remover o banco de dados de teste e o acesso a ele? Digite y para confirmar e remover o banco de dados padrão ‘test’.
• Por fim, digite y novamente para recarregar todos os privilégios das tabelas em seu servidor MariaDB e aplicar novas alterações.

Com o servidor MariaDB protegido, você pode criar um novo banco de dados e usuário para o MediaWiki.

Faça login no servidor MariaDB usando o comando abaixo. Digite sua senha de root do MariaDB quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados e usuário para o MediaWiki. Neste exemplo, você criará um novo banco de dados mediawikidb e um usuário wikiuser com a senha p4ssw0rd. Você pode ajustar os seguintes detalhes do banco de dados com suas informações.

CREATE DATABASE mediawikidb;  
GRANT ALL PRIVILEGES ON mediawikidb.* TO 'wikiuser'@'localhost' IDENTIFIED BY 'p4ssw0rd' WITH GRANT OPTION;  
FLUSH PRIVILEGES;

Em seguida, execute a consulta abaixo para verificar os privilégios do usuário wikiuser. Certifique-se de que o usuário wikiuser pode acessar o banco de dados mediawikidb.

SHOW GRANTS FOR 'wikiuser'@'localhost';

Por fim, digite quit para sair do servidor MariaDB.

Baixando o Código Fonte do MediaWiki

Agora que você configurou o servidor MariaDB, você irá baixar o código fonte do MediaWiki e configurar as permissões adequadas para o diretório de instalação.

Mova-se para o diretório /var/www/ e baixe o código fonte do MediaWiki usando o comando wget abaixo. Verifique a página de download do MediaWiki para pegar o link para sua versão mais recente.

cd /var/www/  
wget https://releases.wikimedia.org/mediawiki/1.41/mediawiki-1.41.0.tar.gz

Uma vez baixado, execute o comando abaixo para extrair o código fonte do MediaWiki e renomear o diretório extraído para ‘mediawiki’. Com isso, seu diretório raiz de documentos para a instalação do MediaWiki será /var/www/mediawiki.

tar -zxpvf mediawiki-1.41.0.tar.gz  
mv mediawiki-1.41.0 mediawiki

Agora execute o comando chown abaixo para mudar a propriedade de /var/www/mediawiki para o usuário ‘apache’ e permitir que o servidor web httpd acesse o código fonte do MediaWiki.

sudo chown -R apache:apache /var/www/mediawiki

Se você tiver o SELinux habilitado, execute o comando abaixo para corrigir a rotulagem do código fonte do MediaWiki.

sudo restorecon -FR /var/www/mediawiki/

Configurando o Host Virtual do Httpd

Após baixar o código fonte do MediaWiki, você criará uma nova configuração de host virtual para o MediaWiki. Portanto, certifique-se de ter um nome de domínio apontado para o endereço IP do seu servidor.

Crie uma nova configuração /etc/httpd/conf.d/mediawiki.conf usando o seguinte comando do editor nano.

sudo nano /etc/httpd/conf.d/mediawiki.conf

Insira a configuração abaixo e certifique-se de alterar a opção ServerName com seu nome de domínio.

  

ServerName dev.domainhere.info  
ServerAlias dev.domainhere.info  
ServerAdmin [email protected]  
DocumentRoot /var/www/mediawiki  

ErrorLog /var/log/httpd/dev.domainhere.info_error.log  
CustomLog /var/log/httpd/dev.domainhere.info_access.log combined  

  
Options FollowSymlinks  
AllowOverride All  
Require all granted  
  

Quando terminar, salve o arquivo e saia do editor.

Agora execute o comando abaixo para verificar sua sintaxe httpd. Se você receber uma saída Syntax OK, isso indica que você tem uma configuração httpd adequada.

sudo apachectl configtest

Por fim, reinicie o serviço httpd para aplicar a nova configuração de host virtual httpd com o seguinte comando.

sudo systemctl restart httpd

Protegendo o MediaWiki com HTTPS via Letsencrypt

Se você está instalando o MediaWiki em um domínio público, certifique-se de implementar HTTPS. Neste exemplo, você gerará certificados SSL/TLS do Letsencrypt e protegerá o MediaWiki com HTTPS.

Primeiro, execute o comando dnf abaixo para instalar o Certbot e o plugin do Apache em seu sistema. Digite y para confirmar a instalação.

sudo dnf install certbot python3-certbot-apache

Uma vez que a instalação esteja concluída, execute o comando certbot abaixo para gerar certificados SSL/TLS para o seu nome de domínio do MediaWiki. Certifique-se de alterar o nome de domínio e o endereço de e-mail com suas informações.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Após o processo, sua instalação do MediaWiki deve estar protegida com HTTPS e seus certificados SSL/TLS devem estar disponíveis no diretório /etc/letsencrypt/live/.

Instalando o MediaWiki

Inicie seu navegador da web e visite seu nome de domínio do MediaWiki, como http://wiki.howtoforge.local/. Se tudo correr bem, você deve ver a página de boas-vindas do MediaWiki.

Clique no link para configurar o wiki.

Selecione o idioma padrão do MediaWiki e clique em Continuar. O MediaWiki suporta vários idiomas conforme necessário.

No processo de verificação do ambiente, certifique-se de que seu sistema atende aos requisitos do MediaWiki. Em seguida, clique em continuar novamente.

Agora insira o nome do banco de dados, usuário e senha. Em seguida, clique em Continuar.

Marque a opção para usar a mesma conta que para a instalação e clique em Continuar. Com isso, você usará o mesmo banco de dados para os usuários do MediaWiki.

Em seguida, insira seu usuário admin, senha e endereço de e-mail, e clique em Continuar. Este usuário será usado como administrador do MediaWiki.

Para a configuração adicional, clique em Continuar novamente. Você pode configurar isso mais tarde, após a conclusão da instalação.

Agora clique em Continuar para confirmar a instalação do MediaWiki.

Após a conclusão da instalação, você verá uma saída abaixo - Clique em Continuar para prosseguir para a próxima seção:

Você verá instruções adicionais para completar a instalação do MediaWiki:

• Baixe o arquivo LocalSettings.php.
• Coloque o LocalSettings.php no diretório DocumentRoot.

Volte para o terminal do seu servidor e execute o comando abaixo para criar um novo arquivo LocalSettings.php

touch /var/www/mediawiki/LocalSettings.php  
sudo chown apache:apache /var/www/mediawiki/LocalSettings.php

Edite o arquivo LocalSettings.php usando o comando do editor nano e insira o script PHP que você baixou nele.

nano /var/www/mediawiki/LocalSettings.php

Salve e saia do arquivo.

Volte para a página de instalação do MediaWiki e clique no link para entrar no seu wiki. Você verá a página principal padrão do MediaWiki como a seguinte:

Conclusão

Parabéns! Você completou a instalação do MediaWiki com o LAMP Stack (Apache/httpd, MariaDB e PHP) em um servidor Rocky Linux 9. Você também protegeu o MediaWiki com HTTPS via Certbot e Letsencrypt.