Moodle – Descomplicando a instalação
Caro leitor, nesse artigo vamos tentar descomplicar a instalação do ambiente virtual de aprendizado Moodle para quem está iniciando o uso desta plataforma.
Para isso, utilizaremos o Vagrant para provisionar nosso ambiente de instalação, configurando duas máquinas, uma como servidor e outra como banco, sendo que na máquina servidor iremos hospedar o ambiente Moodle propriamente dito e na máquina banco faremos a configuração de seu respectivo banco de dados.
Antes de iniciar com o Vagrant, será necessário fazer o download e a instalação do Virtualbox que será o hypervisor em nossos testes. Podemos realizar o download do Virtualbox, aqui.
Feito o download, instale o Vagrant no diretório atual executando o comando:
1 | sudo apt install vagrant |
Após a instalação do Vagrant digite o seguinte comando:
1 | vagrant init |
Esse comando é importante porque fará com que o Vagrant possa criar o arquivo padrão vagranfile para que seja possível realizar a criação e a configuração das nossas máquinas virtuais.
O passo seguinte é utilizar o editor de texto de sua preferência para abrir o arquivo vagrantfile. Neste artigo, será utilizado o editor vim, mas isso é opcional.
1 | sudo vim Vagrantfile |
Depois de abrir o arquivo, é necessário editá-lo conforme a imagem abaixo:
Agora já temos as máquinas virtuais que utilizaremos para configurar o ambiente Moodle. Tendo configurado o vagrantfile, basta salvar e sair do arquivo. Assim que salvar e sair do arquivo, execute um
1 | vagrant up |
Essa ação é necessária para que as máquinas sejam atualizadas e para que possamos acessá-las via ssh.
Agora sim, com as máquinas virtuais necessárias para a instalação do Moodle, vamos colocar a mão na massa.
Para ter acesso ao servidor, execute o comando:
1 | vagrant ssh servidor |
Uma vez com acesso ao servidor, precisamos definir uma senha para o usuário root. Para isso execute o comando:
1 | sudo su - |
Na sequência aperte Enter em seguida execute:
1 | passwd |
Então, insira a senha teste. O passo seguinte é realizar a instalação do servidor web Apache. Execute-o com o comando:
1 | apt install apache2 -y |
Como já estamos logados com o usuário root da máquina, não há a necessidade de utilizar o comando sudo. Para que o Moodle funcione é necessário a instalação do PHP e também de algumas de suas extensões. Para realizar sua instalação, será necessário executar os comandos na seguinte ordem:
1 | apt -y install php php-common |
2 | apt -y install php-cli php-fpm php-json php-pdo php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath |
Após concluir a instalação do PHP, será necessário instalar as configurações básicas do Apache. Para isso, devemos instalar a biblioteca libapache com o seguinte comando:
1 | apt -y install libapache2-mod-php |
Com a biblioteca libapache instalada, o passo seguinte será habilitar o módulo apache e em seguida reiniciar o Apache com o comando:
1 | a2enmod php7.3 |
2 |
3 | systemctl restart apache2 |
Com as configurações básicas do Apache concluídas, nos próximos passo iremos usar muito o editor de texto. Poderá ser utilizado o editor de texto de sua preferência, e como já mencionado anteriormente, aqui utilizamos o vim. Para instalá-lo, execute:
1 | apt -y install vim |
É necessário configurar agora o virtualhost para finalizar as configurações do Apache. Vá até os diretórios onde se encontram o arquivos que vamos configurar:
1 | cd /etc/apache2/sites-enabled |
2 | cd /etc/apache2/sites-avaliable |
No diretório, é preciso fazer uma cópia do arquivo 000-default.conf acrescentando o nome moodle.conf, desta forma:
1 | cp 000-default.conf /etc/apache2/sites-enabled/moodle.conf |
2 | cp 000-default.conf /etc/apache2/sites-avaliable/moodle.conf |
Entre no arquivo para editá-lo:
1 | vim moodle |
A imagem abaixo mostra exatamente o conteúdo padrão que será exibido:
Vamos editá-lo com as seguintes informações: Adicionar o nome do servidor ServerName moodle.172-27-11-10.nip.io e o Documentroot /var/www/moodle, conforme a imagem abaixo:
Só mais alguns passos e nossa máquina servidora web estará pronta.
Feita a configuração do virtualhost, devemos baixar o Moodle e armazená-lo em /var/www/. Depois de baixar o Moodle, devemos extrair os arquivos executando os comandos na seguinte ordem:
1 | cd /var/www/ |
2 |
4 |
5 | tar -xvf moodle-latest-39.tgz |
Após baixar o Moodle e extrair os arquivos, vamos entrar em seu diretório:
1 | cd moodle/ |
Nesse diretório vamos copiar e renomear o arquivo config-dist.php para config.php . Esse arquivo será onde vamos inserir os dados referentes ao banco de dados. Execute os seguintes comandos:
1 | cp config-dist.php /var/www/moodle/config.php |
2 |
3 | vim config.php |
Seguindo o padrão estabelecido, as configurações a serem feitas serão essas:
Altere as linhas 41,43,45 e 46 com os dados do banco de dados (que vamos criar na máquina banco). Após alteradas as linhas acima citadas, o arquivo ficará assim:
41 mariadb
43 172.27.11.20
45 moodle
46 teste123
Nesse mesmo arquivo, vamos alterar as linhas 135 e 151 que por padrão estão dessa forma:
Após alteradas, as linhas ficarão dessa forma: A linha 135 irá ter o conteúdo http://moodle.172-27-11-10.nip.io e a linha 151B receberá os dados referentes ao diretório de armazenamento de dados do Moodle: /home/vagrant/data/moodledata, conforme imagem abaixo:
Depois disso, podemos salvar e sair do arquivo e por enquanto o trabalho na máquina servidor está quase completo. Após alterar o arquivo daremos as devidas permissões necessário para o dataroot da seguinte forma:
1 | chown -R www-data:www-data /home/vagrant/data/moodledata |
A ação seguinte então será: sair da máquina servidor e logar na máquina banco com os comandos:
1 | exit |
2 |
3 | exit |
4 |
5 | vagrant ssh banco |
Faltam apenas alguns pequenos passos para que finalmente a tão esperada instalação do Moodle seja concluída. Vamos a eles.
Devemos realizar o mesmo procedimento de definição de uma senha para o usuário root com os seguintes comandos:
1 | sudo su - |
2 |
3 | passwd |
Vamos utilizar a mesma senha teste. Feito isso, instalar o editor de texto vim com o comando:
1 | apt install vim |
O passo agora é realizar a instalação do banco de dados. O banco de dados que utilizamos neste ambiente será o mariadb.
1 | apt -y install mariadb-server |
Feita a instalação do banco de dados, devemos checar seu status para conferir se a ação foi realizada com sucesso.
1 | systemctl status mariadb |
Se a ação foi bem-sucedida e tudo correu bem com a instalação, você verá essa imagem:
Após checar a instalação, vamos configurar o banco seguindo com exatidão o passo a passo seguinte:
Execute o comando:
1 | mysql_secure_installation |
Pressione Enter após a execução do comando e em seguida escolha a opção y para todos os passos conforme as imagens:
Senha utilizada: teste
Vamos acessar o banco no comando:
1 | mysql -u root -pteste |
Agora que estamos dentro do banco de dados, vamos criar nossa database chamada moodle:
1 | create database moodle; |
Criando o usuário
1 | create user 'moodle'@'172.27.11.10' idendified by 'teste123'; |
O último, mas não menos importante passo dentro do banco de dados, é conceder privilégios para o usuário moodle:
1 | grant all privileges on moodle.* to 'moodle'@'localhost' identified by 'teste123'; |
2 |
3 | grant all privileges on moodle.* to 'moodle'@'%' identified by 'teste123'; |
4 |
5 | flush privileges; |
Depois disso, as configurações dentro do banco de dados estão completas e podemos sair executando:
1 | exit |
Para finalizar a configuração na máquina banco, será necessário liberar o acesso do IP para o banco em:
1 | cd /etc/mysql/mariadb.conf.d/ |
2 | vim 50-server.cnf |
Já dentro do arquivo 50-server.cnf, vamos alterar a linha 28 que por padrão estará assim :
E depois de alterada, ficará dessa maneira:
Para finalizar, reinicie o serviço do banco de dados com:
1 | systemctl restart mariadb |
Podemos sair da máquina banco e testar a conexão na máquina servidor:
1 | exit |
2 |
3 | exit |
4 |
5 | vagrant ssh servidor |
Vamos logar com usuário root:
1 | su- |
Instale o cliente do banco de dados mariadb e teste a conexão com o banco de dados:
1 | apt -y install mariadb-client |
2 |
3 | mysql -u moodle -h172.27.11.20 -pteste123 |
Após executar o comando acima, sua máquina servidor deverá se conectar com o banco.
Para sair do banco digite:
1 | exit |
Todos os pré-requisitos para a instalação do Moodle foram atendidos e agora podemos finalmente realizar a instalação. Abra o navegador e digite o endereço que configuramos na máquina servidor no virtualhost do Apache moodle.172-27-11-10.nip.io A página de instalação do Moodle deverá ser exibida. Basta seguir o passo a passo apresentado na tela:
Após clicar em continue podemos ver que faltam três extensões do PHP para instalar:
Instalando as extensões pendentes do PHP na máquina servidor:
1 | sudo apt install php-intl |
2 | sudo apt install php-xmlrpc |
3 | sudo apt install php-soap |
Reinicie o serviço do Apache:
1 | sudo systemctl restart apache2 |
E podemos ver que não restam dependências. Desta forma, podemos clicar em continue:
O Moodle irá realizar a instalação:
Para finalizar basta seguir o passo a passo com seus dados preenchendo os campos necessários na página do Moodle.
Esperamos que este tutorial tenha ajudado a esclarecer algumas dúvidas comuns sobre o passo a passo de instalação do Moodle.
