Como instalar o Moodle no ISPConfig

O Moodle é uma plataforma de aprendizado projetada para fornecer a educadores, administradores e alunos um único sistema robusto, seguro e integrado para criar ambientes de aprendizado personalizados.

É utilizado em muitos ambientes, desde a educação, e-learning até testes de certificação.

Eu pessoalmente o utilizo todos os dias para ensinar meus alunos em um curso de sistemas operacionais e tanto professores quanto alunos adoram.

Neste tutorial, aprenderemos como instalá-lo como um site dentro do ISPConfig, também com certificado SSL do Let’s Encrypt.

O tutorial é baseado no Debian 8, mas deve funcionar bem também com Ubuntu e outras distribuições suportadas pelo ISPConfig.

Então, quais são os pré-requisitos antes de começar

ISPConfig instalado (este guia deve estar ok https://www.howtoforge.com/tutorial/perfect-server-debian-8-4-jessie-apache-bind-dovecot-ispconfig-3-1/)
DNS corretamente configurado para apontar seu site (para nosso teste, usamos course.servisys.it como referência do exemplo), isso é necessário para a configuração correta do Let’s Encrypt

1. Configurar o DNS

No nosso exemplo, dissemos que usaremos o domínio course.servisys.it, então quando formos abrir nosso site Moodle usaremos https://course.servisys.it, então para configurar o DNS. Vá para a aba DNS no ISPConfig e edite seu DNS para ficar parecido com a imagem abaixo:

Atenção para selecionar um tipo de registro A. Este é um passo muito importante, porque o registro A é usado pelo Let’s Encrypt para gerar o certificado SSL.

Se você gerencia seu DNS em um provedor externo, terá que criar o mesmo tipo de registro lá.

2. Criar o site

Agora vá para a aba Website no ISPConfig e crie um novo site, chamado como a configuração DNS anterior, editando as seguintes opções:

Subdomínio automático: no meu caso, eu mudei de www. para nenhum porque meu domínio é course.servisys.it. Se você configurá-lo para www, a automação do Let’s Encrypt tentará gerar um certificado para www.course.servisys.it e falhará. Portanto, preste atenção a esta opção.

SSL: Ativar para SSL.

Let’s Encrypt: sim, queremos gerar um certificado com isso.

PHP: Fastcgi está funcionando bem para mim.

Agora clique em salvar e aguarde, o certificado será emitido corretamente.

Aguarde alguns minutos e tente abrir seu site, no meu caso https://course.servisys.it, se tudo estiver ok você verá a barra verde!

3. Criação do banco de dados

Vamos criar um usuário de banco de dados e um banco de dados para usar com o Moodle.

Vá para a aba Sites, depois para Usuários de Banco de Dados > novo usuário.

Selecione o cliente associado a ele, escolha um nome e uma senha, algo como:

Anote:

Usuário do banco de dados
Senha

Volte para a aba Sites, e agora escolha Bancos de Dados, depois Adicionar Novo Banco de Dados, selecione seu site (courses.serverisy.it), escolha um nome de banco de dados e selecione o usuário criado anteriormente, e clique em salvar. Algo como a captura de tela abaixo:

4. Modificar a configuração do MySql

A configuração padrão do mysql precisa de algumas pequenas modificações para funcionar com o Moodle. Você deve editar o arquivo:

nano /etc/mysql/my.cnf

e no início, adicione a linha em vermelho

[client]  
port = 3306  
socket = /var/run/mysqld/mysqld.sock  
default-character-set = utf8mb4

sempre no mesmo arquivo, desça um pouco, antes de [mysqldump] começar, e novamente adicione as linhas em vermelho

#Moodle - Matteo  
innodb_file_format = Barracuda  
innodb_file_per_table = 1  
innodb_large_prefix  
  
character-set-client-handshake = FALSE  
character-set-server = utf8mb4  
collation-server = utf8mb4_unicode_ci  
  
[mysqldump]  
quick  
quote-names  
max_allowed_packet = 16M

Essas modificações são necessárias porque são pré-requisitos para instalar o Moodle, ou durante a configuração não permitirá que você prossiga na instalação.

Depois disso, reinicie o MySql com:

/etc/init.d/mysql restart

5. Preparando a instalação do Moodle

Agora estamos prontos para preparar a instalação do Moodle, faremos isso pela linha de comando porque é mais rápido do que FTP :)

Vá para esta página e selecione a instalação que atende às suas necessidades, em um ambiente de produção eu sugeriria que você usasse a versão estável. No momento em que estamos escrevendo, é a 3.2.2.

Então, pela linha de comando, vá para o diretório da web do seu site, no meu caso, esses são os comandos:

cd /var/www/course.servisys.it/web

rm index.html

wget https://download.moodle.org/download.php/direct/stable32/moodle-3.2.2.tgz

tar -zxvf moodle-3.2.2.tgz

cp -pr moodle/* ./

cp -pr moodle/.* ./

quando você usar o comando cd, obviamente mude para o nome do seu site.

Removemos a página padrão index.html, pois queremos que a primeira página servida seja index.php.

Depois disso, precisamos corrigir a propriedade dos arquivos, para se adequar aos nossos usuários e grupos, para saber qual é o correto para você, basta executar um

ls -al

você deve ver muitos arquivos, e alguns dos contêineres de usuário web client, no meu caso:

drwxr-xr-x 18 1005 1005 4096 mar 11 22:16 report  
drwxr-xr-x 24 1005 1005 4096 mar 11 22:16 repository  
-rwxr-xr-- 1 web42 client1 14 abr 13 17:25 robots.txt  
drwxr-xr-x 2 1005 1005 4096 mar 11 22:16 rss  
drwxr-xr-x 7 1005 1005 4096 mar 11 22:16 search  
drwxr-xr-x 2 web42 client1 4096 abr 13 17:25 stats  
drwxr-xr-x 5 1005 1005 4096 mar 11 22:16 tag  
-rw-r--r-- 1 1005 1005 615 mar 11 22:16 tags.txt  
drwxr-xr-x 6 1005 1005 4096 mar 11 22:16 theme

como você pode ver, meu usuário é web42 e meu grupo é client1, então agora corrija as permissões com:

chown -R web42:client1 *

chown -R web42:client1 .*

e corrija de volta as permissões dos diretórios

chown root:root stats/ error/

depois vamos criar um diretório moodledata que não seja acessível publicamente, para fazer isso, simplesmente crie-o no diretório privado.

mkdir ../private/moodledata

chown -R web42:client1 ../private/moodledata

6. Instalação Web do Moodle

Aqui vamos nós! Agora podemos começar a última etapa da instalação, abra seu navegador, você deve obter uma página semelhante a esta ao abrir a URL do site:

Selecione o idioma e clique em próximo.

O diretório de dados padrão para o Moodle aparecerá como /var/www/clients/client1/web42/moodledata, mas nosso diretório está na pasta privada, então altere o caminho para que use a pasta moodle na pasta privada em vez disso: /var/www/clients/client1/web42/private/moodledata

Em seguida, selecione o Tipo de Banco de Dados, no meu caso MySql.