Instalao do Moodle

18 de abril de 2007

Sumrio
I Sobre essa Apostila 2 4 9
10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 11 11 11 11 12 12 12 12 13 14 14 14 14 15 15 16 16 16 19 21 21 21 22 22 23

II Informaes Bsicas III Instalao do Moodle

1 O que o curso Instalao do Moodle 2 Plano de ensino 2.1 Objetivo . . . 2.2 Pblico Alvo . 2.3 Pr-requisitos 2.4 Descrio . . 2.5 Metodologia . 2.6 Cronograma 2.7 Programa . . 2.8 Avaliao . . 2.9 Bibliograa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 Lio 1- Introduo 3.1 Introduo . . . . . . . . . . . . . 3.1.1 O que ? . . . . . . . . . 3.1.2 Vantagens . . . . . . . . 3.2 Instalao . . . . . . . . . . . . . 3.2.1 Requisitos . . . . . . . . . 3.2.2 Requisitos Adicionais . . 3.3 Instalao dos pacotes principais 3.4 Usando o comando apt-get . . . 3.5 Criando usurio no MySQL . . .

4 Criando usurio no MySQL 4.1 Instalao do pacote Moodle . . . . . . . 4.2 Organizao . . . . . . . . . . . . . . . . 4.3 Estrutura do Diretrio . . . . . . . . . . . 4.4 Script de instalao . . . . . . . . . . . . 4.5 Vericao das conguraes do servidor

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

5 Lio 3-Congurao - Parte II 25 5.1 Criao de um diretrio de dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 5.2 Pgina de Administrao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 6 Lio 4-Congurao - Parte III 6.1 Congurao do cron . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.1.1 Em servidores de alojamento Web . . . . . . . . . . . . . . . . . . . . . . . . 6.1.2 Criao de uma nova disciplina . . . . . . . . . . . . . . . . . . . . . . . . . . 28 28 29 30

Parte I

Sobre essa Apostila

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

Contedo
O contedo dessa apostila fruto da compilao de diversos materiais livres publicados na internet, disponveis em diversos sites ou originalmente produzido no CDTC em http://www.cdtc.org.br. O formato original deste material bem como sua atualizao est disponvel dentro da licena GNU Free Documentation License, cujo teor integral encontra-se aqui reproduzido na seo de mesmo nome, tendo inclusive uma verso traduzida (no ocial). A reviso e alterao vem sendo realizada pelo CDTC (suporte@cdtc.org.br) desde outubro de 2006. Crticas e sugestes construtivas so 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 Difuso de Tecnologia e Conhecimento, que vem sendo realizado pelo ITI (Instituto Nacional de Tecnologia da Informao) 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 pas. Informaes adicionais podem ser obtidas atravs do email ouvidoria@cdtc.org.br, ou da home page da entidade, atravs da URL http://www.cdtc.org.br.

Garantias
O material contido nesta apostila isento de garantias e o seu uso de inteira responsabilidade do usurio/leitor. Os autores, bem como o ITI e seus parceiros, no se responsabilizam direta ou indiretamente por qualquer prejuzo oriundo da utilizao do material aqui contido.

Licena
Copyright 2006, Instituto Nacional de Tecnologia da Informao (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 APOSTILA. A copy of the license is included in the section entitled GNU Free Documentation License.

Parte II

Informaes Bsicas

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

Sobre o CDTC
Objetivo Geral O Projeto CDTC visa a promoo e o desenvolvimento de aes que incentivem a disseminao de solues que utilizem padres abertos e no proprietrios de tecnologia, em proveito do desenvolvimento social, cultural, poltico, tecnolgico e econmico da sociedade brasileira. Objetivo Especco Auxiliar o Governo Federal na implantao do plano nacional de software no-proprietrio e de cdigo fonte aberto, identicando e mobilizando grupos de formadores de opinio dentre os servidores pblicos e agentes polticos da Unio Federal, estimulando e incentivando o mercado nacional a adotar novos modelos de negcio da tecnologia da informao e de novos negcios de comunicao com base em software no-proprietrio e de cdigo fonte aberto, oferecendo treinamento especco para tcnicos, prossionais de suporte e funcionrios pblicos usurios, criando grupos de funcionrios pblicos que iro treinar outros funcionrios pblicos e atuar como incentivadores e defensores de produtos de software no proprietrios e cdigo fonte aberto, oferecendo contedo tcnico on-line para servios de suporte, ferramentas para desenvolvimento de produtos de software no proprietrios e de seu cdigo fonte livre, articulando redes de terceiros (dentro e fora do governo) fornecedoras de educao, pesquisa, desenvolvimento e teste de produtos de software livre.

Guia do aluno
Neste guia, voc ter reunidas uma srie de informaes importantes para que voc comece seu curso. So elas: Licenas para cpia de material disponvel Os 10 mandamentos do aluno de Educao a Distncia Como participar dos foruns e da wikipdia Primeiros passos muito importante que voc entre em contato com TODAS estas informaes, seguindo o roteiro acima.

Licena
Copyright 2006, Instituto Nacional de Tecnologia da Informao (cdtc@iti.gov.br). 6

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

dada permisso para copiar, distribuir e/ou modicar este documento sob os termos da Licena de Documentao Livre GNU, Verso 1.1 ou qualquer verso posterior pblicada pela Free Software Foundation; com o Capitulo Invariante SOBRE ESSA APOSTILA. Uma cpia da licena est inclusa na seo entitulada "Licena de Documentao Livre GNU".

Os 10 mandamentos do aluno de educao online

1. Acesso Internet: ter endereo eletrnico, um provedor e um equipamento adequado pr-requisito para a participao nos cursos a distncia. 2. Habilidade e disposio para operar programas: ter conhecimentos bsicos de Informtica necessrio para poder executar as tarefas. 3. Vontade para aprender colaborativamente: interagir, ser participativo no ensino a distncia conta muitos pontos, pois ir colaborar para o processo ensino-aprendizagem pessoal, dos colegas e dos professores. 4. Comportamentos compatveis com a etiqueta: mostrar-se interessado em conhecer seus colegas de turma respeitando-os e fazendo ser respeitado pelo mesmo. 5. Organizao pessoal: planejar e organizar tudo fundamental para facilitar a sua reviso e a sua recuperao de materiais. 6. Vontade para realizar as atividades no tempo correto: anotar todas as suas obrigaes e realiz-las em tempo real. 7. Curiosidade e abertura para inovaes: aceitar novas idias e inovar sempre. 8. Flexibilidade e adaptao: requisitos necessrio mudana tecnolgica, aprendizagens e descobertas. 9. Objetividade em sua comunicao: comunicar-se de forma clara, breve e transparente ponto - chave na comunicao pela Internet. 10. Responsabilidade: ser responsvel por seu prprio aprendizado. O ambiente virtual no controla a sua dedicao, mas reete os resultados do seu esforo e da sua colaborao.

Como participar dos fruns e Wikipdia

Voc tem um problema e precisa de ajuda? Podemos te ajudar de 2 formas: A primeira o uso dos fruns de notcias e de dvidas gerais que se distinguem pelo uso: . O frum de notcias tem por objetivo disponibilizar um meio de acesso rpido a informaes que sejam pertinentes ao curso (avisos, notcias). As mensagens postadas nele so enviadas a 7

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

todos participantes. Assim, se o monitor ou algum outro participante tiver uma informao que interesse ao grupo, favor post-la aqui. Porm, se o que voc deseja resolver alguma dvida ou discutir algum tpico especco do curso. recomendado que voc faa uso do Forum de dvidas gerais que lhe d recursos mais efetivos para esta prtica. . O frum de dvidas gerais tem por objetivo disponibilizar um meio fcil, rpido e interativo para solucionar suas dvidas e trocar experincias. As mensagens postadas nele so enviadas a todos participantes do curso. Assim, ca muito mais fcil obter respostas, j que todos podem ajudar. Se voc receber uma mensagem com algum tpico que saiba responder, no se preocupe com a formalizao ou a gramtica. Responda! E no se esquea de que antes de abrir um novo tpico recomendvel ver se a sua pergunta j foi feita por outro participante. A segunda forma se d pelas Wikis: . Uma wiki uma pgina web que pode ser editada colaborativamente, ou seja, qualquer participante pode inserir, editar, apagar textos. As verses antigas vo 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 "Wikipdia", uma experincia grandiosa de construo de uma enciclopdia de forma colaborativa, por pessoas de todas as partes do mundo. Acesse-a em portugus pelos links: Pgina principal da Wiki - http://pt.wikipedia.org/wiki/ Agradecemos antecipadamente a sua colaborao com a aprendizagem do grupo!

Primeiros Passos
Para uma melhor aprendizagem recomendvel que voc siga os seguintes passos: Ler o Plano de Ensino e entender a que seu curso se dispe a ensinar; Ler a Ambientao do Moodle para aprender a navegar neste ambiente e se utilizar das ferramentas bsicas do mesmo; Entrar nas lies seguindo a seqncia descrita no Plano de Ensino; Qualquer dvida, reporte ao Frum de Dvidas Gerais.

Perl do Tutor
Segue-se uma descrio do tutor ideal, baseada no feedback de alunos e de tutores. O tutor ideal um modelo de excelncia: consistente, justo e prossional nos respectivos valores e atitudes, incentiva mas honesto, imparcial, amvel, positivo, respeitador, aceita as idias dos estudantes, paciente, pessoal, tolerante, apreciativo, compreensivo e pronto a ajudar. 8

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

A classicao por um tutor desta natureza proporciona o melhor feedback possvel, crucial, e, para a maior parte dos alunos, constitui o ponto central do processo de aprendizagem. Este tutor ou instrutor: fornece explicaes claras acerca do que ele espera, e do estilo de classicao que ir utilizar; gosta que lhe faam perguntas adicionais; identica as nossas falhas, mas corrige-as amavelmente, diz um estudante, e explica porque motivo a classicao foi ou no foi atribuda; tece comentrios completos e construtivos, mas de forma agradvel (em contraste com um reparo de um estudante: os comentrios deixam-nos com uma sensao de crtica, de ameaa e de nervossismo) d uma ajuda complementar para encorajar um estudante em diculdade; esclarece pontos que no foram entendidos, ou corretamente aprendidos anteriormente; ajuda o estudante a alcanar os seus objetivos; exvel quando necessrio; mostra um interesse genuno em motivar os alunos (mesmo os principiantes e, por isso, talvez numa fase menos interessante para o tutor); escreve todas as correes de forma legvel e com um nvel de pormenorizao adequado; acima de tudo, devolve os trabalhos rapidamente;

Parte III

Instalao do Moodle

10

Captulo 1

O que o curso Instalao do Moodle

O Moodle um pacote criado com o objetivo de desenvolver o ensino a distncia na comunidade. Com uma innidade de ferramentas ele auxilia professores e alunos a tornarem esse tipo de aprendizado o mais semelhante possvel dos mtodos tradicionais de ensino.

11

Captulo 2

Plano de ensino

2.1 Objetivo
Capacitar o usurio para instalar o Moodle e as ferramentas necessrias para que ele funcione corretamente.

2.2 Pblico Alvo

Usurios nais ou novatos que desejam migrar os seus sistemas proprietrios para software livre, em especial aos interessados no ensino a distncia.

2.3 Pr-requisitos
Os usurios devero ser, necessariamente, funcionrios pblicos e ter conhecimentos bsicos para operar um computador. desejvel que o aluno tenha algum conhecimento em servidores web e banco de dados.

2.4 Descrio
O curso ser realizado na modalidade Educao a Distncia e utilizar a Plataforma Moodle como ferramenta de aprendizagem. O curso tem durao de uma semana e possui um conjunto de atividades (lies, fruns, glossrios, questionrios e outros) que devero ser executadas de acordo com as instrues fornecidas. O material didtico est disponvel on-line de acordo com as datas pr-estabelecidas em cada tpico.

12

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

2.5 Metodologia
O curso est dividido da seguinte maneira:

2.6 Cronograma

Lio 1 - Introduo e instalao das ferramentas necessrias Lio 2 - Congurao I Lio 3 - Congurao II Lio 4 - Congurao III As lies contm o contudo principal. Elas podero ser acessadas quantas vezes forem necessrias, desde que esteja dentro da semana programada. Ao nal de uma lio, voc receber uma nota de acordo com o seu desempenho. Responda com ateno s perguntas de cada lio, pois elas sero consideradas na sua nota nal. Caso sua nota numa determinada lio for menor do que 6.0, sugerimos que voc faa novamente esta lio. Ao nal do curso ser disponibilizada a avaliao referente ao curso. Tanto as notas das lies quanto a da avaliao sero consideradas para a nota nal. Todos os mdulos caro visveis para que possam ser consultados durante a avaliao nal. Aconselhamos a leitura da "Ambientao do Moodle"para que voc conhea a plataforma de Ensino a Distncia, evitando diculdades advindas do "desconhecimento"sobre a mesma. Os instrutores estaro a sua disposio ao longo de todo curso. Qualquer dvida dever ser enviada no frum. Diariamente os monitores daro respostas e esclarecimentos.

2.7 Programa
O curso Instalao do Moodle oferecer o seguinte contedo: Instalao e congurao do pacote, Instalao e congurao das ferramentas necessrias para que o Moodle funcione corretamente.

2.8 Avaliao
Toda a avaliao ser feita on-line. Aspectos a serem considerados na avaliao: 13

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

Iniciativa e autonomia no processo de aprendizagem e de produo de conhecimento; Capacidade de pesquisa e abordagem criativa na soluo dos problemas apresentados. Instrumentos de avaliao: Participao ativa nas atividades programadas. Avaliao ao nal do curso. O participante far vrias avaliaes referente ao contedo do curso. Para a aprovao e obteno do certicado o participante dever obter nota nal maior ou igual a 6.0 de acordo com a frmula abaixo: Nota Final = ((ML x 7) + (AF x 3)) / 10 = Mdia aritmtica das lies AF = Avaliaes

2.9 Bibliograa

Instalao e congurao das ferramentas necessrias para que o Moodle funcione corretamente.

14

Captulo 3

Lio 1- Introduo
Nessa lio, alm de mostrar o que o pacote Moodle, iremos instalar algumas ferramentas necessrias para que ele funcione corretamente.

3.1 Introduo
Esse guia explica como instalar o Moodle pela primeira vez. Para alguns usurios, nos passos seguintes, o contedo se torna bem detalhado, com o objetivo de cobrir a maioria das possveis conguraes de servidores. A instalao dessa ferramenta no tem nenhum mistrio. Com o entendimento do material aqui mostrado vo ser necessrios apenas alguns minutos para que ela seja concluda. Aproveite!

3.1.1 O que ?
Inicialmente Moodle signicava "Modular Object-Oriented Dynamic Learning Environment". Esse um pacote com vrios programas interligados com o objetivo de tornar possvel o ensino via web. Suas caractersticas mais valiosas so que ele livre e Open Source, distribudo sob a licena 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 atualizao de uma verso para uma mais nova feita de forma bem simples, uma vez que sua organizao permite que muitas das mudanas sejam feitas automaticamente; Suporte a vrios tipos de banco de dados, incluindo os mais populares do mercado; Preocupao especial com a integridade dos dados; 15

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

Promove o desenvolvimento social, tendo como conseqncia a colaborao da comunidade e a reexo; Pode ser usado tanto para o ensino totalmente virtual como para o suporte a turmas presenciais; Interface compatvel com qualquer browser; Apresentao clara e objetiva, facilitando tanto o uso dos desenvolvedores quanto do usurio nal.

3.2 Instalao
Vamos voltar ao principal objetivo do nosso curso, a instalao do Moodle. Veremos que apesar dessa tarefa ser bem simples devemos tomar alguns cuidados para que tudo funcione corretamente. A seguir, sero mostrados alguns requisitos necessrios 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 tambm regularmente testado com PostgreSQL e nos sistemas Windows XP, MacOS X e Netware 6. Os requisitos necessrios para a ferrameta so os seguintes: Servidor web instalado e congurado - O comum seria o Apache, mas o Moodle trabalha corretamente com qualquer servidor web que suporte PHP, como ISS na plataforma Windows por exemplo. O PHP impe alguns requisitos necessrios para que tudo funcione corretamente. Assim, sendo uma boa medida seria usar a verso mais nova possvel do servidor escolhido; Linguagem PHP (verso 4.1.0 ou posterior) - A verso PHP 5 (5.1.0 ou posterior) suportada pelo Moodle 1.4. A partir do Moodle 1.6 a verso mnima do PHP exigida ser a 4.3.0; Servidor de banco de dados - O MySQL ou o PostgreSQL so totalmente suportados e at mesmo recomendados para serem usados com o Moodle. Para o Moodle 1.5 o mnimo o MySQL 3.23, enquanto que para o 1.6 o exigido o MySQL 4.1.16. J para o PostgreSQL o mnimo a verso 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 no as suporte entre em contato com os responsveis para saber o motivo. Alm disso, uma boa dica mudar de empresa. Caso voc deseja instalar o Moodle no seu computador pessoal vai ser necessrio a instalao dos pacotes aqui citados (Apache, MySQL e PHP), o que pode ser feito facilmente com o auxlio de guias disponveis na internet.

16

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

3.2.2 Requisitos Adicionais

Extenses PHP GD library e FreeType 2 library - Bibliotecas Linux/Unix que permitem a visualizao de grcos dinmicos que as pginas logs produzem; Mbstring - exigido para manipulao; A extenso mysql necessria no caso de voc estar usando esse servidor de banco de dados. Observe que nas distribuies Linux (em especial Red Hat) essa instalao opcional; A extenso pgsql necessria se voc estiver usando o PostgreSQL; A extenso zlib necessria para funes de compactao e descompactao (zip/unzip); Outras extenses PHP podem ser necessrias para que seja possvel o suporte a algumas funcionalidades opcionais do Moodle, especialmente autenticaes externas.

3.3 Instalao dos pacotes principais

Como vimos na etapa anterior necessrio ter um servidor e um banco de dados devidamente congurados 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 distribuio 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 Aps esses comandos, digite agora os comandos responsveis pela a instalao do moodle mostrados a seguir: apt-get install moodle

17

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

Lembre-se de que o diretrio 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 mquina onde o Moodle est sendo instalado, deixe "localhost"como o servidor do banco de dados.

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

18

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

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

Conrme 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 Difuso de Tecnologia e Conhecimento

Brasil/DF

Conrme a senha.

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

3.5 Criando usurio no MySQL

Ser necessrio criar um banco de dados (por exemplo "moodle") vazio no seu sistema de banco de dados, junto com um usurio especial (por exemplo "moodleuser") que tenha acesso a esse banco (e a nenhum outro). Voc pode usar o usurio "root"se quiser, mas isso no aconselhvel 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 car em risco, em vez de colocar em risco apenas um deles. Se voc estiver utilizando um servidor hospedeiro de pginas Web provavelmente estar disponvel 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 Cpanel 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 usurio e contrasenha em seus respectivos campos, e clique em "Add User". (No use os mesmos dados j usados em algum outro servio) 4. Agora use o boto "Add User to Database"para dar a esse usurio permisses de acesso ao novo banco de dados. 5. Observe que ao nome do usurio e ao nome do banco de dados podem ter sido acrescentados um prexo com o nome da sua conta no Cpanel. Quando precisar dessa informao no instalador do Moodle vai ser necessrio usar os nomes completos, incluindo os prexos. 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 Difuso de Tecnologia e Conhecimento

Brasil/DF

# mysql -u root -p > CREATE DATABASE moodle; > GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.* 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

Captulo 4

Criando usurio no MySQL

Aqui, vamos apresentar como essa ferramenta se organiza, alm de vericar as conguraes das ferramentas instaladas no passo anterior.

4.1 Instalao do pacote Moodle

Depois de realizar as lies anteriores e ter certeza de que nosso servidor e o nosso banco de dados est funcionando corretamente nalmente vamos instalar o pacote Moodle. Acesse o site http://download.moodle.org e faa o download da verso 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 tambm usar qualquer interface grca como le-roller ou ark. Aps descompactar o arquivo, voc ter um diretrio chamado moodle. Agora, suponha que voc queira instalar o moodle em /var/www/moodle (isto signica que o moodle estar acessvel em http://localhost/moodle). Ento faa mv moodle /var/www/ (provavelmente 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. Faa o login como root (se voc ainda no 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 endereo http://localhost/moodle e siga as instrues.

4.2 Organizao

22

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

4.3 Estrutura do Diretrio

Temos aqui um breve sumrio mostrando o contedo do diretrio principal do Moodle. Com ele ser possvel entender como essa ferramenta estruturada. cong.php - contm as conguraes bsicas. Observe que esse arquivo no vem com o Moodle. Ele deve ser criado. install.php - Esse vai ser o script a ser executado para que o cong.php seja criado. version.php - Dene a verso atual do cdigo do Moodle. index.php - A pgina principal do site. admin/ - cdigo para administrar todo o servidor. auth/ - mdulos para a autenticao dos usurios. blocks/ - mdulos para os pequenos blocos laterais em vrias pginas. calendar/ - todo o cdigo para gerncia e visualizao dos calendrios. course/ - cdigo para mostrar e gerenciar cursos. doc/ - documentao de ajuda a respeito do Moodle. les/ - cdigo para mostrar e gerenciar arquivos carregados. lang/ - textos em lnguas diferentes, onde temos um diretrio por lngua. lib/ - bibliotecas dos cdigos do Moodle. login/ - cdigo para criao de contas e acesso via login. mod/ - todos os mdulos principais dos cursos esto aqui pix/ - imagens genricas do site theme/ - pacotes de temas (theme/skins) para mudar a aparncia do site user/ - cdigo para mostrar e gerenciar usurios.

4.4 Script de instalao

Para criar o cong.php necessrio executar o script de instalao (install.php). Para fazer isso, verique se possvel o acesso URL principal do seu Moodle usando um navegador web. Outra opo, seria fazer o acesso direto http://yourserver/install.php. O instalador vai tentar instalar um "cookie"para a sesso. Caso aparea uma janela de advertncia em seu navegador, verique se voc aceitou o cookie.

23

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

O Moodle vai detectar que necessrio fazer algumas conguraes e vai nos guiar atravs de pginas que vo auxiliar na criao do novo arquivo de congurao chamado cong.php. No nal do processo a ferramenta vai escrever o arquivo no local correto. Do contrrio, podemos pressionar o boto para fazer o download do instalador e depois carregar o cong.php no diretrio principal do Moodle no servidor. Ao longo do processo, o instalador vai testar o ambiente de trabalho do seu servidor e dar sugestes a respeito de como resolver possveis problemas.

4.5 Vericao das conguraes do servidor

Em primeiro lugar, devemos ter certeza que o nosso servidor est congurado para usar o index.php como pgina padro (talvez alm disso o index.html e default.htm ). No Apache, isso feito usando um parmetro 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 incio, para aumentar a ecincia). O segundo passo, no caso de voc estar usando o Apache 2, ativar a varivel AcceptPathInfo, que permite que o script passe argumentos do tipo http://servidor/arquivo.php/arg1/arg2 . Isso essencial para permitir ligaes entre os seus recursos, e tambm para melhorar a performance 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 opes do PHP para funcionar corretamente. Na maior parte dos servidores essas opes j estaro ativas por padro. No entanto, alguns servidores PHP (especialmente nas verses mais recentes) podero estar conguradas de forma diferente. Essas opes so ativadas no arquivo de congurao do PHP (normalmente o php.ini):

magic_quotes_gpc = 1 (preferred but not necessary) magic_quotes_runtime = 0 (necessary) le_uploads = 1 session.auto_start = 0 session.bug_compat_warn = 0

Se no tiver acesso a httpd.conf ou php.ini no seu servidor, ou se estiver usando outras aplicaes que exigem outra congurao diferente, no se preocupe pois ser possvel INVALIDAR a congurao global.

24

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

Para fazer isso vai ser necessrio criar um arquivo .htaccess no diretrio principal do Moodle, com as denies necessrias. Isso s funcionar no Apache e alm disso quando a opo Overrides estiver ativa na congurao global do servidor. O contedo de .htacces ser:

DirectoryIndex index.php index.html index.htm AcceptPathInfo on php_ag magic_quotes_gpc 1 php_ag magic_quotes_runtime 0 php_ag le_uploads 1 php_ag session.auto_start 0 php_ag session.bug_compat_warn 0

Podemos fazer outras coisas como, por exemplo, limitar o tamanho mximo dos arquivos enviados para o Moodle:

LimitRequestBody 0 php_value upload_max_lesize 2M php_value post_max_size 2M

O mais fcil ser copiar o arquivo de lib/htaccess e edit-lo para adapt-lo s suas necessidades (o arquivo contm algumas dicas adicionais). Por exemplo, num shell do Unix: cp lib/htaccess .htaccess

25

Captulo 5

Lio 3-Congurao - Parte II

Nessa etapa, sero dadas algumas dicas de como armazenar os dados enviados pelos usurios do sistema. Alm disso, vamos ver algumas das vrias atribuies do administrador.

5.1 Criao de um diretrio de dados

O Moodle vai precisar de algum espao no seu disco rgido para armazenar arquivos enviados como, por exemplo, os documentos associados a uma disciplina e as fotograas dos usurios. O instalador tentar criar esse diretrio para voc, mas se no conseguir ser necessrio cri-lo manualmente. Por razes de segurana, conveniente que esse diretrio NO seja acessvel diretamente atravs da web. A forma mais simples de garantir isso ser criar o diretrio FORA do diretrio raiz do seu servidor Web; se assim no for, ele deve ser protegido criando um arquivo .htaccess com o seguinte contedo: deny from all Para garantir que o Moodle vai poder gravar nesse diretrio os arquivos recebidos, conra se o servidor Web (por exemplo o Apache) tem autorizao para escrever nessa pasta. Em plataformas Unix, isso implica em mudar o proprietrio do diretrio para algo como "nobody", "www-data"ou "apache", dando a esse usurio permisses para ler, escrever e executar arquivos no diretrio de dados. Nos sistemas que usam Cpanel podemos usar o "File Manager"para encontrar o diretrio, 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 evitar que outros usurios do servidor possam consultar ou modicar os seus arquivos, mas permitir acesso de leitura/escritura para outros usurios (assim o servidor Web ter acesso aos seus arquivos). Se voc estiver hospedando o seu Moodle em um servidor no prprio, consulte com o administrador do servidor Web se tiver diculdades em congurar o seu diretrio de forma segura. 26

CDTC

Centro de Difuso 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 diretrio pessoalmente.

5.2 Pgina de Administrao

Para continuar a fazer as conguraes visite a pgina de administrao. Aps o arquivo bsico cong.php ter sido criado, quando voc tentar acessar a pgina principal do seu servidor Moodle ser redirecionado automaticamente para a pgina "admin"para continuar a instalao. A primeira vez que voc entrar nessa pgina de administrao vai ser apresentada a licena GPL, que dever aceitar para poder continuar com a instalao. A seguir o Moodle vai congurar a sua base de infomaes criando as tabelas que sero usadas para guardar seus dados. Primeiro so criadas as principais. Nessa etapa, sero apresentados vrios comandos SQL seguidos por mensagens de diagnstico (verde ou vermelho) do gnero: CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category int(10) unsigned 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, format 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, timemodied int(10) unsigned NOT NULL default 0, PRIMARY KEY (id)) TYPE=MyISAM SUCCESS ...etc, seguidas por: banco de dados principal congurado com sucesso. Se no aparecerem essas mensagens sinal que existe algum problema com a banco de dados ou com a congurao que deniu em cong.php. Verique se o PHP no est em "Modo seguro"("Safe Mode". Alguns servidores comerciais costumam vir em modo seguro). Tambm podemos vericar as variveis do PHP criando um pequeno arquivo que contenha <?php phpinfo() ?> e vericando com o seu navegador Web. Observe o resultado e tente acessar novamente a pgina de administrao e em seguida avance at o m da pgina e clique no boto "Continuar". Nessa etapa dever aparecer um formulrio onde podemos denir mais variveis de congurao para a sua instalao como, por exemplo, a lngua usada por padro, o nome do servidor SMTP, etc. No se preocupe muito em tentar congurar tudo na primeira vez - possvel regressar a esta pgina sempre que quiser, atravs da interface de administrao. Os valores por padro foram selecionados para serem teis e sucientemente seguros na maioria dos servidores. Avance at o m da pgina e clique no boto "Gravar alteraes".

27

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

Se no conseguir passar dessa pgina (e unicamente nesse caso), provavelmente, o seu servidor tem o problema que chamamos de "buggy referrer". Isso fcil de corrigir: simplesmente desative a opo (secureforms"), e tente novamente. A seguir, ver mais pginas que imprimem muitas mensagens de diagnstico medida que so conguradas vrias outras tabelas usadas pelos mdulos do Moodle. Como no caso das tabelas bsicas, todas as mensagens de diagnstico devem aparecer em verde. Avance at o m da pgina e clique no boto "Continuar". A pgina seguinte um formulrio onde podemos denir parmetros para o seu site e para a pgina principal, tais como o nome, formato, descrio, etc. Complete esse formulrio (lembrando que possvel voltar para fazer possveis alteraes) e clique em "Gravar alteraes". Finalmente, vai ser pedido a criao de um usurio administrador de alto nvel para futuros acessos s pginas de administrao. Complete a informao com o seu prprio nome, endereo de correio eletrnico, etc e clique em "Gravar alteraes". Nem todos os campos so indispensveis, mas se esquecer algum importante o formulrio voltar a aparecer. Tenha o cuidado de lembrar o nome do usurio e a senha que escolheu para o administrador, j que eles sero necessrios para acessar as pginas de administrao em ocasies futuras. (Se por qualquer razo a sua instalao for interrompida, ou aparecer algum erro que lhe impea de entrar com a senha do administrador, normalmente vai ser possvel acessar com o nome de administrador como "admin"e senha "admin".) Uma vez concludo esse processo com sucesso, ser apresentada a pgina principal do seu site. Repare no menu de administrao no lado esquerdo da pgina (os mesmos itens do menu aparecem na pgina de administrao) - esse menu s visvel quando entramos como administrador. Todas as conguraes necessrias a partir de agora podero ser feitas a partir desse menu, como por exemplo:

criao e eliminao de disciplinas criao e modicao de contas de usurios gesto de contas de docentes mudana de opes globais como o tema, lngua, etc Mas a instalao ainda no terminou! Existe ainda um passo importante no processo de instalao (veja a prxima seo sobre o cron).

28

Captulo 6

Lio 4-Congurao - Parte III

Para nalizar, vamos conhecer esse script, responsvel pela execuo de tarefas peridicas.

6.1 Congurao do cron

Alguns dos mdulos do Moodle precisam de vericaes freqentes para realizar algumas tarefas. Por exemplo, o Moodle precisa vericar os fruns de discusso para saber se preciso enviar por email cpias de novas contribuies aos assinantes do frum. O script que executa essas tarefas encontra-se no diretrio admin, com o nome cron.php. No entanto, ele no 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 mecanismo pode ser encarado como as "pulsaes cardacas"necessrias para que o script possa executar as tarefas denidas por cada mdulo. Esse tipo de sistema de execuo peridica de tarefas conhecido como servio cron. importante salientar que a mquina que executa o cron no precisa ser a mesma mquina onde Moodle est instalado. Por exemplo, se tiver um servidor web com algumas limitaes, que no tem o programa cron, possvel executar o cron em outra mquina ou at no seu computador em casa. O importante que o arquivo cron.php seja chamado regularmente. Carregar esse script no uma tarefa cara, de maneira que 5 minutos um intervalo de tempo razovel, mas se estiver achar necessrio pode alterar o intervalo para 15 ou at 30 minutos. Convm no usar intervalos de tempo muito longos, j que o atraso no envio de mensagens de correio pode diminuir o nvel 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 necessrio instalar algum mecanismo para executar o script automaticamente em intervalos regulares, o que ser visto nas sees seguintes.

29

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

6.1.1 Em servidores de alojamento Web

O seu painel de controle Web poder ter uma pgina que permita congurar o processo cron. Por exemplo, no sistemas que usam Cpanel procure um boto que diz "Cron jobs". A poder inserir os mesmos comandos Unix descritos na seo seguinte.

A partir da linha de comandos em Unix Existem muitos programas que podemos usar para chamar a pgina cron.php. Provavelmente nem todos eles estaro disponveis 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 sada 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 verso autnoma 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 no sero preenchidos com pedidos constantes do script cron.php. A desvantagem que ser necessrio ter acesso a uma verso do PHP para linha de comandos. /opt/bin/php /web/moodle/admin/cron.php

Utilizao 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 congurar 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 insero clicando na tecla "i". Escreva a linha que acabamos de mostrar e nalmente saia do modo de insero clicando em ESC. Para gravar e sair escreva ":wq", e para sair sem gravar nenhuma

30

CDTC

Centro de Difuso de Tecnologia e Conhecimento

Brasil/DF

alterao escreva ":q!"(sem as aspas).

6.1.2 Criao de uma nova disciplina

Agora que a sua instalao do Moodle funciona adequadamente j podemos criar uma disciplina. Selecione "Criar uma nova disciplina"a partir da pgina de administrao (ou a partir dos links na pgina principal). Complete o formulrio, com especial ateno para o formato da disciplina. No necessrio se preocupar com os detalhes nessa etapa, j que tudo poder ser alterado mais tarde pelos professores da disciplina. Clique em "Gravar alteraes"e ser direcionado para um novo formulrio onde poder escolher professores para a disciplina. Esse formulrio s permite adicionar contas de usurios j existentes - se quiser criar novas contas de professores, pea ao prprio docente para criar uma conta pessoal, ou criar uma conta para ele por meio da opo "Adicionar novo usurio"na pgina de administrao. Uma vez criada, a disciplina ela j est pronta para ser modicada e estar disponvel atravs da seo de "Disciplinas"na pgina principal.

31