Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Updated to the new version.

  • Loading branch information...
commit bf34f54208232f56044752c93274c3b79ce61691 1 parent ea87612
authored May 09, 2005

Showing 1 changed file with 563 additions and 522 deletions. Show diff stats Hide diff stats

  1. 1,085  lang/pt/docs/install.html
1,085  lang/pt/docs/install.html
... ...
@@ -1,523 +1,564 @@
1  
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2  
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3  
-<html xmlns="http://www.w3.org/1999/xhtml">
4  
-<head>
5  
-    
6  
-<title>Documentação do Moodle: Instalação Básica</title>
7  
-  
8  
-<link rel="stylesheet" href="docstyles.css" type="TEXT/CSS" />
9  
-    
10  
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
11  
-
12  
-<style type="text/css">
13  
-<!--
14  
-.style3 {color: #660000}
15  
--->
16  
-</style>
17  
-</head>
18  
-
19  
-<body>
20  
-<h1>Instalação do Moodle</h1>
21  
-<h2>Não tenha medo! <img src="http://moodle.org/pix/s/smiley.gif" /></h2>
22  
-<blockquote>
23  
-<p>Este guia explica como instalar Moodle pela primeira vez. Alguns dos
24  
-passos são explicados com maior detalhe, para abrangir todas as pequenas
25  
-diferenças entre diferentes configurações dos navegadores, fazendo este
26  
-documento parecer comprido e complicado. Não se deixe desanimar por
27  
-isso - eu costumo instalar o Moodle em poucos minutos!</p>
28  
-<p>Se tiver problemas, por favor leia este documento cuidadosamente. Se
29  
-ainda tiver problemas, pode pedir ajuda em <a target="_blank"
30  
-href="http://moodle.org/help">"Moodle Help"</a>.</p>
31  
-<p>Outra possibilidade é entrar em contacto com alguma companhia de
32  
-<a target="_blank" href="http://moodle.com/hosting/">alojamento de servidores
33  
-Web</a>, que faça a muntenção do Moodle para si, para que se possa
34  
-concentrar nos aspectos didácticos sem perde tempo com problemas técnicos!
35  
-</p>
36  
-<p>Secções neste documento:</p>
37  
-  <ol>
38  
-    <li><a href="#requirements">Requisitos</a></li>
39  
-    <li><a href="#downloading">Obtenção do código do Moodle</a></li>
40  
-    <li><a href="#site">Estrutura do sítio</a></li>
41  
-    <li><a href="#installer">Execução do script de instalação para
42  
-               criar config.php</a>
43  
-      <ul>
44  
-        <li><a href="#webserver">Verificação da configuração do servidor Web</a></li>
45  
-        <li><a href="#database">Criação de uma base de dados</a></li>
46  
-        <li><a href="#data">Criação de um directório de dados</a></li>
47  
-      </ul>
48  
-    </li>
49  
-    <li><a href="#admin">Visita à página de administração para continuar a
50  
-          configuração</a></li>
51  
-    <li><a href="#cron">Configuração do cron</a></li>
52  
-    <li><a href="#course">Criação de uma nova disciplina</a></li>
53  
-  </ol>
54  
-</blockquote>
55  
-<h3 class="sectionheading"><a name="requirements"></a>1. Requisitos</h3>
56  
-<blockquote> 
57  
-  <p>Moodle é desenvolvido principalmente em Linux, usando Apache, MySQL e
58  
-    PHP (a combinação comumente designada de plataforma LAMP), mas também é
59  
-    testado regularmente com PostgreSQL e nos sistemas operativos Windows XP,
60  
-    Mac OS X e Netware 6.</p>
61  
-  <p>Os requisitos do Moodle são:</p>
62  
-  <ol>
63  
-    <li>Servidor Web. A maioria das pessoas usam
64  
-      <a href="http://www.apache.org/" target="_blank">Apache</a>, mas Moodle
65  
-      deveria funcionar com qualquer servidor Web que suporte PHP, como, por
66  
-      exemplo, IIS nas plataformas Windows.</li>
67  
-    <li>A linguagem <a href="http://www.php.net/" target="_blank">PHP</a>
68  
-      (versão 4.1.0 ou superior). A partir de Moodle 1.4 já é possível usar PHP 5.
69  
-    </li>
70  
-    <li>Servidor de bases de dados: Moodle funciona perfeitamente com
71  
-      <a href="http://www.mysql.com/" target="_blank">MySQL</a> 
72  
-      ou <a href="http://www.postgresql.org/" target="_blank">PostgreSQL</a>
73  
-      que são as duas opções recomendadas em Moodle.</li>
74  
-  </ol>
75  
-  <p>A maior parte dos fornecedores de serviços Web incluim todo esse software.
76  
-    Se o seu fornecedor for um dos poucos que não inclui essas opções,
77  
-    pergunte porque não o fazem e considere uma mudança de fornecedor.</p>
78  
-  <p>Se quiser usar Moodle no seu próprio computador e a instalação de todo
79  
-    esse software parece-lhe complicada, consulte o nosso guia:
80  
-    <a href="http://moodle.org/doc/?file=installamp.html">Instalação de 
81  
-    Apache, MySQL e PHP</a>. Nesse guia encontrará instrucções passo a passo
82  
-    para as plataformas mais populares.</p>
83  
-</blockquote>
84  
-<h3 class="sectionheading"><a name="downloading"></a>2. Obtenção do código do Moodle</h3>
85  
-<blockquote>
86  
-  <p>Existem duas formas de obter o Moodle, num ficheiro comprimido ou através
87  
-   do CVS. Essas duas formas explicam-se com mais detalhe na página web:
88  
-   <a href="http://moodle.org/download/" target="_blank">http://moodle.org/download/</a></p>
89  
-  <p>Depois de copiar e desempacotar o arquivo, ou depois de ter obtido uma
90  
-   cópia do CVS, deverá ter um directório "moodle", que contém
91  
-   vários ficheiros e subdirectórios.</p>
92  
-  <p>Pode transferir esse directório directamente para o directório raiz do
93  
-    seu servidor web, e nesse caso o seu sítio ficará disponível em
94  
-    <b>http://o_seu_servidor/moodle</b>, ou pode copiar o conteúdo do
95  
-    directório moodle directamente para o directório raiz do seu servidor web,
96  
-    ficando a sua instalação do Moodle dierectamente em
97  
-    <b>http://o_seu_servidor</b>.</p>
98  
-  <p>Se estiver a copiar o Moodle para o seu computador para depois transferí-lo
99  
-    para o servidor Web, é melhor enviar o arquivo completo num único ficheiro
100  
-    e depois desempacotá-lo no servidor Web. A maior parte das interfaces
101  
-    usadas nos serviços de alojamento de páginas web, por exemplo o Cpanel,
102  
-    permitem-lhe descomprimir arquivos com o "File Manager".</p>
103  
-</blockquote>
104  
-<h3 class="sectionheading"><a name="site"></a>3. Estrutura do sítio</h3>
105  
-<blockquote>
106  
-  <p>Pode passar à frente desta secção, mas fica já aqui um sumário do conteúdo
107  
-   do directório moodle, para o ajudá-lo a se orientar:</p>
108  
-  <blockquote>
109  
-    <table>
110  
-      <tr>
111  
-        <td width="130" valign="top">config.php</td>
112  
-        <td valign="top">-</td>
113  
-        <td valign="top">
114  
-          contém as configurações básicas. Este ficheiro não vem em Moodle,
115  
-          mas é criado durante o processo de instalação.
116  
-        </td>
117  
-      </tr>
118  
-      <tr>
119  
-        <td valign="top">install.php</td>
120  
-        <td valign="top">-</td>
121  
-        <td valign="top">o scritp que deverá executar para criar config.php </td>
122  
-      </tr>
123  
-      <tr>
124  
-        <td valign="top">version.php</td>
125  
-        <td valign="top">-</td>
126  
-        <td valign="top">
127  
-          define a versão actual do código do Moodle
128  
-        </td>
129  
-      </tr>
130  
-      <tr>
131  
-        <td valign="top">index.php</td>
132  
-        <td valign="top">-</td>
133  
-        <td valign="top">
134  
-          a página principal do sítio
135  
-        </td>
136  
-      </tr>
137  
-    </table>
138  
-    <ul>
139  
-      <li>admin/ - código para administração de todo o servidor </li>
140  
-      <li>auth/ - módulos para autenticação de utilizadores  </li>
141  
-      <li>blocks/ - módulos para os pequenos blocos laterais em várias páginas</li>
142  
-      <li>calendar/ - todo o código para mostrar e gerir calendários</li>
143  
-      <li>course/ - código para mostrar e gerir disciplinas </li>
144  
-      <li>doc/ - documentação e ajuda do Moodle (esta página incluida)</li>
145  
-      <li>files/ - código para mostrar e gerir ficheiros enviados</li>
146  
-      <li>lang/ - mesnagens de texto em diferentes línguas; um diretório por
147  
-        cada língua</li>
148  
-      <li>lib/ - librarias do código básico do Moodle</li>
149  
-      <li>login/ - código para criação e acesso às contas de utilizadores </li>
150  
-      <li>mod/ - todos os módulos de disciplina no Moodle</li>
151  
-      <li>pix/ - imagens genéricas do sítio</li>
152  
-      <li>theme/ - pacotes temáticos (theme/skins) para mudar a aparência do
153  
-        sítio</li>
154  
-      <li>user/ - código para mostrar e gerir a lista de utilizadores</li>
155  
-    </ul>
156  
-  </blockquote>
157  
-</blockquote>
158  
-<h3 class="sectionheading"><a name="installer"></a>4. Execução do script de instalação
159  
-para criar config.php </h3>
160  
-<blockquote>
161  
-  <p>Para executar o script de instalção (install.php), simplesmente tente aceder
162  
-    à página principal da sua instalação do Moodle, através de um "web browser",
163  
-    ou entre em <strong>http://o_seu_servidor/install.php</strong> directamente.</p>
164  
-  <p>(O instalador tentará instalar uma "cookie" para a sessão. Se lhe aparecer
165  
-    uma caixa de advertência no seu browser, deverá aceptar essa cookie!)</p>
166  
-  <p>Moodle detectará que é preciso fazer a configuração e conduzí-lo-a através
167  
-    de várias páginas que lhe ajudarão a criar um novo ficheiro de configuração
168  
-    <strong>config.php</strong>. Quando o processo for concluido, Moodle tentará
169  
-    colocar o ficheiro no local apropriado, se não conseguir poderá carregar num
170  
-    botão para copiar o ficheiro preparado pelo instalador e enviá-lo logo para
171  
-    o directório principal do Moodle, no seu servidor, dándo-lhe o nome
172  
-    config.php</p>
173  
-  <p>Ao longo do processo o instalador testará o ambiente de trabalho do seu
174  
-    servidor Web, dando-lhe dicas para resolver quaisquer problemas que encontrar.
175  
-    Para a maior parte dos problemas essas dicas deverão ser suficiente, mas se
176  
-    ficar num impasse, procure informação mais para a frente neste documento, sobre
177  
-    como resolver alguns problemas que mais comumente dificultam a instalação.
178  
-  </p>
179  
-</blockquote>
180  
-<h3 class="sectionheading"><a name="webserver" id="webserver"></a>4.1 Verificação
181  
-da configuração do servidor Web</h3>
182  
-<blockquote>
183  
-  <p>O primeiro que deverá conferir é que o seu servidor web está configurado
184  
-    para usar index.php como nome de página por omissão (poderá também
185  
-    aceitar outros nomes alternativos, por exemplo, index.html, default.htm,
186  
-    etc).</p>
187  
-  <p>Em Apache, isso é feito usando o comando DirectoryIndex no seu ficheiro
188  
-    de configuração httpd.conf. O meu normalmente contém o seguinte:</p>
189  
-  <blockquote>
190  
-    <pre><strong>DirectoryIndex</strong> index.php index.html index.htm </pre>
191  
-  </blockquote>
192  
-  <p>Verifique que index.php esteja entre a lista (e preferivelmente mais
193  
-    perto do início da lista, para aumentar a eficiência).</p>
194  
-  <p>A seguir, <b>se estiver a usar Apache 2</b>, deverá activar a variável
195  
-     <i>AcceptPathInfo</i>, que permitirá a passagem de argumentos na forma
196  
-     http://servidor/ficheiro.php/arg1/arg2.
197  
-     Isso é esencial para poder permitir apontadores relativos entre os
198  
-     seus recursos, e também para melhorar o desempenho para os utilizadores
199  
-     do seu sítio Moodle. Poderá activar essa variável juntado a linha que
200  
-     se segue ao seu ficheiro httpd.conf</p>
201  
-  <blockquote>
202  
-    <pre><strong>AcceptPathInfo</strong> on </pre>
203  
-  </blockquote>
204  
-  <p>Em terceiro lugar, Moodle precisa da activação de algumas opções do PHP
205  
-     para funcionar correctamente. <b>Na maior parte dos servidores essas
206  
-     opções já estarão activas por omissão.</b> No entanto, alguns servidores
207  
-     PHP (especialmente nas versões mais recentes) poderão estar configuradas
208  
-     em forma diferente. Essas opções activam-se no ficheiro de configuração
209  
-     do PHP (normalmente o ficheiro php.ini):</p>
210  
-  <blockquote>
211  
-    <pre>magic_quotes_gpc = 1    (preferred but not necessary)
212  
-magic_quotes_runtime = 0    (necessary)
213  
-file_uploads = 1
214  
-session.auto_start = 0
215  
-session.bug_compat_warn = 0
216  
-</pre>
217  
-  </blockquote>
218  
-  <p>Se não tiver acesso a httpd.conf ou php.ini no seu servidor, ou se estiver
219  
-    a usar outras aplicções que exigem outra configuração diferente, não se
220  
-    preocupe pois poderá ainda INVALIDAR a configuração global.</p>
221  
-  <p>Para o conseguir, deverá criar um ficheiro <b>.htaccess</b> no
222  
-    directório principal do Moodle, com as definições que precisa. Isso só
223  
-    funcionará no Apache, e quando a opção Overrides for permitida na
224  
-    configuração global do servidor.
225  
-    O conteúdo de .htacces será:</p>
226  
-  <blockquote>
227  
-    <pre>
228  
-DirectoryIndex index.php index.html index.htm
229  
-
230  
-<IfDefine APACHE2>
231  
-     <b>AcceptPathInfo</b> on
232  
-</IfDefine>
233  
-
234  
-php_flag magic_quotes_gpc 1
235  
-php_flag magic_quotes_runtime 0
236  
-php_flag file_uploads 1
237  
-php_flag session.auto_start 0
238  
-php_flag session.bug_compat_warn 0</pre>
239  
-  </blockquote>
240  
-  <p>Poderá fazer outras coisas como, por exemplo, limitar o tamanho máximo
241  
-    dos ficheiros enviados para o Moodle:</p>
242  
-  <blockquote>
243  
-    <pre>
244  
-LimitRequestBody 0
245  
-php_value upload_max_filesize 2M
246  
-php_value post_max_size 2M
247  
-     </pre>
248  
-  </blockquote>
249  
-  <p>O mais fácil será copiar o ficheiro tipo em <strong>lib/htaccess</strong>
250  
-    e editá-lo para o adaptar às suas necessidades (o ficheiro contém algumas dicas
251  
-     adicionais). Por exemplo, num shell do Unix:</p>
252  
-  <blockquote>
253  
-    <pre>cp lib/htaccess .htaccess</pre>
254  
-  </blockquote>
255  
-</blockquote>
256  
-<h3 class="sectionheading"><a name="database"></a>4.2. Criação de uma base de dados</h3>
257  
-<blockquote>
258  
-  <p>Terá que criar uma base de dados (por exemplo "<em>moodle</em>"), vazia, no seu
259  
-    sistema de bases de dados, junto com um utilizador especial (por exemplo
260  
-    "moodleuser") que tenha acesso a essa base de dados (e a nenhuma outra).
261  
-    Poderá usar o utilizador "root" se quiser, mas isso não é aconselhável
262  
-    para um sistema activo: se os "crackers" conseguirem descobrir a
263  
-    contrasenha de acesso à base de dados, todo o seu servidor de bases de
264  
-    dados ficará em risco, em vez de por em risco unicamente uma base de
265  
-    dados.
266  
-  </p>
267  
-<p>Os comandos seguintes são um exemplo da criação da base de dados em MySQL: </p>
268  
-  <pre>
269  
-   # mysql -u root -p
270  
-   > CREATE DATABASE moodle; 
271  
-   > GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.* 
272  
-           TO moodleuser@localhost IDENTIFIED BY 'seupassword'; 
273  
-   > quit 
274  
-   # mysqladmin -p reload
275  
-</pre>
276  
-  <p>E um exemplo para PostgreSQL: </p>
277  
-  <pre>
278  
-   # su - postgres
279  
-   > psql -c "create user moodleuser createdb;" template1
280  
-   > psql -c "create database moodle;" -U moodleuser template1
281  
-   > psql -c "alter user moodleuser nocreatedb;" template1
282  
-</pre>
283  
-  <p>(Se usar MySQL, recomendo vivamente o uso de  <a href="http://phpmyadmin.sourceforge.net/">phpMyAdmin</a> 
284  
-    para gerir as suas bases de dados - poderá gerir a base de dados usando
285  
-    uma interface Web).</p>
286  
-  <p>A partir da versão 1.0.8, Moodle aceita prefixos de tabelas, para poder
287  
-   partilhar uma base de dados com tabelas SQL de outras aplicações.</p>
288  
-</blockquote>
289  
-
290  
-<h3 class="sectionheading"><a name="data"></a>4.3 Criação de um directório de dados</h3>
291  
-<blockquote>
292  
-  <p>Moodle precisa de algum espaço no seu disco rígido para armazenar
293  
-    ficheiros enviados, por exemplo, os documentos associados a uma disciplina
294  
-    e as fotografias dos utilizadores.</p>
295  
-  <p>Crie um directório para esse propósito em alguma parte do seu sistema
296  
-    de ficheiros. Por razões de segurança, é conveniente que esse directório
297  
-    NÂO seja acessível directamente através da web. A forma mais simples de
298  
-    garantir isso, será criar o directório por FORA do directório raiz do seu
299  
-    servidor Web; se assim não for, terá que o proteger criando nele um
300  
-    ficheiro .htaccess com o seguinte conteúdo:
301  
-  <blockquote>
302  
-     
303  
-    <pre>deny from all</pre>
304  
-  </blockquote>
305  
-  <p>Para garantir que Moodle poderá gravar nesse directório os ficheiros
306  
-    recebidos, confira que o servidor web (por exemplo o Apache) tenha
307  
-    autorização para escrever nesse directório. Em plataformas Unix, isso
308  
-    implica mudar o propietário do directório para algo como "nobody"
309  
-    ou "apache".</p>
310  
-  <p>Em muitos servidores web partilhados, provavelmente terá que prohibir
311  
-    o acesso a todos os ficheiros por parte do seu "grupo" (para evitar
312  
-    que outros utilizadores do servidor possam consultar ou modificar os seus
313  
-    ficheiros), mas permitir acesso de leitura/escritura para outros
314  
-    utilizadores (assim o servidor Web terá acesso aos seus ficheiros).
315  
-    Consulte com o seu administrador do servidor Web se tiver dificuldades
316  
-    em configurar o seu directório em forma segura.</p>
317  
-</blockquote>
318  
-
319  
-<h3 class="sectionheading"><a name="admin"></a>5. Visita à página de
320  
-administração para continuar a configuração</h3>
321  
-<blockquote> 
322  
-  <p>A página de adminstração já deverá estar activa em: 
323  
-    <u>http://exemplo.com/moodle/admin</u>. De qualquer forma, se neste
324  
-    momento tentar aceder à página principal do seu servidor moodle, será
325  
-    redireccionado automaticamente para essa página. A primeira vez que
326  
-    entrar na página de administração, ser-lhe-á apresentada a licença GPL
327  
-    qu deverá aceitar para poder continuar com a instalação.</p>
328  
-  <p>(Moodle também enviará algumas "cookies" para o seu navegador web. Se
329  
-    o seu navegador estiver configurado para perguntar antes de aceitar cookies,
330  
-    deverá aceitá-las ou Moodle não funcionará conrrectamente.)</p> 
331  
-  <p>A seguir Moodle procederá a configurar a sua base de dados criando as
332  
-    tabelas que serão usadas para guardar os dados. Primeiro são criadas as
333  
-    tabelas principais. Deverá ver vários comandos SQL seguidos por mensagens
334  
-    de diagnóstico (a verde ou vermelho) do género de:</p>
335  
-  <blockquote> 
336  
-    <p>CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category 
337  
-      int(10) unsigned NOT NULL default '0', password varchar(50) NOT NULL default 
338  
-      '', fullname varchar(254) NOT NULL default '', shortname varchar(15) NOT 
339  
-      NULL default '', summary text NOT NULL, format tinyint(4) NOT NULL default 
340  
-      '1', teacher varchar(100) NOT NULL default 'Teacher', startdate int(10) 
341  
-      unsigned NOT NULL default '0', enddate int(10) unsigned NOT NULL default 
342  
-      '0', timemodified int(10) unsigned NOT NULL default '0', PRIMARY KEY (id)) 
343  
-      TYPE=MyISAM</p>
344  
-    <p><font color="#006600">SUCCESS</font></p>
345  
-    <p>...and so on, followed by: <font color="#006600">Main databases set up 
346  
-      successfully.</font> </p>
347  
-  </blockquote>
348  
-  <p>Se não aparecerem essas mensagens, existirá algum problema com a base de
349  
-    dados ou com a configuração que definiu em config.php. Verifique que PHP
350  
-    não esteja em "Modo seguro" (Safe Mode. Alguns servidores comerciais
351  
-    costumam vir em modo seguro). Pode verificar as variáveis do PHP criando
352  
-    um pequeno ficheiro que contenha 
353  
-
354  
-e olhando para ele
355  
-    usando o seu navegador we. Verifique o resultado e tente acceder novamente
356  
-    à página de administração.</p>
357  
-  <p>Avance até o fim da página e carregue no botão "Continuar".</p>
358  
-  <p>A seguir verá uma outra página semelhante que configura as tabelas
359  
-    usadas por cada módulo do Moodle. Igual que no caso anterior, todas as
360  
-    mensagens de diagnóstico deverão aparecer em <font color="#006600">green</font>.</p>
361  
-  <p>Avance até o fim da página e carregue no botão "Continuar".</p>
362  
-  <p>Deverá agora aparecer um formulário onde pode definir mais variáveis
363  
-    de configuração para a sua instalação como, por exemplo, a língua usada
364  
-    por omissão, o nome do servidor SMTP, etc. Não se preocupe muito em tentar
365  
-    conifugar tudo à primeira vez - poderá regressar a esta página sempre
366  
-    que quiser, através da interface de administração, e experimentar
367  
-    diferentes configurações. Avance até o fim da página e carregue no botão
368  
-    "Gravar alterações".</p>
369  
-  <p>Se não conseguir avançar para a frente dessa página (e unicamente nesse
370  
-    caso), provavelmente o seu servidor tem o problema que eu chamo "referidor
371  
-    defeituoso" ("buggy referrer"). Isso é fácil de corrigir: simplesmente
372  
-    desactive a opção de "formulários seguros" (secureforms"),
373  
-    e tente novamente.</p>
374  
-  <p>A página seguinte é um formulário onde pode definir parâmetros para o
375  
-    seu sítio Moodle e para a página principal, tais como o nome, formato,
376  
-    descrição, etc. Complete esse forumlário (poderá sempre regressar mais
377  
-    tarde e fazer alterações) e carregue em "Gravar alterações".</p>
378  
-  <p>Finalmente, ser-lhe-á pedido para criar um utilizador administrador de
379  
-    alto nivel para acesso futuro às páginas de administração. Complete a
380  
-    informação com o seu próprio nome, endereço de correio electrónico, etc
381  
-    e carregue em "Gravar alteraçãoes". Não todos os campos são
382  
-    indispensáveis, mas se esquecer algum campo importante, voltará a aparecer
383  
-    o formulário.
384  
-  </p>
385  
-  <blockquote> 
386  
-    <blockquote> 
387  
-      <blockquote> 
388  
-        <blockquote> 
389  
-          <blockquote> 
390  
-            <p><strong>Tenha o cuidade de lembrar o nome de utilizador e
391  
-                a palavra chave que seleccionou para o administrador, já
392  
-                que eles serão necessários para acceder as páginas de
393  
-                administração em ocasiões futuras.</strong></p>
394  
-          </blockquote>
395  
-        </blockquote>
396  
-      </blockquote>
397  
-    </blockquote>
398  
-  </blockquote>
399  
-  <p>(Se por qualquer razão a sua instalação for interrompida, ou aparece algum
400  
-    erro que lhe impeça entrar com a palavra chave do administrados, normalmente
401  
-    poderá aceder com o nome de administrador por omissão, 
402  
-    "<strong>admin</strong>", com palavra chave
403  
-    "<strong>admin</strong>".)</p>
404  
-  <p>Uma vez concluido esse processo com éxito, ser-lhe-á apresentada a página
405  
-    principal do seu sítio. Repare no menu de administração no lado esquerdo
406  
-    da página (as mesmas alinhas no menu aparecem na página de administração)
407  
-    - esse menu só é vissível para si por ter entrado como o administrador.
408  
-    todas as configurações que tenha que fazer a partir de agora poderão
409  
-    ser feitas a partir desse menu; por exemplo:</p>
410  
-  <ul>
411  
-    <li>criação e eliminação de disciplinas</li>
412  
-    <li>criação e modificação de contas de utilizadores</li>
413  
-    <li>gestão de contas de docentes</li>
414  
-    <li>mudança de opções globais como o tema, língua, etc</li>
415  
-  </ul>
416  
-</blockquote>
417  
-<p> </p>
418  
-<h3 class="sectionheading"><a name="cron"></a>6. Configuração do cron</h3>
419  
-<blockquote> 
420  
-  <p>Algum dos módulos do Moodle precisam de verificações frequentes para
421  
-    realizar algumas tarefas. Por exemplo, Moodle precisa verificar os
422  
-    foruns de discusão para saber se é preciso enviar por correio cópias de
423  
-    novas contribuições, aos assinantes do forum.</p>
424  
-  <p>O script que executa essas tarefas de rutina encontra-se no directório
425  
-    admin, com o nome cron.php. No entanto, ele não pode arrancar por si
426  
-    próprio, mas será preciso instalar um mecanismo para que o script seja
427  
-    executado a intervalos regulares (por exemplo, cada 5 ou 10 minutos).
428  
-    Mecanismo esse que constitui as pulsações necessárias para que o script
429  
-    possa executar as tarefas definidas por cada módulo.</p>
430  
-  <p>De salientar que a máquina que execute o cron <b>não tem que ser a
431  
-    mesma máquina onde Moodle está instalado</b>. Por exemplo, se tiver
432  
-    um fornecedor web com limitações, que não tem o programa cron, poderá
433  
-    decidir executar cron em outra máquina ou até no seu computador em casa.
434  
-    O único que interessa é que o ficheiro cron.php seja invocado regularmente.
435  
-  </p>
436  
-    A carga imposta por esse script não é muito elevada, de maneira que 5
437  
-    minutos é um intervalo de tempo razoável, mas se estiver priocupado
438  
-    ao respeito pode reduzir o intervalo para 15 ou até 30 minutos. Convém
439  
-    não usar intervalos de tempo muito compridos, já que o atraso no envio
440  
-    de mensagens de correio pode diminuir o nivel de actividade da disciplina.
441  
-  </p>
442  
-  <p>Primeiro que tudo, teste o script executando-o directamente a partir
443  
-    do seu navegador:</p>
444  
-  <blockquote> 
445  
-    <pre>http://exemplo.com/moodle/admin/cron.php</pre>
446  
-  </blockquote>
447  
-  <p>A seguir, tem que instalar algum mecanismo para executar o script
448  
-    automaticamente, a intervalos regulares.</p>
449  
-  <h4>Execução do script a partir da linha de comandos</h4>
450  
-  <p>Pode invocar a página a partir da linha de comandos, tal como fez
451  
-    no exemplo acima. Por exemplo, pode usar algum programa do Unix como
452  
-    'wget':</p>
453  
-  <blockquote>
454  
-    <pre>wget -q -O /dev/null http://exemplo.com/moodle/admin/cron.php</pre>
455  
-  </blockquote>
456  
-  <p>Repare nesse exemplo que a saida do comando é deitada fora (para
457  
-    /dev/null).</p>
458  
-  <p>A mesma coisa usando lynx:</p>
459  
-  <blockquote>
460  
-    <pre>lynx -dump http://exemplo.com/moodle/admin/cron.php > /dev/null</pre>
461  
-  </blockquote>
462  
-  <p>Em forma alternativa, pode usar uma versão autonoma do PHP, compilada
463  
-    para poder ser executada directamente a partir da linha de comandos. A
464  
-    vantagem em fazer isso será que os estatísticas de acesso a o servidor
465  
-    não serão preenchidas com pedidos constantes do script cron.php. A
466  
-    desvantagem é que precisará ter acesso a uma versão de PHP para linha de
467  
-    comandos.</p>
468  
-  <blockquote>
469  
-    <pre>/opt/bin/php /web/moodle/admin/cron.php
470  
-
471  
-(Windows) C:apachephpphp.exe C:apachehtdocsmoodleadmincron.php
472  
-</pre>
473  
-  </blockquote>
474  
-  <h4>Execução automatica do script cada 5 minutos</h4>
475  
-  <p><b>Em sistemas Unix</b>: Use <b>cron</b>. Edite a sua configuração do
476  
-    cron, a partir da linha de comando usando "crontab -e" e
477  
-    adicione uma linha que diga:</p>
478  
-  <blockquote>
479  
-    <pre>*/5 * * * * wget -q -O /dev/null http://exemplo.com/moodle/admin/cron.php</pre>
480  
-  </blockquote>
481  
-  <p>Usualmente, o comando "contrab" abrirá o editor 'vi'. No editor 'vi'
482  
-   acceda ao modo de inserção carregando na tecla do "i", escreva a linha
483  
-   que acabamos de sugerir, e finalmente saia do modo de inserção carregando
484  
-   em ESC. Pode gravar e sair se escrever ":wq", ou sair sem gravar nenhuma
485  
-   alteração, se escrever ":q!" (sem as aspas).</p>
486  
-  <p><b>Em sistemas Windows</b>: A forma mais fácil consiste em usar este
487  
-   pequeno pacote: <a href="http://moodle.org/download/moodle-cron-for-windows.zip" title="Click ara
488  
-   copiar este progama (150k)" target="_blank">moodle-cron-for-windows.zip</a>
489  
-   que torna esse proceso muito simples. Pode também explorar a possibilidade
490  
-   de usar funcionalidades próprias do Windows para Tarefas Programadas.</p>
491  
-  <p>Em servidores web de fornecedores de serviços: O painel de controlo do
492  
-   seu sistema de web poderá ter uma página que lhe permita programar esse
493  
-   procedimento. Pergunte pormenores ao seu administrador.</p>
494  
-  <p></p>
495  
-</blockquote>
496  
-<h3 class="sectionheading"><a name="course"></a>7. Criação de uma nova disciplina</h3>
497  
-<blockquote>
498  
-  <p>Agora que a sua instalação do Moodle funciona adequadamente, poderá criar
499  
-    uma disciplina.</p>
500  
-  <p>Seleccione "Criar uma noa disciplina" a partir da página de
501  
-    administração (ou a partir dos enlaces na página principal).</p>
502  
-  <p>Complete o formulário, prestantdo especial atenção para o formato da
503  
-    disciplina. Não tem que se preocupar muito com os pormenores neste
504  
-    momento, já que todo poderá ser alterado mais tarde pelos docentes
505  
-    da disciplina.</p>
506  
-  <p>Carregue em  "Gravar alterações", e será conduzido para
507  
-    um novo formulário onde poderá designar docentes para a disciplina.
508  
-    Esse formulário só permite adicionar contas de utilizadores já existentes
509  
-    - se quiser criar novas contas de professores, peça ao próprio docente
510  
-    para criar uma conta pessoal (ver a página de acesso), ou criar uma conta
511  
-    para ele por meio da opção "Adicionar novo utilizador" na página
512  
-    de administração.</p>
513  
-  <p>Uma vez criada, a disciplna está pronta para ser modificada e estará
514  
-    acessível através sa secção de "Disciplinas" na página
515  
-    principal.</p>
516  
-  <p>Para mais pormenores sobre o processo de criação de disciplinas,
517  
-    consulte o "<a href="./?file=teacher.html">Manual do Professor</a>"</p>
518  
-</blockquote>
519  
-<p> </p>
520  
-<p align="center"><font size="1"><a href="." target="_top">Documentação de
521  
-Moodle</a></font></p>
522  
-<p align="center"><font size="1">Version: $Id$</font></p>
  1
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  2
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3
+<html xmlns="http://www.w3.org/1999/xhtml">
  4
+<head>
  5
+    
  6
+<title>Documentação do Moodle: Instalação Básica</title>
  7
+  
  8
+<link rel="stylesheet" href="docstyles.css" type="TEXT/CSS" />
  9
+    
  10
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  11
+
  12
+<style type="text/css">
  13
+<!--
  14
+.style3 {color: #660000}
  15
+-->
  16
+</style>
  17
+</head>
  18
+
  19
+<body>
  20
+<h1>Instalação do Moodle</h1>
  21
+<h2>Não tenha medo! <img src="../pix/s/smiley.gif" /></h2>
  22
+<blockquote>
  23
+<p>Este guia explica como instalar Moodle pela primeira vez. Alguns dos
  24
+passos são explicados com maior detalhe, para abrangir todas as pequenas
  25
+diferenças entre diferentes configurações dos navegadores, fazendo este
  26
+documento parecer comprido e complicado. Não se deixe desanimar por
  27
+isso - eu costumo instalar o Moodle em poucos minutos!</p>
  28
+<p>Se tiver problemas, por favor leia este documento cuidadosamente. Se
  29
+ainda tiver problemas, pode pedir ajuda em <a target="_blank"
  30
+href="http://moodle.org/help">"Moodle Help"</a>.</p>
  31
+<p>Outra possibilidade é entrar em contacto com alguma companhia de
  32
+<a target="_blank" href="http://moodle.com/hosting/">alojamento de servidores
  33
+Web</a>, que faça a muntenção do Moodle para si, para que se possa
  34
+concentrar nos aspectos didácticos sem perde tempo com problemas técnicos!
  35
+</p>
  36
+<p>Secções neste documento:</p>
  37
+  <ol>
  38
+    <li><a href="#requirements">Requisitos</a></li>
  39
+    <li><a href="#downloading">Obtenção do código do Moodle</a></li>
  40
+    <li><a href="#site">Estrutura do sítio</a></li>
  41
+    <li><a href="#installer">Execução do script de instalação para
  42
+               criar config.php</a>
  43
+      <ul>
  44
+        <li><a href="#webserver">Verificação da configuração do servidor Web</a></li>
  45
+        <li><a href="#database">Criação de uma base de dados</a></li>
  46
+        <li><a href="#data">Criação de um directório de dados</a></li>
  47
+      </ul>
  48
+    </li>
  49
+    <li><a href="#admin">Visita à página de administração para continuar a
  50
+          configuração</a></li>
  51
+    <li><a href="#cron">Configuração do cron</a></li>
  52
+    <li><a href="#course">Criação de uma nova disciplina</a></li>
  53
+  </ol>
  54
+</blockquote>
  55
+<h3 class="sectionheading"><a name="requirements"></a>1. Requisitos</h3>
  56
+<blockquote> 
  57
+  <p>Moodle é desenvolvido principalmente em Linux, usando Apache, MySQL e
  58
+    PHP (a combinação comumente designada de plataforma LAMP), mas também é
  59
+    testado regularmente com PostgreSQL e nos sistemas operativos Windows XP,
  60
+    Mac OS X e Netware 6.</p>
  61
+  <p>Os requisitos do Moodle são:</p>
  62
+  <ol>
  63
+    <li>Servidor Web. A maioria das pessoas usam
  64
+      <a href="http://www.apache.org/" target="_blank">Apache</a>, mas Moodle
  65
+      deveria funcionar com qualquer servidor Web que suporte PHP, como, por
  66
+      exemplo, IIS nas plataformas Windows.</li>
  67
+    <li>A linguagem <a href="http://www.php.net/" target="_blank">PHP</a>
  68
+      (versão 4.1.0 ou superior). A partir de Moodle 1.4 já é possível usar PHP 5.
  69
+    </li>
  70
+    <li>Servidor de bases de dados: Moodle funciona perfeitamente com
  71
+      <a href="http://www.mysql.com/" target="_blank">MySQL</a> 
  72
+      ou <a href="http://www.postgresql.org/" target="_blank">PostgreSQL</a>
  73
+      que são as duas opções recomendadas em Moodle.</li>
  74
+  </ol>
  75
+  <p>A maior parte dos fornecedores de serviços Web incluim todo esse software.
  76
+    Se o seu fornecedor for um dos poucos que não inclui essas opções,
  77
+    pergunte porque não o fazem e considere uma mudança de fornecedor.</p>
  78
+  <p>Se quiser usar Moodle no seu próprio computador e a instalação de todo
  79
+    esse software parece-lhe complicada, consulte o nosso guia:
  80
+    <a href="index.php?file=installamp.html">Instalação de 
  81
+    Apache, MySQL e PHP</a>. Nesse guia encontrará instrucções passo a passo
  82
+    para as plataformas mais populares.</p>
  83
+</blockquote>
  84
+<h3 class="sectionheading"><a name="downloading"></a>2. Obtenção do código do Moodle</h3>
  85
+<blockquote>
  86
+  <p>Existem duas formas de obter o Moodle, num ficheiro comprimido ou através
  87
+   do CVS. Essas duas formas explicam-se com mais detalhe na página web:
  88
+   <a href="http://moodle.org/download/" target="_blank">http://moodle.org/download/</a></p>
  89
+  <p>Depois de copiar e desempacotar o arquivo, ou depois de ter obtido uma
  90
+   cópia do CVS, deverá ter um directório "moodle", que contém
  91
+   vários ficheiros e subdirectórios.</p>
  92
+  <p>Pode transferir esse directório directamente para o directório raiz do
  93
+    seu servidor web, e nesse caso o seu sítio ficará disponível em
  94
+    <b>http://o_seu_servidor/moodle</b>, ou pode copiar o conteúdo do
  95
+    directório moodle directamente para o directório raiz do seu servidor web,
  96
+    ficando a sua instalação do Moodle dierectamente em
  97
+    <b>http://o_seu_servidor</b>.</p>
  98
+  <p>Se estiver a copiar o Moodle para o seu computador para depois transferí-lo
  99
+    para o servidor Web, é melhor enviar o arquivo completo num único ficheiro
  100
+    e depois desempacotá-lo no servidor Web. A maior parte das interfaces
  101
+    usadas nos serviços de alojamento de páginas web, por exemplo o Cpanel,
  102
+    permitem-lhe descomprimir arquivos com o "File Manager".</p>
  103
+</blockquote>
  104
+<h3 class="sectionheading"><a name="site"></a>3. Estrutura do sítio</h3>
  105
+<blockquote>
  106
+  <p>Pode passar à frente desta secção, mas fica já aqui um sumário do conteúdo
  107
+   do directório moodle, para o ajudá-lo a se orientar:</p>
  108
+  <blockquote>
  109
+    <table>
  110
+      <tr>
  111
+        <td width="130" valign="top">config.php</td>
  112
+        <td valign="top">-</td>
  113
+        <td valign="top">
  114
+          contém as configurações básicas. Este ficheiro não vem em Moodle,
  115
+          mas é criado durante o processo de instalação.
  116
+        </td>
  117
+      </tr>
  118
+      <tr>
  119
+        <td valign="top">install.php</td>
  120
+        <td valign="top">-</td>
  121
+        <td valign="top">o scritp que deverá executar para criar config.php </td>
  122
+      </tr>
  123
+      <tr>
  124
+        <td valign="top">version.php</td>
  125
+        <td valign="top">-</td>
  126
+        <td valign="top">
  127
+          define a versão actual do código do Moodle
  128
+        </td>
  129
+      </tr>
  130
+      <tr>
  131
+        <td valign="top">index.php</td>
  132
+        <td valign="top">-</td>
  133
+        <td valign="top">
  134
+          a página principal do sítio
  135
+        </td>
  136
+      </tr>
  137
+    </table>
  138
+    <ul>
  139
+      <li>admin/ - código para administração de todo o servidor </li>
  140
+      <li>auth/ - módulos para autenticação de utilizadores  </li>
  141
+      <li>blocks/ - módulos para os pequenos blocos laterais em várias páginas</li>
  142
+      <li>calendar/ - todo o código para mostrar e gerir calendários</li>
  143
+      <li>course/ - código para mostrar e gerir disciplinas </li>
  144
+      <li>doc/ - documentação e ajuda do Moodle (esta página incluida)</li>
  145
+      <li>files/ - código para mostrar e gerir ficheiros enviados</li>
  146
+      <li>lang/ - mesnagens de texto em diferentes línguas; um diretório por
  147
+        cada língua</li>
  148
+      <li>lib/ - librarias do código básico do Moodle</li>
  149
+      <li>login/ - código para criação e acesso às contas de utilizadores </li>
  150
+      <li>mod/ - todos os módulos de disciplina no Moodle</li>
  151
+      <li>pix/ - imagens genéricas do sítio</li>
  152
+      <li>theme/ - pacotes temáticos (theme/skins) para mudar a aparência do
  153
+        sítio</li>
  154
+      <li>user/ - código para mostrar e gerir a lista de utilizadores</li>
  155
+    </ul>
  156
+  </blockquote>
  157
+</blockquote>
  158
+<h3 class="sectionheading"><a name="installer"></a>4. Execução do script de instalação
  159
+para criar config.php </h3>
  160
+<blockquote>
  161
+  <p>Para executar o script de instalção (install.php), simplesmente tente aceder
  162
+    à página principal da sua instalação do Moodle, através de um "web browser",
  163
+    ou entre em <strong>http://o_seu_servidor/install.php</strong> directamente.</p>
  164
+  <p>(O instalador tentará instalar uma "cookie" para a sessão. Se lhe aparecer
  165
+    uma caixa de advertência no seu browser, deverá aceptar essa cookie!)</p>
  166
+  <p>Moodle detectará que é preciso fazer a configuração e conduzí-lo-a através
  167
+    de várias páginas que lhe ajudarão a criar um novo ficheiro de configuração
  168
+    <strong>config.php</strong>. Quando o processo for concluido, Moodle tentará
  169
+    colocar o ficheiro no local apropriado, se não conseguir poderá carregar num
  170
+    botão para copiar o ficheiro preparado pelo instalador e enviá-lo logo para
  171
+    o directório principal do Moodle, no seu servidor, dándo-lhe o nome
  172
+    config.php</p>
  173
+  <p>Ao longo do processo o instalador testará o ambiente de trabalho do seu
  174
+    servidor Web, dando-lhe dicas para resolver quaisquer problemas que encontrar.
  175
+    Para a maior parte dos problemas essas dicas deverão ser suficiente, mas se
  176
+    ficar num impasse, procure informação mais para a frente neste documento, sobre
  177
+    como resolver alguns problemas que mais comumente dificultam a instalação.
  178
+  </p>
  179
+</blockquote>
  180
+<h3 class="sectionheading"><a name="webserver" id="webserver"></a>4.1 Verificação
  181
+da configuração do servidor Web</h3>
  182
+<blockquote>
  183
+  <p>O primeiro que deverá conferir é que o seu servidor web está configurado
  184
+    para usar index.php como nome de página por omissão (poderá também
  185
+    aceitar outros nomes alternativos, por exemplo, index.html, default.htm,
  186
+    etc).</p>
  187
+  <p>Em Apache, isso é feito usando o comando DirectoryIndex no seu ficheiro
  188
+    de configuração httpd.conf. O meu normalmente contém o seguinte:</p>
  189
+  <blockquote>
  190
+    <pre><strong>DirectoryIndex</strong> index.php index.html index.htm </pre>
  191
+  </blockquote>
  192
+  <p>Verifique que index.php esteja entre a lista (e preferivelmente mais
  193
+    perto do início da lista, para aumentar a eficiência).</p>
  194
+  <p>A seguir, <b>se estiver a usar Apache 2</b>, deverá activar a variável
  195
+     <i>AcceptPathInfo</i>, que permitirá a passagem de argumentos na forma
  196
+     http://servidor/ficheiro.php/arg1/arg2.
  197
+     Isso é esencial para poder permitir apontadores relativos entre os
  198
+     seus recursos, e também para melhorar o desempenho para os utilizadores
  199
+     do seu sítio Moodle. Poderá activar essa variável juntado a linha que
  200
+     se segue ao seu ficheiro httpd.conf</p>
  201
+  <blockquote>
  202
+    <pre><strong>AcceptPathInfo</strong> on </pre>
  203
+  </blockquote>
  204
+  <p>Em terceiro lugar, Moodle precisa da activação de algumas opções do PHP
  205
+     para funcionar correctamente. <b>Na maior parte dos servidores essas
  206
+     opções já estarão activas por omissão.</b> No entanto, alguns servidores
  207
+     PHP (especialmente nas versões mais recentes) poderão estar configuradas
  208
+     em forma diferente. Essas opções activam-se no ficheiro de configuração
  209
+     do PHP (normalmente o ficheiro php.ini):</p>
  210
+  <blockquote>
  211
+    <pre>magic_quotes_gpc = 1    (preferred but not necessary)
  212
+magic_quotes_runtime = 0    (necessary)
  213
+file_uploads = 1
  214
+session.auto_start = 0
  215
+session.bug_compat_warn = 0
  216
+</pre>
  217
+  </blockquote>
  218
+  <p>Se não tiver acesso a httpd.conf ou php.ini no seu servidor, ou se estiver
  219
+    a usar outras aplicações que exigem outra configuração diferente, não se
  220
+    preocupe pois poderá ainda INVALIDAR a configuração global.</p>
  221
+  <p>Para o conseguir, deverá criar um ficheiro <b>.htaccess</b> no
  222
+    directório principal do Moodle, com as definições que precisa. Isso só
  223
+    funcionará no Apache, e quando a opção Overrides for permitida na
  224
+    configuração global do servidor.
  225
+    O conteúdo de .htacces será:</p>
  226
+  <blockquote>
  227
+    <pre>
  228
+DirectoryIndex index.php index.html index.htm
  229
+
  230
+<IfDefine APACHE2>
  231
+     <b>AcceptPathInfo</b> on
  232
+</IfDefine>
  233
+
  234
+php_flag magic_quotes_gpc 1
  235
+php_flag magic_quotes_runtime 0
  236
+php_flag file_uploads 1
  237
+php_flag session.auto_start 0
  238
+php_flag session.bug_compat_warn 0
  239
+</pre>
  240
+</blockquote>
  241
+<p>Poderá fazer outras coisas como, por exemplo, limitar o tamanho máximo
  242
+  dos ficheiros enviados para o Moodle:</p>
  243
+<blockquote>
  244
+<pre>
  245
+LimitRequestBody 0
  246
+php_value upload_max_filesize 2M
  247
+php_value post_max_size 2M
  248
+</pre>
  249
+</blockquote>
  250
+  <p>O mais fácil será copiar o ficheiro tipo em <strong>lib/htaccess</strong>
  251
+    e editá-lo para o adaptar às suas necessidades (o ficheiro contém algumas dicas
  252
+     adicionais). Por exemplo, num shell do Unix:</p>
  253
+  <blockquote>
  254
+    <pre>cp lib/htaccess .htaccess</pre>
  255
+  </blockquote>
  256
+</blockquote>
  257
+<h3 class="sectionheading"><a name="database"></a>4.2. Criação de uma base de dados</h3>
  258
+<blockquote>
  259
+  <p>Terá que criar uma base de dados (por exemplo "<em>moodle</em>"), vazia, no seu
  260
+    sistema de bases de dados, junto com um utilizador especial (por exemplo
  261
+    "moodleuser") que tenha acesso a essa base de dados (e a nenhuma outra).
  262
+    Poderá usar o utilizador "root" se quiser, mas isso não é aconselhável
  263
+    para um sistema activo: se os "crackers" conseguirem descobrir a
  264
+    contrasenha de acesso à base de dados, todo o seu servidor de bases de
  265
+    dados ficará em risco, em vez de por em risco unicamente uma base de
  266
+    dados.
  267
+  </p>
  268
+  <p>Se estiver a usar um servidor de alojamento de páginas Web, provavelmente
  269
+    terão disponível um painel de controlo com uma interface Web que lhe
  270
+    permitirá criar a sua base de dados.
  271
+  </p>
  272
+  <p>O sistema <strong>Cpanel</strong> é o mais popular desses sistemas. Para
  273
+    criar uma base de dados no Cpane,
  274
+  </p>
  275
+  <ol>
  276
+    <li>Carregue sobre o ícone &quot;<strong>MySQL Database</strong>&quot;.</li>
  277
+    <li>Escreva &quot;moodle&quot; no campo de base de dados e carregue sobre
  278
+      &quot;<strong>Add Database</strong>&quot;.</li>
  279
+    <li> Escreva um nome de utilizador e contrasenha (não use os mesmos dados que
  280
+      utilizar em algum outro serviço), nos campos respectivos, e carregue em
  281
+      &quot;<strong>Add User</strong>&quot;.
  282
+    </li>
  283
+    <li>Agora use o botão &quot;<strong>Add User to Database</strong>&quot; para
  284
+      dar a esse utilizador permissões de acesso à nova base de dados.</li>
  285
+    <li>Repare que ao nome de utilizador e ao nome da base de dados podem ter sido
  286
+      acrescentado um prefixo com o nome da sua conta no Cpanel. Quando precisar
  287
+      dessa informação no instalador do Moodle, deverá usar os nomes completos,
  288
+      incluindo os prefixos.</li>
  289
+  </ol>
  290
+  <p>Se tiver acesso a uma shell num sistema Unix onde vai instalar o Moodle,
  291
+    poderá fazer o procedimento escrevendo comandos na linha de comandos.
  292
+  </p>
  293
+  <p>A seguir mostra-se um exemplo dos comandos necessários para MySQL: </p>
  294
+  <pre>
  295
+   # mysql -u root -p
  296
+   &gt; CREATE DATABASE moodle; 
  297
+   &gt; GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.* 
  298
+           TO moodleuser@localhost IDENTIFIED BY 'o_seu_password'; 
  299
+   &gt; quit 
  300
+   # mysqladmin -p reload
  301
+  </pre>
  302
+  <p>E um exemplo para PostgreSQL: </p>
  303
+  <pre>
  304
+   # su - postgres
  305
+   &gt; psql -c "create user moodleuser createdb;" template1
  306
+   &gt; psql -c "create database moodle;" -U moodleuser template1
  307
+   &gt; psql -c "alter user moodleuser nocreatedb;" template1
  308
+  </pre>
  309
+</blockquote>
  310
+
  311
+<h3 class="sectionheading"><a name="data"></a>4.3 Criação de um directório de dados</h3>
  312
+<blockquote>
  313
+  <p>Moodle vai precisar de algum espaço no seu disco rígido para armazenar
  314
+    ficheiros enviados, por exemplo, os documentos associados a uma disciplina
  315
+    e as fotografias dos utilizadores.</p>
  316
+  <p>O instalador do Moodle tentará criar esse directório para sim, mas se não
  317
+    conseguir, terá de ser criado manualmente por si próprio.
  318
+  </p>
  319
+  <p>Por razões de segurança, é conveniente que esse directório
  320
+    NÂO seja acessível directamente através da web. A forma mais simples de
  321
+    garantir isso, será criar o directório por FORA do directório raiz do seu
  322
+    servidor Web; se assim não for, terá que o proteger criando nele um
  323
+    ficheiro .htaccess com o seguinte conteúdo:
  324
+  </p>
  325
+  <blockquote>
  326
+    <pre>deny from all</pre>
  327
+  </blockquote>
  328
+  <p>Para garantir que Moodle poderá gravar nesse directório os ficheiros
  329
+    recebidos, confira que o servidor Web (por exemplo o Apache) tenha
  330
+    autorização para escrever nesse directório.</p>
  331
+  <p>Em plataformas Unix, isso implica mudar o propietário do directório para
  332
+    algo como "nobody", "www-data" ou "apache", dando a esse utilizador permissões
  333
+    para ler, escrever e executar no directório de dados.</p>
  334
+  <p>Nos sistemas que usam Cpanel, pode usar o &quot;File Manager&quot; para
  335
+    encontrar o directório, carregue nele e seleccione &quot;Change Permissions&quot;.
  336
+    Em muitos servidores Web partilhados, provavelmente terá que prohibir
  337
+    o acesso a todos os ficheiros por parte do seu "grupo" (para evitar
  338
+    que outros utilizadores do servidor possam consultar ou modificar os seus
  339
+    ficheiros), mas permitir acesso de leitura/escritura para outros
  340
+    utilizadores (assim o servidor Web terá acesso aos seus ficheiros).</p>
  341
+  <p>Consulte com o seu administrador do servidor Web se tiver dificuldades
  342
+    em configurar o seu directório em forma segura. Em particular, alguns
  343
+    alguns servidores que usam uma funcionalidade do PHP, designada de
  344
+    &quot;Safe Mode&quot;, podem <em>precisar</em> que seja o administrador do
  345
+    seu servidor quem crie o directório para si.</p>
  346
+</blockquote>
  347
+
  348
+<h3 class="sectionheading"><a name="admin"></a>5. Visita à página de
  349
+administração para continuar a configuração</h3>
  350
+<blockquote> 
  351
+  <p>Após o ficheiro básico <strong>config.php</strong> ter sido criado com
  352
+    sucesso no passo anterior, quando tentar aceder à página principal do seu
  353
+    servidor Moodle, será redireccionado automaticamente para a página "admin"
  354
+    para continuar com a instalação.</p>
  355
+  <p>A primeira vez que entrar nessa página de administração ser-lhe-á
  356
+    apresentada a licença GPL, que deverá aceitar para poder continuar com a
  357
+    instalação.</p>
  358
+  <p>A seguir Moodle procederá a configurar a sua base de dados criando as
  359
+    tabelas que serão usadas para guardar os dados. Primeiro são criadas as
  360
+    tabelas principais. Deverá ver vários comandos SQL seguidos por mensagens
  361
+    de diagnóstico (a verde ou vermelho) do género de:</p>
  362
+  <blockquote> 
  363
+    <p>CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category 
  364
+      int(10) unsigned NOT NULL default '0', password varchar(50) NOT NULL default 
  365
+      '', fullname varchar(254) NOT NULL default '', shortname varchar(15) NOT 
  366
+      NULL default '', summary text NOT NULL, format tinyint(4) NOT NULL default 
  367
+      '1', teacher varchar(100) NOT NULL default 'Teacher', startdate int(10) 
  368
+      unsigned NOT NULL default '0', enddate int(10) unsigned NOT NULL default 
  369
+      '0', timemodified int(10) unsigned NOT NULL default '0', PRIMARY KEY (id)) 
  370
+      TYPE=MyISAM</p>
  371
+    <p><font color="#006600">SUCCESS</font></p>
  372
+    <p>...etc, seguidas por: <font color="#006600">Base de dados principal
  373
+      configurada com sucesso.</font></p>
  374
+  </blockquote>
  375
+  <p class="style3">
  376
+    Se não aparecerem essas mensagens, existirá algum problema com a base de
  377
+    dados ou com a configuração que definiu em config.php. Verifique que PHP
  378
+    não esteja em "Modo seguro" ("Safe Mode". Alguns servidores comerciais
  379
+    costumam vir em modo seguro). Pode verificar as variáveis do PHP criando
  380
+    um pequeno ficheiro que contenha <strong>&lt;?php phpinfo() ?&gt;</strong> 
  381
+    e olhando para ele com o seu navegador Web. Verifique o resultado e tente
  382
+    acceder novamente à página de administração.</p>
  383
+  <p>Avance até o fim da página e carregue no botão "Continuar".</p>
  384
+  <p>Deverá agora aparecer um formulário onde pode definir mais variáveis
  385
+    de configuração para a sua instalação como, por exemplo, a língua usada
  386
+    por omissão, o nome do servidor SMTP, etc. Não se preocupe muito em tentar
  387
+    configurar tudo à primeira vez - poderá regressar a esta página sempre
  388
+    que quiser, através da interface de administração. Os valores por omissão
  389
+    foram seleccionados para serem úteis e suficientemente seguros na maioria
  390
+    dos servidores. Avance até o fim da página e carregue no botão
  391
+    "Gravar alterações".</p>
  392
+  <blockquote>
  393
+    <p class="style3">
  394
+      Se não conseguir avançar para a frente dessa página (e unicamente nesse
  395
+      caso), provavelmente o seu servidor tem o problema que eu chamo "referidor
  396
+      defeituoso" ("buggy referrer"). Isso é fácil de corrigir: simplesmente
  397
+      desactive a opção de "formulários seguros" (secureforms"),
  398
+      e tente novamente.</p>
  399
+  </blockquote>
  400
+  <p>A seguir verá mais páginas que imprimem muitas mensagens de diagnóstico
  401
+    à medida que são configurados várias outras tabelas usadas pelos módulos
  402
+    do Moodle. Igual que no caso das tabelas básicas, todas as mensagens de
  403
+    diagnóstico deverá aparecer a <font color="#006600">verde</font>.</p>
  404
+  <p>Avance até o fim da página e carregue no apontador &quot;Continuar&quot;.
  405
+  </p>
  406
+  <p>A página seguinte é um formulário onde pode definir parâmetros para o
  407
+    seu sítio Moodle e para a página principal, tais como o nome, formato,
  408
+    descrição, etc. Complete esse forumlário (poderá sempre regressar mais
  409
+    tarde e fazer alterações) e carregue em "Gravar alterações".</p>
  410
+  <p>Finalmente, ser-lhe-á pedido para criar um utilizador administrador de
  411
+    alto nivel para acesso futuro às páginas de administração. Complete a
  412
+    informação com o seu próprio nome, endereço de correio electrónico, etc
  413
+    e carregue em "Gravar alteraçãoes". Não todos os campos são
  414
+    indispensáveis, mas se esquecer algum campo importante, voltará a aparecer
  415
+    o formulário.
  416
+  </p>
  417
+  <blockquote> 
  418
+    <blockquote> 
  419
+      <blockquote> 
  420
+        <p><strong>Tenha o cuidade de lembrar o nome de utilizador e
  421
+            a palavra chave que seleccionou para o administrador, já
  422
+            que eles serão necessários para acceder as páginas de
  423
+            administração em ocasiões futuras.</strong></p>
  424
+      </blockquote>
  425
+    </blockquote>
  426
+    <p class="style3">
  427
+     (Se por qualquer razão a sua instalação for interrompida, ou aparece algum
  428
+      erro que lhe impeça entrar com a palavra chave do administrador, normalmente
  429
+      poderá aceder com o nome de administrador por omissão, 
  430
+      "<strong>admin</strong>", com palavra chave "<strong>admin</strong>".)</p>
  431
+  </blockquote>
  432
+  <p>Uma vez concluido esse processo com éxito, ser-lhe-á apresentada a página
  433
+    principal do seu sítio. Repare no menu de administração no lado esquerdo
  434
+    da página (os mesmos itens do menu aparecem na página de administração)
  435
+    - esse menu só é vissível para si por ter entrado como o administrador.
  436
+    todas as configurações que tenha que fazer a partir de agora poderão
  437
+    ser feitas a partir desse menu; por exemplo:</p>
  438
+  <ul>
  439
+    <li>criação e eliminação de disciplinas</li>
  440
+    <li>criação e modificação de contas de utilizadores</li>
  441
+    <li>gestão de contas de docentes</li>
  442
+    <li>mudança de opções globais como o tema, língua, etc</li>
  443
+  </ul>
  444
+  <p>Mas a instalação ainda não terminou! Existe ainda um passo importante
  445
+    no processo de instalação (veja a próxima secção sobre o cron).</p>
  446
+</blockquote>
  447
+
  448
+<h3 class="sectionheading"><a name="cron"></a>6. Configuração do cron
  449
+- IMPORTANTE!</h3>
  450
+<blockquote> 
  451
+  <p>Alguns dos módulos do Moodle precisam de verificações frequentes para
  452
+    realizar algumas tarefas. Por exemplo, Moodle precisa verificar os
  453
+    foruns de discusão para saber se é preciso enviar por correio cópias de
  454
+    novas contribuições, aos assinantes do forum.</p>
  455
+  <p>O script que executa essas tarefas de rutina encontra-se no directório
  456
+    admin, com o nome cron.php. No entanto, ele não pode arrancar por si
  457
+    próprio, mas será preciso instalar um mecanismo para que o script seja
  458
+    executado a intervalos regulares (por exemplo, cada 5 ou 10 minutos).
  459
+    Mecanismo esse que constitui as "pulsações cardíacas" necessárias para
  460
+    que o script possa executar as tarefas definidas por cada módulo. Esse
  461
+    tipo de mecanismo de execução periódica de tarefas é designado por
  462
+    <strong>serviço cron</strong>.</p>
  463
+  <p>De salientar que a máquina que execute o cron <b>não tem que ser a
  464
+    mesma máquina onde Moodle está instalado</b>. Por exemplo, se tiver
  465
+    um fornecedor web com limitações, que não tem o programa cron, poderá
  466
+    decidir executar cron em outra máquina ou até no seu computador em casa.
  467
+    O único que interessa é que o ficheiro cron.php seja invocado regularmente.
  468
+  </p>
  469
+    A carga imposta por esse script não é muito elevada, de maneira que 5
  470
+    minutos é um intervalo de tempo razoável, mas se estiver priocupado
  471
+    ao respeito pode reduzir o intervalo para 15 ou até 30 minutos. Convém
  472
+    não usar intervalos de tempo muito compridos, já que o atraso no envio
  473
+    de mensagens de correio pode diminuir o nivel de actividade da disciplina.
  474
+  </p>
  475
+  <p>Primeiro que tudo, teste o script executando-o directamente a partir
  476
+    do seu navegador:</p>
  477
+  <blockquote> 
  478
+    <pre>http://exemplo.com/moodle/admin/cron.php</pre>
  479
+  </blockquote>
  480
+  <p>A seguir, tem que instalar algum mecanismo para executar o script
  481
+    automaticamente, a intervalos regulares.</p>
  482
+  <h4>Em sistemas Windows</h4>
  483
+  <blockquote>
  484
+    <p>A forma mais simples é utilizar um pacote pequenino:
  485
+      <a href="http://moodle.org/download/modules/moodle-cron-for-windows.zip"
  486
+        title="Click to download this package (150k)" target="_blank"><strong>moodle-cron-for-windows.zip</strong></a>
  487
+      que torna o procedimento bastante fácil instalando um pequeno serviço
  488
+      do Windows. Execute-lo e esqueça que existe!</p>
  489
+  </blockquote>
  490
+  <h4>Em servidores de alojamento Web</h4>
  491
+  <blockquote>
  492
+    <p>O seu painel Web de controlo poderá ter uma página que lhe permite
  493
+      configurar o processo cron. Por exemplo, no sistemas que usam Cpanel
  494
+      procure um botão que diz &quot;Cron jobs&quot;. Aí poderá inserir
  495
+      os mesmos comandos Unix descritos na secção seguinte.</p>
  496
+  </blockquote>
  497
+  <h4>A partir da linha de comandos em Unix</h4>
  498
+  <p>Existem muitos programas que pode usar para chamar a página cron.php.
  499
+    Nem todos eles poderão estar disponíveis no seu servidor.</p>
  500
+  <p>Por exemplo, pode usar algum programa do Unix como 'wget':</p>
  501
+  <blockquote>
  502
+    <pre>wget -q -O /dev/null http://exemplo.com/moodle/admin/cron.php</pre>
  503
+  </blockquote>
  504
+  <p>Repare nesse exemplo que a saida do comando é deitada fora (para
  505
+    /dev/null).</p>
  506
+  <p>A mesma coisa usando lynx:</p>
  507
+  <blockquote>
  508
+    <pre>lynx -dump http://exemplo.com/moodle/admin/cron.php &gt; /dev/null</pre>
  509
+  </blockquote>
  510
+  <p>Em forma alternativa, pode usar uma versão autonoma do PHP, compilada
  511
+    para poder ser executada directamente a partir da linha de comandos. A
  512
+    vantagem em fazer isso será que os estatísticas de acesso ao servidor
  513
+    não serão preenchidas com pedidos constantes do script cron.php. A
  514
+    desvantagem é que precisará ter acesso a uma versão de PHP para linha de
  515
+    comandos.</p>
  516
+  <blockquote>
  517
+    <pre>/opt/bin/php /web/moodle/admin/cron.php</pre>
  518
+  </blockquote>
  519
+  <h4>Utilização do programa crontab em Unix</h4>
  520
+  <p>O que o Cpanel faz é simplesmente fornecer uma interface Web para uma
  521
+    utilidade Unix cahamada crontab. Se tiver uma linha de comandos, pode
  522
+    configurar o crontab directamente usando o comando:</p>
  523
+  <blockquote>
  524
+    <pre>crontab -e</pre>
  525
+  </blockquote>
  526
+  <p>e adicionando algum dos comandos acima assim:</p>
  527
+  <blockquote>
  528
+    <pre>*/5 * * * * wget -q -O /dev/null http://exemplo.com/moodle/admin/cron.php</pre>
  529
+  </blockquote>
  530
+  <p>Usualmente, o comando "contrab" abrirá o editor 'vi'. No editor 'vi'
  531
+    acceda ao modo de inserção carregando na tecla do "i", escreva a linha
  532
+    que acabamos de sugerir, e finalmente saia do modo de inserção carregando
  533
+    em ESC. Pode gravar e sair se escrever ":wq", ou sair sem gravar nenhuma
  534
+    alteração, se escrever ":q!" (sem as aspas).</p>
  535
+</blockquote>
  536
+
  537
+<h3 class="sectionheading"><a name="course"></a>7. Criação de uma nova disciplina</h3>
  538
+<blockquote>
  539
+  <p>Agora que a sua instalação do Moodle funciona adequadamente, poderá criar
  540
+    uma disciplina.</p>
  541
+  <p>Seleccione "Criar uma noa disciplina" a partir da página de
  542
+    administração (ou a partir dos enlaces na página principal).</p>
  543
+  <p>Complete o formulário, prestantdo especial atenção para o formato da
  544
+    disciplina. Não tem que se preocupar muito com os pormenores neste
  545
+    momento, já que todo poderá ser alterado mais tarde pelos docentes
  546
+    da disciplina.</p>
  547
+  <p>Carregue em  "Gravar alterações", e será conduzido para
  548
+    um novo formulário onde poderá designar docentes para a disciplina.
  549
+    Esse formulário só permite adicionar contas de utilizadores já existentes
  550
+    - se quiser criar novas contas de professores, peça ao próprio docente
  551
+    para criar uma conta pessoal (ver a página de acesso), ou criar uma conta
  552
+    para ele por meio da opção "Adicionar novo utilizador" na página
  553
+    de administração.</p>
  554
+  <p>Uma vez criada, a disciplna está pronta para ser modificada e estará
  555
+    acessível através sa secção de "Disciplinas" na página
  556
+    principal.</p>
  557
+  <p>Para mais pormenores sobre o processo de criação de disciplinas,
  558
+    consulte o "<a href="./?file=teacher.html">Manual do Professor</a>"</p>
  559
+</blockquote>
  560
+
  561
+<p align="center"><font size="1"><a href="." target="_top">Documentação de
  562
+Moodle</a></font></p>
  563
+<p align="center"><font size="1">Version: $Id$</font></p>
523 564
 </body>

0 notes on commit bf34f54

Please sign in to comment.
Something went wrong with that request. Please try again.