Instalação do Moodle

18 de abril de 2007
Sumário

I Sobre essa Apostila 2

II Informações Básicas 4

III Instalação do Moodle 9

1 O que é o curso Instalação do Moodle 10

2 Plano de ensino 11
2.1 Objetivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.2 Público Alvo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.3 Pré-requisitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.4 Descrição . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.5 Metodologia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.6 Cronograma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.7 Programa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.8 Avaliação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.9 Bibliografia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3 Lição 1- Introdução 14
3.1 Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.1.1 O que é? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.1.2 Vantagens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.2 Instalação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.2.1 Requisitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.2.2 Requisitos Adicionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.3 Instalação dos pacotes principais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.4 Usando o comando apt-get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.5 Criando usuário no MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4 Criando usuário no MySQL 21

4.1 Instalação do pacote Moodle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.2 Organização . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.3 Estrutura do Diretório . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.4 Script de instalação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.5 Verificação das configurações do servidor . . . . . . . . . . . . . . . . . . . . . . . 23

1
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

5 Lição 3-Configuração - Parte II 25

5.1 Criação de um diretório de dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
5.2 Página de Administração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

6 Lição 4-Configuração - Parte III 28

6.1 Configuração do cron . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.1.1 Em servidores de alojamento Web . . . . . . . . . . . . . . . . . . . . . . . . 29
6.1.2 Criação de uma nova disciplina . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2
 Parte I

Sobre essa Apostila

3
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Conteúdo
O conteúdo dessa apostila é fruto da compilação de diversos materiais livres publicados na in-
ternet, disponíveis em diversos sites ou originalmente produzido no CDTC em http://www.cdtc.org.br.

O formato original deste material bem como sua atualização está disponível dentro da licença
GNU Free Documentation License, cujo teor integral encontra-se aqui reproduzido na seção de
mesmo nome, tendo inclusive uma versão traduzida (não oficial).

A revisão e alteração vem sendo realizada pelo CDTC (suporte@cdtc.org.br) desde outubro
de 2006. Críticas e sugestões construtivas são bem-vindas a qualquer tempo.

Autores
A autoria deste é de responsabilidade de Tiago Luiz Batista Maciel (timaciel@cdtc.org.br).

O texto original faz parte do projeto Centro de Difusão de Tecnologia e Conhecimento, que
vem sendo realizado pelo ITI (Instituto Nacional de Tecnologia da Informação) em conjunto com
outros parceiros institucionais, atuando em conjunto com as universidades federais brasileiras
que tem produzido e utilizado Software Livre, apoiando inclusive a comunidade Free Software
junto a outras entidades no país.

Informações adicionais podem ser obtidas através do email ouvidoria@cdtc.org.br, ou da

home page da entidade, através da URL http://www.cdtc.org.br.

Garantias
O material contido nesta apostila é isento de garantias e o seu uso é de inteira responsabi-
lidade do usuário/leitor. Os autores, bem como o ITI e seus parceiros, não se responsabilizam
direta ou indiretamente por qualquer prejuízo oriundo da utilização do material aqui contido.

Licença
Copyright ©2006, Instituto Nacional de Tecnologia da Informação (cdtc@iti.gov.br) .

Permission is granted to copy, distribute and/or modify this document under the terms
of the GNU Free Documentation License, Version 1.1 or any later version published by
the Free Software Foundation; with the Invariant Chapter being SOBRE ESSA APOS-
TILA. A copy of the license is included in the section entitled GNU Free Documentation
License.

4
 Parte II

Informações Básicas

5
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Sobre o CDTC

Objetivo Geral

O Projeto CDTC visa a promoção e o desenvolvimento de ações que incentivem a dissemina-

ção de soluções que utilizem padrões abertos e não proprietários de tecnologia, em proveito do
desenvolvimento social, cultural, político, tecnológico e econômico da sociedade brasileira.

Objetivo Específico

Auxiliar o Governo Federal na implantação do plano nacional de software não-proprietário e

de código fonte aberto, identificando e mobilizando grupos de formadores de opinião dentre os
servidores públicos e agentes políticos da União Federal, estimulando e incentivando o mercado
nacional a adotar novos modelos de negócio da tecnologia da informação e de novos negócios
de comunicação com base em software não-proprietário e de código fonte aberto, oferecendo
treinamento específico para técnicos, profissionais de suporte e funcionários públicos usuários,
criando grupos de funcionários públicos que irão treinar outros funcionários públicos e atuar como
incentivadores e defensores de produtos de software não proprietários e código fonte aberto, ofe-
recendo conteúdo técnico on-line para serviços de suporte, ferramentas para desenvolvimento de
produtos de software não proprietários e de seu código fonte livre, articulando redes de terceiros
(dentro e fora do governo) fornecedoras de educação, pesquisa, desenvolvimento e teste de pro-
dutos de software livre.

Guia do aluno

Neste guia, você terá reunidas uma série de informações importantes para que você comece
seu curso. São elas:

• Licenças para cópia de material disponível

• Os 10 mandamentos do aluno de Educação a Distância

• Como participar dos foruns e da wikipédia

• Primeiros passos

É muito importante que você entre em contato com TODAS estas informações, seguindo o
roteiro acima.

Licença

Copyright ©2006, Instituto Nacional de Tecnologia da Informação (cdtc@iti.gov.br).

6
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

É dada permissão para copiar, distribuir e/ou modificar este documento sob os termos
da Licença de Documentação Livre GNU, Versão 1.1 ou qualquer versão posterior
públicada pela Free Software Foundation; com o Capitulo Invariante SOBRE ESSA
APOSTILA. Uma cópia da licença está inclusa na seção entitulada "Licença de Docu-
mentação Livre GNU".

Os 10 mandamentos do aluno de educação online

• 1. Acesso à Internet: ter endereço eletrônico, um provedor e um equipamento adequado é

pré-requisito para a participação nos cursos a distância.

• 2. Habilidade e disposição para operar programas: ter conhecimentos básicos de Informá-

tica é necessário para poder executar as tarefas.

• 3. Vontade para aprender colaborativamente: interagir, ser participativo no ensino a distân-

cia conta muitos pontos, pois irá colaborar para o processo ensino-aprendizagem pessoal,
dos colegas e dos professores.

• 4. Comportamentos compatíveis com a etiqueta: mostrar-se interessado em conhecer seus

colegas de turma respeitando-os e fazendo ser respeitado pelo mesmo.

• 5. Organização pessoal: planejar e organizar tudo é fundamental para facilitar a sua revisão
e a sua recuperação de materiais.

• 6. Vontade para realizar as atividades no tempo correto: anotar todas as suas obrigações e
realizá-las em tempo real.

• 7. Curiosidade e abertura para inovações: aceitar novas idéias e inovar sempre.

• 8. Flexibilidade e adaptação: requisitos necessário à mudança tecnológica, aprendizagens

e descobertas.

• 9. Objetividade em sua comunicação: comunicar-se de forma clara, breve e transparente é

ponto - chave na comunicação pela Internet.

• 10. Responsabilidade: ser responsável por seu próprio aprendizado. O ambiente virtual não
controla a sua dedicação, mas reflete os resultados do seu esforço e da sua colaboração.

Como participar dos fóruns e Wikipédia

Você tem um problema e precisa de ajuda?

Podemos te ajudar de 2 formas:

A primeira é o uso dos fóruns de notícias e de dúvidas gerais que se distinguem pelo uso:

. O fórum de notícias tem por objetivo disponibilizar um meio de acesso rápido a informações
que sejam pertinentes ao curso (avisos, notícias). As mensagens postadas nele são enviadas a

7
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

todos participantes. Assim, se o monitor ou algum outro participante tiver uma informação que
interesse ao grupo, favor postá-la aqui.
Porém, se o que você deseja é resolver alguma dúvida ou discutir algum tópico específico do
curso. É recomendado que você faça uso do Forum de dúvidas gerais que lhe dá recursos mais
efetivos para esta prática.

. O fórum de dúvidas gerais tem por objetivo disponibilizar um meio fácil, rápido e interativo
para solucionar suas dúvidas e trocar experiências. As mensagens postadas nele são enviadas
a todos participantes do curso. Assim, fica muito mais fácil obter respostas, já que todos podem
ajudar.
Se você receber uma mensagem com algum tópico que saiba responder, não se preocupe com a
formalização ou a gramática. Responda! E não se esqueça de que antes de abrir um novo tópico
é recomendável ver se a sua pergunta já foi feita por outro participante.

A segunda forma se dá pelas Wikis:

. Uma wiki é uma página web que pode ser editada colaborativamente, ou seja, qualquer par-
ticipante pode inserir, editar, apagar textos. As versões antigas vão sendo arquivadas e podem
ser recuperadas a qualquer momento que um dos participantes o desejar. Assim, ela oferece um
ótimo suporte a processos de aprendizagem colaborativa. A maior wiki na web é o site "Wikipé-
dia", uma experiência grandiosa de construção de uma enciclopédia de forma colaborativa, por
pessoas de todas as partes do mundo. Acesse-a em português pelos links:

• Página principal da Wiki - http://pt.wikipedia.org/wiki/

Agradecemos antecipadamente a sua colaboração com a aprendizagem do grupo!

Primeiros Passos

Para uma melhor aprendizagem é recomendável que você siga os seguintes passos:

• Ler o Plano de Ensino e entender a que seu curso se dispõe a ensinar;

• Ler a Ambientação do Moodle para aprender a navegar neste ambiente e se utilizar das
ferramentas básicas do mesmo;

• Entrar nas lições seguindo a seqüência descrita no Plano de Ensino;

• Qualquer dúvida, reporte ao Fórum de Dúvidas Gerais.

Perfil do Tutor

Segue-se uma descrição do tutor ideal, baseada no feedback de alunos e de tutores.

O tutor ideal é um modelo de excelência: é consistente, justo e profissional nos respectivos

valores e atitudes, incentiva mas é honesto, imparcial, amável, positivo, respeitador, aceita as
idéias dos estudantes, é paciente, pessoal, tolerante, apreciativo, compreensivo e pronto a ajudar.

8
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

A classificação por um tutor desta natureza proporciona o melhor feedback possível, é crucial, e,
para a maior parte dos alunos, constitui o ponto central do processo de aprendizagem.’ Este tutor
ou instrutor:

• fornece explicações claras acerca do que ele espera, e do estilo de classificação que irá
utilizar;

• gosta que lhe façam perguntas adicionais;

• identifica as nossas falhas, mas corrige-as amavelmente’, diz um estudante, ’e explica por-
que motivo a classificação foi ou não foi atribuída’;

• tece comentários completos e construtivos, mas de forma agradável (em contraste com um
reparo de um estudante: ’os comentários deixam-nos com uma sensação de crítica, de
ameaça e de nervossismo’)

• dá uma ajuda complementar para encorajar um estudante em dificuldade;

• esclarece pontos que não foram entendidos, ou corretamente aprendidos anteriormente;

• ajuda o estudante a alcançar os seus objetivos;

• é flexível quando necessário;

• mostra um interesse genuíno em motivar os alunos (mesmo os principiantes e, por isso,

talvez numa fase menos interessante para o tutor);

• escreve todas as correções de forma legível e com um nível de pormenorização adequado;

• acima de tudo, devolve os trabalhos rapidamente;

9
 Parte III

Instalação do Moodle

10
Capítulo 1

O que é o curso Instalação do Moodle

O Moodle é um pacote criado com o objetivo de desenvolver o ensino a distância na comuni-

dade. Com uma infinidade de ferramentas ele auxilia professores e alunos a tornarem esse tipo
de aprendizado o mais semelhante possível dos métodos tradicionais de ensino.

11
Capítulo 2

Plano de ensino

2.1 Objetivo

Capacitar o usuário para instalar o Moodle e as ferramentas necessárias para que ele funcione
corretamente.

2.2 Público Alvo

Usuários finais ou novatos que desejam migrar os seus sistemas proprietários para software
livre, em especial aos interessados no ensino a distância.

2.3 Pré-requisitos

Os usuários deverão ser, necessariamente, funcionários públicos e ter conhecimentos básicos

para operar um computador. É desejável que o aluno tenha algum conhecimento em servidores
web e banco de dados.

2.4 Descrição

O curso será realizado na modalidade Educação a Distância e utilizará a Plataforma Moodle

como ferramenta de aprendizagem. O curso tem duração de uma semana e possui um conjunto
de atividades (lições, fóruns, glossários, questionários e outros) que deverão ser executadas de
acordo com as instruções fornecidas. O material didático está disponível on-line de acordo com
as datas pré-estabelecidas em cada tópico.

12
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

2.5 Metodologia

O curso está dividido da seguinte maneira:

2.6 Cronograma

• Lição 1 - Introdução e instalação das ferramentas necessárias

• Lição 2 - Configuração I
• Lição 3 - Configuração II
• Lição 4 - Configuração III

As lições contém o contéudo principal. Elas poderão ser acessadas quantas vezes forem neces-
sárias, desde que esteja dentro da semana programada. Ao final de uma lição, você receberá
uma nota de acordo com o seu desempenho. Responda com atenção às perguntas de cada lição,
pois elas serão consideradas na sua nota final. Caso sua nota numa determinada lição for menor
do que 6.0, sugerimos que você faça novamente esta lição.

Ao final do curso será disponibilizada a avaliação referente ao curso. Tanto as notas das lições
quanto a da avaliação serão consideradas para a nota final. Todos os módulos ficarão visíveis
para que possam ser consultados durante a avaliação final.

Aconselhamos a leitura da "Ambientação do Moodle"para que você conheça a plataforma de

Ensino a Distância, evitando dificuldades advindas do "desconhecimento"sobre a mesma.

Os instrutores estarão a sua disposição ao longo de todo curso. Qualquer dúvida deverá ser
enviada no fórum. Diariamente os monitores darão respostas e esclarecimentos.

2.7 Programa

O curso Instalação do Moodle oferecerá o seguinte conteúdo:

• Instalação e configuração do pacote,
• Instalação e configuração das ferramentas necessárias para que o Moodle funcione corre-
tamente.

2.8 Avaliação

Toda a avaliação será feita on-line.

Aspectos a serem considerados na avaliação:

13
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

• Iniciativa e autonomia no processo de aprendizagem e de produção de conhecimento;

• Capacidade de pesquisa e abordagem criativa na solução dos problemas apresentados.

Instrumentos de avaliação:

• Participação ativa nas atividades programadas.

• Avaliação ao final do curso.

• O participante fará várias avaliações referente ao conteúdo do curso. Para a aprovação e

obtenção do certificado o participante deverá obter nota final maior ou igual a 6.0 de acordo
com a fórmula abaixo:

• Nota Final = ((ML x 7) + (AF x 3)) / 10 = Média aritmética das lições

• AF = Avaliações

2.9 Bibliografia

• Instalação e configuração das ferramentas necessárias para que o Moodle funcione corre-
tamente.

14
Capítulo 3

Lição 1- Introdução

Nessa lição, além de mostrar o que é o pacote Moodle, iremos instalar algumas ferramentas
necessárias para que ele funcione corretamente.

3.1 Introdução

Esse guia explica como instalar o Moodle pela primeira vez. Para alguns usuários, nos passos
seguintes, o conteúdo se torna bem detalhado, com o objetivo de cobrir a maioria das possíveis
configurações de servidores. A instalação dessa ferramenta não tem nenhum mistério. Com o
entendimento do material aqui mostrado vão ser necessários apenas alguns minutos para que
ela seja concluída. Aproveite!

3.1.1 O que é?

Inicialmente Moodle significava "Modular Object-Oriented Dynamic Learning Environment".

Esse é um pacote com vários programas interligados com o objetivo de tornar possível o ensino
via web. Suas características mais valiosas são que ele é livre e Open Source, distribuído sob a
licença de Software Livre GNU Public License.

3.1.2 Vantagens

• Ele roda em qualquer sistema que suporte PHP, como Linux, Windows, Mac OS X entre
outros;

• A atualização de uma versão para uma mais nova é feita de forma bem simples, uma vez
que sua organização permite que muitas das mudanças sejam feitas automaticamente;

• Suporte a vários tipos de banco de dados, incluindo os mais populares do mercado;

• Preocupação especial com a integridade dos dados;

15
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

• Promove o desenvolvimento social, tendo como conseqüência a colaboração da comuni-

dade e a reflexão;

• Pode ser usado tanto para o ensino totalmente virtual como para o suporte a turmas pre-
senciais;

• Interface compatível com qualquer browser;

• Apresentação clara e objetiva, facilitando tanto o uso dos desenvolvedores quanto do usuá-
rio final.

3.2 Instalação

Vamos voltar ao principal objetivo do nosso curso, a instalação do Moodle. Veremos que
apesar dessa tarefa ser bem simples devemos tomar alguns cuidados para que tudo funcione
corretamente. A seguir, serão mostrados alguns requisitos necessários para que o Moodle possa
ser utilizado sem problemas.

3.2.1 Requisitos

O Moodle é desenvolvido no Linux principalmente usando Apache, MySQL e PHP, mas tam-
bém é regularmente testado com PostgreSQL e nos sistemas Windows XP, MacOS X e Netware
6. Os requisitos necessários para a ferrameta são os seguintes:

• Servidor web instalado e configurado - O comum seria o Apache, mas o Moodle trabalha
corretamente com qualquer servidor web que suporte PHP, como ISS na plataforma Win-
dows por exemplo. O PHP impõe alguns requisitos necessários para que tudo funcione
corretamente. Assim, sendo uma boa medida seria usar a versão mais nova possível do
servidor escolhido;

• Linguagem PHP (versão 4.1.0 ou posterior) - A versão PHP 5 (5.1.0 ou posterior) é su-
portada pelo Moodle 1.4. A partir do Moodle 1.6 a versão mínima do PHP exigida será a
4.3.0;

• Servidor de banco de dados - O MySQL ou o PostgreSQL são totalmente suportados e até

mesmo recomendados para serem usados com o Moodle. Para o Moodle 1.5 o mínimo é o
MySQL 3.23, enquanto que para o 1.6 o exigido é o MySQL 4.1.16. Já para o PostgreSQL
o mínimo é a versão 7.5, apesar de ser mais comum o uso da 8.0 e 8.1.

A maioria dos servidores suportam todas essas ferramentas . Caso você esteja associado
com algum que não as suporte entre em contato com os responsáveis para saber o motivo. Além
disso, uma boa dica é mudar de empresa. Caso você deseja instalar o Moodle no seu computador
pessoal vai ser necessário a instalação dos pacotes aqui citados (Apache, MySQL e PHP), o que
pode ser feito facilmente com o auxílio de guias disponíveis na internet.

16
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

3.2.2 Requisitos Adicionais

Extensões PHP

• GD library e FreeType 2 library - Bibliotecas Linux/Unix que permitem a visualização de

gráficos dinâmicos que as páginas logs produzem;

• Mbstring - exigido para manipulação;

• A extensão mysql é necessária no caso de você estar usando esse servidor de banco
de dados. Observe que nas distribuições Linux (em especial Red Hat) essa instalação é
opcional;

• A extensão pgsql é necessária se você estiver usando o PostgreSQL;

• A extensão zlib é necessária para funções de compactação e descompactação (zip/unzip);

• Outras extensões PHP podem ser necessárias para que seja possível o suporte a algumas
funcionalidades opcionais do Moodle, especialmente autenticações externas.

3.3 Instalação dos pacotes principais

Como vimos na etapa anterior é necessário ter um servidor e um banco de dados devida-
mente configurados para que o nosso Moodle funcione corretamente, isso tudo sem esquecer
do PHP. A seguir, vamos mostrar como realizar essas tarefas tomando como base a distribuição
Debian.

3.4 Usando o comando apt-get

Estando como root digite os comandos mostrados a seguir:

• apt-get install apache

• apt-get install libapache-mod-php4

• apt-get install mysql-server

• apt-get install php4-mysql

• apt-get install php4-gd

Após esses comandos, digite agora os comandos responsáveis pela a instalação do moodle
mostrados a seguir:

• apt-get install moodle

17
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Lembre-se de que o diretório raiz do servidor web é /var/www.

Quando aparecer a tela mostrada a seguir escolha "apache"como o seu servidor web.

Como o seu banco de dados escolha "mysql-server".

Caso o seu banco de dados estiver na mesma máquina onde o Moodle está sendo instalado,
deixe "localhost"como o servidor do banco de dados.

Se você não mudou o administrador do banco de dados, escreva "root"na tela abaixo:

18
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Se você não mudou a senha do administrador, deixe o campo da tela abaixo vazio:

Confirme a senha.

Escolha um nome para o dono do banco de dados que o Moodle vai utilizar.

Escolha uma senha para o dono do banco de dados do Moodle.

19
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Confirme a senha.

Visite o seu site do moodle em http://localhost/moodle .

3.5 Criando usuário no MySQL

Será necessário criar um banco de dados (por exemplo "moodle") vazio no seu sistema de
banco de dados, junto com um usuário especial (por exemplo "moodleuser") que tenha acesso a
esse banco (e a nenhum outro). Você pode usar o usuário "root"se quiser, mas isso não é acon-
selhável para um sistema ativo: se os "hackers"conseguirem descobrir a contrasenha de acesso
ao banco de dados, todo o seu servidor de banco de dados ficará em risco, em vez de colocar
em risco apenas um deles.

Se você estiver utilizando um servidor hospedeiro de páginas Web provavelmente estará dis-
ponível um painel de controle com uma interface Web que lhe permitirá criar o seu banco de
dados.

O sistema Cpanel é o mais popular desses sistemas. Para criar um banco de dados no Cpa-
nel basta fazer o seguinte:

1. Clique sobre o ícone "MySQL Database".

2. Escreva "moodle"no campo de banco de dados e clique em "Add Database".

3. Escreva um nome de usuário e contrasenha em seus respectivos campos, e clique em "Add

User". (Não use os mesmos dados já usados em algum outro serviço)

4. Agora use o botão "Add User to Database"para dar a esse usuário permissões de acesso
ao novo banco de dados.

5. Observe que ao nome do usuário e ao nome do banco de dados podem ter sido acrescen-
tados um prefixo com o nome da sua conta no Cpanel. Quando precisar dessa informação
no instalador do Moodle vai ser necessário usar os nomes completos, incluindo os prefixos.

Esse procedimento pode ser feito na linha de comando, como no exemplo a seguir onde a
ferramenta considerada foi o MySQL:

20
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

# mysql -u root -p
> CREATE DATABASE moodle;
> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON mo-
odle.*
TO moodleuser@localhost IDENTIFIED BY ’a_sua_senha’;
> quit
# mysqladmin -p reload

E um exemplo para PostgreSQL:

# su - postgres
> psql -c "create user moodleuser createdb;"template1
> psql -c "create database moodle;-U moodleuser template1
> psql -c "alter user moodleuser nocreatedb;"template1
> psql -c "alter user moodleuser with encrypted password ’yourpassword’;"template1
> su - root
# /etc/init.d/postgresql reload

21
Capítulo 4

Criando usuário no MySQL

Aqui, vamos apresentar como essa ferramenta se organiza, além de verificar as configurações
das ferramentas instaladas no passo anterior.

4.1 Instalação do pacote Moodle

Depois de realizar as lições anteriores e ter certeza de que nosso servidor e o nosso banco
de dados está funcionando corretamente finalmente vamos instalar o pacote Moodle. Acesse o
site http://download.moodle.org e faça o download da versão mais que é mais conveniente para
os seus objetivos.

Para descompactar um arquivo .zip, use o comando unzip nome_do_arquivo. Para arquivo
.tgz, use tar -zxfv nome_do_arquivo. Você poderá também usar qualquer interface gráfica como
file-roller ou ark. Após descompactar o arquivo, você terá um diretório chamado moodle.

Agora, suponha que você queira instalar o moodle em /var/www/moodle (isto significa que o
moodle estará acessível em http://localhost/moodle). Então faça mv moodle /var/www/ (prova-
velmente você precisará estar como root para fazer isto).

Outro passo fundamental é iniciar o servidor e o banco de dados. Para isso basta seguir o
procedimento abaixo:

1. Faça o login como root (se você ainda não fez): su

2. Inicie o servidor Web. Para o Apache2: /etc/init.d/apache start

3. Inicie o servidor de banco de dados. Para o MySQL: /etc/init.d/mysql start

Abra o browser, entre no endereço http://localhost/moodle e siga as instruções.

4.2 Organização

22
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

4.3 Estrutura do Diretório

Temos aqui um breve sumário mostrando o conteúdo do diretório principal do Moodle. Com
ele será possível entender como essa ferramenta é estruturada.

• config.php - contém as configurações básicas. Observe que esse arquivo não vem com o
Moodle. Ele deve ser criado.

• install.php - Esse vai ser o script a ser executado para que o config.php seja criado.

• version.php - Define a versão atual do código do Moodle.

• index.php - A página principal do site.

• admin/ - código para administrar todo o servidor.

• auth/ - módulos para a autenticação dos usuários.

• blocks/ - módulos para os pequenos blocos laterais em várias páginas.

• calendar/ - todo o código para gerência e visualização dos calendários.

• course/ - código para mostrar e gerenciar cursos.

• doc/ - documentação de ajuda a respeito do Moodle.

• files/ - código para mostrar e gerenciar arquivos carregados.

• lang/ - textos em línguas diferentes, onde temos um diretório por língua.

• lib/ - bibliotecas dos códigos do Moodle.

• login/ - código para criação de contas e acesso via login.

• mod/ - todos os módulos principais dos cursos estão aqui

• pix/ - imagens genéricas do site

• theme/ - pacotes de temas (theme/skins) para mudar a aparência do site

• user/ - código para mostrar e gerenciar usuários.

4.4 Script de instalação

Para criar o config.php é necessário executar o script de instalação (install.php). Para fazer
isso, verifique se é possível o acesso à URL principal do seu Moodle usando um navegador web.
Outra opção, seria fazer o acesso direto http://yourserver/install.php.

O instalador vai tentar instalar um "cookie"para a sessão. Caso apareça uma janela de adver-
tência em seu navegador, verifique se você aceitou o cookie.

23
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

O Moodle vai detectar que é necessário fazer algumas configurações e vai nos guiar através
de páginas que vão auxiliar na criação do novo arquivo de configuração chamado config.php.
No final do processo a ferramenta vai escrever o arquivo no local correto. Do contrário, podemos
pressionar o botão para fazer o download do instalador e depois carregar o config.php no diretório
principal do Moodle no servidor.

Ao longo do processo, o instalador vai testar o ambiente de trabalho do seu servidor e dará
sugestões a respeito de como resolver possíveis problemas.

4.5 Verificação das configurações do servidor

Em primeiro lugar, devemos ter certeza que o nosso servidor está configurado para usar o
index.php como página padrão (talvez além disso o index.html e default.htm ). No Apache, isso é
feito usando um parâmetro DirectoryIndex no seu arquivo httpd.conf. Observe o exemplo abaixo:

DirectoryIndex index.php index.html index.htm

Tenha certeza de que o arquivo index.php esteja na lista (e preferencialmente no início, para
aumentar a eficiência).

O segundo passo, no caso de você estar usando o Apache 2, é ativar a variável Accept-
PathInfo, que permite que o script passe argumentos do tipo http://servidor/arquivo.php/arg1/arg2
. Isso é essencial para permitir ligações entre os seus recursos, e também para melhorar a per-
formance de quem utiliza o seu site do Moodle. Isso pode ser feito adicionando essa linha ao seu
arquivo httpd.conf.

AcceptPathInfo on

Em terceiro lugar, o Moodle precisa da ativar algumas opções do PHP para funcionar corre-
tamente. Na maior parte dos servidores essas opções já estarão ativas por padrão. No entanto,
alguns servidores PHP (especialmente nas versões mais recentes) poderão estar configuradas
de forma diferente. Essas opções são ativadas no arquivo de configuração do PHP (normalmente
o php.ini):

magic_quotes_gpc = 1 (preferred but not necessary)

magic_quotes_runtime = 0 (necessary)
file_uploads = 1
session.auto_start = 0
session.bug_compat_warn = 0

Se não tiver acesso a httpd.conf ou php.ini no seu servidor, ou se estiver usando outras apli-
cações que exigem outra configuração diferente, não se preocupe pois será possível INVALIDAR
a configuração global.

24
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Para fazer isso vai ser necessário criar um arquivo .htaccess no diretório principal do Moo-
dle, com as definições necessárias. Isso só funcionará no Apache e além disso quando a opção
Overrides estiver ativa na configuração global do servidor. O conteúdo de .htacces será:

DirectoryIndex index.php index.html index.htm

AcceptPathInfo on

php_flag magic_quotes_gpc 1
php_flag magic_quotes_runtime 0
php_flag file_uploads 1
php_flag session.auto_start 0
php_flag session.bug_compat_warn 0

Podemos fazer outras coisas como, por exemplo, limitar o tamanho máximo dos arquivos envia-
dos para o Moodle:

LimitRequestBody 0
php_value upload_max_filesize 2M
php_value post_max_size 2M

O mais fácil será copiar o arquivo de lib/htaccess e editá-lo para adaptá-lo às suas necessidades
(o arquivo contém algumas dicas adicionais). Por exemplo, num shell do Unix:

cp lib/htaccess .htaccess

25
Capítulo 5

Lição 3-Configuração - Parte II

Nessa etapa, serão dadas algumas dicas de como armazenar os dados enviados pelos usuá-
rios do sistema. Além disso, vamos ver algumas das várias atribuições do administrador.

5.1 Criação de um diretório de dados

O Moodle vai precisar de algum espaço no seu disco rígido para armazenar arquivos enviados
como, por exemplo, os documentos associados a uma disciplina e as fotografias dos usuários. O
instalador tentará criar esse diretório para você, mas se não conseguir será necessário criá-lo
manualmente.

Por razões de segurança, é conveniente que esse diretório NÂO seja acessível diretamente
através da web. A forma mais simples de garantir isso será criar o diretório FORA do diretório
raiz do seu servidor Web; se assim não for, ele deve ser protegido criando um arquivo .htaccess
com o seguinte conteúdo:

deny from all

Para garantir que o Moodle vai poder gravar nesse diretório os arquivos recebidos, confira
se o servidor Web (por exemplo o Apache) tem autorização para escrever nessa pasta. Em
plataformas Unix, isso implica em mudar o proprietário do diretório para algo como "nobody",
"www-data"ou "apache", dando a esse usuário permissões para ler, escrever e executar arquivos
no diretório de dados.

Nos sistemas que usam Cpanel podemos usar o "File Manager"para encontrar o diretório,
clicando nele e selecionando "Change Permissions". Em muitos servidores Web compartilhados,
provavelmente, teremos que limitar o acesso a todos os arquivos apenas ao seu "grupo"para evi-
tar que outros usuários do servidor possam consultar ou modificar os seus arquivos, mas permitir
acesso de leitura/escritura para outros usuários (assim o servidor Web terá acesso aos seus ar-
quivos).

Se você estiver hospedando o seu Moodle em um servidor não próprio, consulte com o ad-
ministrador do servidor Web se tiver dificuldades em configurar o seu diretório de forma segura.

26
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Em particular, alguns servidores que usam certa funcionalidade do PHP, chamada "Safe Mode",
podem precisar que seja o administrador do seu servidor quem crie o diretório pessoalmente.

5.2 Página de Administração

Para continuar a fazer as configurações visite a página de administração.

Após o arquivo básico config.php ter sido criado, quando você tentar acessar a página prin-
cipal do seu servidor Moodle será redirecionado automaticamente para a página "admin"para
continuar a instalação.

A primeira vez que você entrar nessa página de administração vai ser apresentada a licença
GPL, que deverá aceitar para poder continuar com a instalação.

A seguir o Moodle vai configurar a sua base de infomações criando as tabelas que serão
usadas para guardar seus dados. Primeiro são criadas as principais. Nessa etapa, serão apre-
sentados vários comandos SQL seguidos por mensagens de diagnóstico (verde ou vermelho) do
gênero:

CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category int(10) un-
signed NOT NULL default ’0’, password varchar(50) NOT NULL default ”, fullname varchar(254)
NOT NULL default ”, shortname varchar(15) NOT NULL default ”, summary text NOT NULL, for-
mat tinyint(4) NOT NULL default ’1’, teacher varchar(100) NOT NULL default ’Teacher’, startdate
int(10) unsigned NOT NULL default ’0’, enddate int(10) unsigned NOT NULL default ’0’, timemo-
dified int(10) unsigned NOT NULL default ’0’, PRIMARY KEY (id)) TYPE=MyISAM

SUCCESS

...etc, seguidas por: banco de dados principal configurado com sucesso.

Se não aparecerem essas mensagens é sinal que existe algum problema com a banco de
dados ou com a configuração que definiu em config.php. Verifique se o PHP não está em "Modo
seguro"("Safe Mode". Alguns servidores comerciais costumam vir em modo seguro). Também po-
demos verificar as variáveis do PHP criando um pequeno arquivo que contenha <?php phpinfo()
?> e verificando com o seu navegador Web. Observe o resultado e tente acessar novamente a
página de administração e em seguida avance até o fim da página e clique no botão "Continuar".

Nessa etapa deverá aparecer um formulário onde podemos definir mais variáveis de configu-
ração para a sua instalação como, por exemplo, a língua usada por padrão, o nome do servidor
SMTP, etc. Não se preocupe muito em tentar configurar tudo na primeira vez - é possível re-
gressar a esta página sempre que quiser, através da interface de administração. Os valores por
padrão foram selecionados para serem úteis e suficientemente seguros na maioria dos servido-
res. Avance até o fim da página e clique no botão "Gravar alterações".

27
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

Se não conseguir passar dessa página (e unicamente nesse caso), provavelmente, o seu ser-
vidor tem o problema que chamamos de "buggy referrer". Isso é fácil de corrigir: simplesmente
desative a opção (secureforms"), e tente novamente.

A seguir, verá mais páginas que imprimem muitas mensagens de diagnóstico à medida que
são configuradas várias outras tabelas usadas pelos módulos do Moodle. Como no caso das
tabelas básicas, todas as mensagens de diagnóstico devem aparecer em verde. Avance até o fim
da página e clique no botão "Continuar".

A página seguinte é um formulário onde podemos definir parâmetros para o seu site e para a
página principal, tais como o nome, formato, descrição, etc. Complete esse formulário (lembrando
que é possível voltar para fazer possíveis alterações) e clique em "Gravar alterações".

Finalmente, vai ser pedido a criação de um usuário administrador de alto nível para futuros
acessos às páginas de administração. Complete a informação com o seu próprio nome, endereço
de correio eletrônico, etc e clique em "Gravar alterações". Nem todos os campos são indispensá-
veis, mas se esquecer algum importante o formulário voltará a aparecer.

Tenha o cuidado de lembrar o nome do usuário e a senha que escolheu para o administrador,
já que eles serão necessários para acessar as páginas de administração em ocasiões futuras.

(Se por qualquer razão a sua instalação for interrompida, ou aparecer algum erro que lhe im-
peça de entrar com a senha do administrador, normalmente vai ser possível acessar com o nome
de administrador como "admin"e senha "admin".)

Uma vez concluído esse processo com sucesso, será apresentada a página principal do seu
site. Repare no menu de administração no lado esquerdo da página (os mesmos itens do menu
aparecem na página de administração) - esse menu só é visível quando entramos como admi-
nistrador. Todas as configurações necessárias a partir de agora poderão ser feitas a partir desse
menu, como por exemplo:

• criação e eliminação de disciplinas

• criação e modificação de contas de usuários

• gestão de contas de docentes

• mudança de opções globais como o tema, língua, etc

Mas a instalação ainda não terminou! Existe ainda um passo importante no processo de
instalação (veja a próxima seção sobre o cron).

28
Capítulo 6

Lição 4-Configuração - Parte III

Para finalizar, vamos conhecer esse script, responsável pela execução de tarefas periódicas.

6.1 Configuração do cron

Alguns dos módulos do Moodle precisam de verificações freqüentes para realizar algumas
tarefas. Por exemplo, o Moodle precisa verificar os fóruns de discussão para saber se é preciso
enviar por email cópias de novas contribuições aos assinantes do fórum.

O script que executa essas tarefas encontra-se no diretório admin, com o nome cron.php. No
entanto, ele não pode funcionar sozinho, sendo preciso instalar um mecanismo para que o script
seja executado em intervalos regulares (como, por exemplo, a cada 5 ou 10 minutos). Esse me-
canismo pode ser encarado como as "pulsações cardíacas"necessárias para que o script possa
executar as tarefas definidas por cada módulo. Esse tipo de sistema de execução periódica de
tarefas é conhecido como serviço cron.

É importante salientar que a máquina que executa o cron não precisa ser a mesma máquina
onde Moodle está instalado. Por exemplo, se tiver um servidor web com algumas limitações, que
não tem o programa cron, é possível executar o cron em outra máquina ou até no seu computador
em casa. O importante é que o arquivo cron.php seja chamado regularmente.

Carregar esse script não é uma tarefa cara, de maneira que 5 minutos é um intervalo de
tempo razoável, mas se estiver achar necessário pode alterar o intervalo para 15 ou até 30 minu-
tos. Convém não usar intervalos de tempo muito longos, já que o atraso no envio de mensagens
de correio pode diminuir o nível de atividade da disciplina.

Em primeiro lugar, teste o script executando-o diretamente a partir do seu navegador:

http://exemplo.com/moodle/admin/cron.php

Em seguida é necessário instalar algum mecanismo para executar o script automaticamente

em intervalos regulares, o que será visto nas seções seguintes.

29
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

6.1.1 Em servidores de alojamento Web

O seu painel de controle Web poderá ter uma página que permita configurar o processo cron.
Por exemplo, no sistemas que usam Cpanel procure um botão que diz "Cron jobs". Aí poderá
inserir os mesmos comandos Unix descritos na seção seguinte.

A partir da linha de comandos em Unix

Existem muitos programas que podemos usar para chamar a página cron.php. Provavelmente
nem todos eles estarão disponíveis no seu servidor. Por exemplo, podemos usar um programa
do Unix como ’wget’:

wget -q -O /dev/null http://exemplo.com/moodle/admin/cron.php

Repare nesse exemplo que a saída do comando é redirecionada (para /dev/null).

A mesma coisa usando lynx:

lynx -dump http://exemplo.com/moodle/admin/cron.php > /dev/null

Uma alternativa é usar uma versão autônoma do PHP, compilada para poder ser executada
diretamente a partir da linha de comandos. A vantagem em fazer isso será que os logs de acesso
ao servidor não serão preenchidos com pedidos constantes do script cron.php. A desvantagem é
que será necessário ter acesso a uma versão do PHP para linha de comandos.

/opt/bin/php /web/moodle/admin/cron.php

Utilização do programa crontab em Unix

O que o Cpanel faz é simplesmente fornecer uma interface Web para uma ferramenta Unix
chamada crontab. Se tiver acesso a um terminal de linha de comandos podemos configurar o
crontab diretamente usando o comando:

crontab -e

e adicionando alguns dos comandos acima assim:

*/5 * * * * wget -q -O /dev/null http://exemplo.com/moodle/admin/cron.php

Normalmente, o comando "contrab"abrirá o ’vi’. Nesse editor entramos no modo de inserção

clicando na tecla "i". Escreva a linha que acabamos de mostrar e finalmente saia do modo de
inserção clicando em ESC. Para gravar e sair escreva ":wq", e para sair sem gravar nenhuma

30
CDTC Centro de Difusão de Tecnologia e Conhecimento Brasil/DF

alteração escreva ":q!"(sem as aspas).

6.1.2 Criação de uma nova disciplina

Agora que a sua instalação do Moodle funciona adequadamente já podemos criar uma disci-
plina.

Selecione "Criar uma nova disciplina"a partir da página de administração (ou a partir dos links
na página principal).

Complete o formulário, com especial atenção para o formato da disciplina. Não é necessário
se preocupar com os detalhes nessa etapa, já que tudo poderá ser alterado mais tarde pelos
professores da disciplina.

Clique em "Gravar alterações"e será direcionado para um novo formulário onde poderá es-
colher professores para a disciplina. Esse formulário só permite adicionar contas de usuários já
existentes - se quiser criar novas contas de professores, peça ao próprio docente para criar uma
conta pessoal, ou criar uma conta para ele por meio da opção "Adicionar novo usuário"na página
de administração.

Uma vez criada, a disciplina ela já está pronta para ser modificada e estará disponível através
da seção de "Disciplinas"na página principal.

31