Instalação do Moodle 18 de abril de PDF
Instalação do Moodle 18 de abril de 2007
Download "Instalação do Moodle 18 de abril de 2007"
Rita Vidal Caldeira
1 Instalação do Moodle 18 de abril de 2007
2 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 Objetivo Público Alvo Pré-requisitos Descrição Metodologia Cronograma Programa Avaliação Bibliografia Lição 1- Introdução Introdução O que é? Vantagens Instalação Requisitos Requisitos Adicionais Instalação dos pacotes principais Usando o comando apt-get Criando usuário no MySQL Criando usuário no MySQL Instalação do pacote Moodle Organização Estrutura do Diretório Script de instalação Verificação das configurações do servidor
3 5 Lição 3-Configuração - Parte II Criação de um diretório de dados Página de Administração Lição 4-Configuração - Parte III Configuração do cron Em servidores de alojamento Web Criação de uma nova disciplina
5 Conteúdo O conteúdo dessa apostila é fruto da compilação de diversos materiais livres publicados na internet, disponíveis em diversos sites ou originalmente produzido no CDTC em 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 desde outubro de Críticas e sugestões construtivas são bem-vindas a qualquer tempo. Autores A autoria deste é de responsabilidade de Tiago Luiz Batista Maciel 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 ou da home page da entidade, através da URL Garantias O material contido nesta apostila é isento de garantias e o seu uso é de inteira responsabilidade 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 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
11 Parte III Instalação do Moodle 10
12 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 comunidade. 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
13 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
14 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 necessá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 corretamente. 2.8 Avaliação Toda a avaliação será feita on-line. Aspectos a serem considerados na avaliação: 13
15 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 corretamente. 14
16 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! 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 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
17 Promove o desenvolvimento social, tendo como conseqüência a colaboração da comunidade e a reflexão; Pode ser usado tanto para o ensino totalmente virtual como para o suporte a turmas presenciais; 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 Requisitos O Moodle é desenvolvido no Linux principalmente usando Apache, MySQL e PHP, mas també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 Windows 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 ou posterior) - A versão PHP 5 (5.1.0 ou posterior) é suportada 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 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
18 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 devidamente 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
19 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
20 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
21 Confirme a senha. Visite o seu site do moodle em 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 é aconselhá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á disponí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 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 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 acrescentados 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
22 # mysql -u root -p > CREATE DATABASE moodle; > GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.* TO 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
23 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 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 Então faça 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. 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 e siga as instruções. 4.2 Organização 22
24 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 O instalador vai tentar instalar um "cookie"para a sessão. Caso apareça uma janela de advertência em seu navegador, verifique se você aceitou o cookie. 23
25 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 Isso é essencial para permitir ligações entre os seus recursos, e também 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 opções do PHP para funcionar corretamente. 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 aplicações que exigem outra configuração diferente, não se preocupe pois será possível INVALIDAR a configuração global. 24
26 Para fazer isso vai ser necessário criar um arquivo.htaccess no diretório principal do Moodle, 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 enviados 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
27 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 evitar 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 arquivos). Se você estiver hospedando o seu Moodle em um servidor não próprio, consulte com o administrador do servidor Web se tiver dificuldades em configurar o seu diretório de forma segura. 26