moodle/lang/nl/docs/install.html
2003-10-10 22:54:29 +00:00

396 lines
22 KiB
HTML

<head>
<title>Moodle Documentatie: Installatie</title>
<link rel="stylesheet" href="docstyles.css" type="TEXT/CSS">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body bgcolor="#FFFFFF">
<h1>Moodle Installeren</h1>
<blockquote>
<p>In deze gids vind je hoe je Moodle de eerste keer moet installeren. Soms wordt er in detail getreden
om de grote variëteit aan kleine verschillen tussen verschillende installaties van webservers. Zo lijkt dit
document lang en moeilijk. Laat je er niet door afschrikken - Moodle kan geïnstalleerd worden in enkele minuten!</p>
<p>Neem je tijd en werk je door dit document - het zal je later tijd besparen.</p>
<p>Sections in this document:</p>
<ol>
<li><a href="#requirements">Systeemvereisten</a></li>
<li><a href="#downloading">Download</a></li>
<li><a href="#site">Site structuur</a></li>
<li><a href="#data">Een gegevensmap maken</a></li>
<li><a href="#database">Een databank maken</a></li>
<li><a href="#webserver">Instellingen van de webserver controleren</a></li>
<li><a href="#config">Config.php bewerken</a></li>
<li><a href="#admin">Naar de admin pagina gaan</a></li>
<li><a href="#cron">Cron installeren</a></li>
<li><a href="#course">Een nieuw vak maken</a></li>
</ol>
<p>&nbsp;</p>
</blockquote>
<h3 class="sectionheading"><a name="requirements"></a>1. Systeemvereisten</h3>
<blockquote>
<p>De ontwikkeling van Moodle is gestart in Linux met Apache, MySQL en PHP (soms ook gekend onder de naam
LAMP platform), maar is ook grondig getest met PostgreSQL en op Windows XP, Mac OS X en Netware 6 besturingssystemen</p>
<p>De systeemvereisten zijn de volgende:</p>
<ol>
<li>Web server software. Meest gebruikt is <a href="http://www.apache.org/" target="_blank">Apache</a>,
maar Moodle zou ook goed moeten werken op gelijk welke webserver met ondersteuning voor PHP, zoals
IIS op Windows platforms.</li>
<li><a href="http://www.php.net/" target="_blank">PHP</a> scripting taal (version 4.1.0
or later), met volgende instellingen:
<ul>
<li><a href="http://www.boutell.com/gd/" target="_blank">GD library</a>
ingeschakeld, met ondersteuning voo JPG en PNG bestandsindeling</li>
<li>zlib library ingeschakeld (als je backup/restore op Windows wil gebruiken)</li>
<li>Sessions support ingeschakeld</li>
<li>Bestanden uploaden ingeschakeld</li>
<li>Safe Mode moet uitgeschakeld worden (raadpleeg de forums op moodle.org voor problemen
veroorzaakt door Safe Mode)</li>
</ul>
</li>
<li>een werkende databank server: <a href="http://www.mysql.com/" target="_blank">MySQL</a>
of <a href="http://www.postgresql.org/" target="_blank">PostgreSQL</a> zijn volledig ondersteund en aangeraden
voor het gebruik met Moodle 1.1. Alle andere databanken zullen volledig ondersteund worden in de volgende versie.</li>
</ol>
<p>De meeste web hosts ondesteunen dit allemaal standaard. Als je ingetekend hebt bij een van de weinige
webhosts die deze mogelijkheden niet ondersteunen, vraag hen dan waarom en overweeg om te verhuizen.
<p>Als je Moodle op je eigen computer wil laten lopen en dit lijkt je allemaal wat moeilijk, raadpleeg dan onze
gids: <a href="http://moodle.org/doc/?file=installamp.html">Installing
Apache, MySQL and PHP</a>. Die geeft stap voor stap informatie om dit te installeren op de meest gebruikte platforms.</p>
<p>&nbsp;</p>
</blockquote>
<h3 class="sectionheading"><a name="downloading"></a>2. Download</h3>
<blockquote>
<p>Er zijn twee manieren om Moodle te bekomen. als gecomprimeerd pakket en via CVS. Dit staat in detail uitgelegd
op de downloadpagina: <a href="http://moodle.org/download/" target="_blank">http://moodle.org/download/</a></p>
<p>Na het downloaden en het uitpakken van het gecomprimeerd bestand of na het uitchecken uit CVS, krijg je een
map &quot;moodle&quot;, die een hele reeks bestanden en mappen bevat. </p>
<p>Je kan de hele map in de documentenmap van je webserver kopiëren; in dat geval zal je site te vinden zijn via
<b>http://jouwdomein.com/moodle</b> of je kan heel de inhoud van die map recht in de documentenmap van je webserver
zetten, zodat je site gewoon <b>http://jouwdomein.com</b> zal zijn.</p>
</blockquote>
<p>&nbsp;</p>
<h3 class="sectionheading"><a name="site"></a>3. Site structuur</h3>
<blockquote>
<p>Een kort overzicht van de inhoud van de Moodle map, om je te helpen oriënteren</p>
<blockquote>
<p>config.php - het ENIGE bestand dat bewerkt moet worden voor je kunt starten<br>
version.php - geeft de huidige versie van de Moodle programmatuur<br>
index.php - de startpagina van de site</p>
<ul>
<li>admin/ - code om de server te beheren </li>
<li>auth/ - modules om gebruikers te authenticeren </li>
<li>course/ - code om de vakken te tonen en te beheren </li>
<li>doc/ - help documentatie voor Moodle (bijvoorbeeld deze pagina)</li>
<li>files/ - code om geüploade pagina's te tonen</li>
<li>lang/ - teksten in verschillende talen, een map per taal</li>
<li>lib/ - bibliotheken met de kern van de Moodle code </li>
<li>login/ - code voor aanmelding en accountaanmaak </li>
<li>mod/ - alle vakmodules van Moodle</li>
<li>pix/ - stanaard afbeeldingen voor de site</li>
<li>theme/ - thema pakketten/skins om het uiterlijk van de site te wijzigen.</li>
<li>user/ - code gebuikers te tonen en te beheren</li>
</ul>
<p>&nbsp;</p>
</blockquote>
</blockquote>
<h3 class="sectionheading"><a name="data"></a>4. Een gegevensmap maken</h3>
<blockquote>
<p>Moodle zal wat ruimte op je harde schijf nodig hebben om geüploade bestanden te bewaren, zoals vak bestanden
en foto's van de gebruikers.</p>
<p>Maak ergens een map voor dit doel. Voor de veiligheid is het best dat deze map NIET rechtstreeks te bereiken
is via het web. De gemakkelijkste manier om dit te doen is door ze gewoon BUITEN de webmap te zetten. Anders
kun je de map ook beschermen door een bestandje te maken dat je .htaccess noemt en in die map plaatst. In dat
bestandje zet je volgende lijn
<blockquote>
<pre>deny from all</pre>
</blockquote>
<p>Om er zeker van te zijn dat Moodle bestanden kan uploaden naar deze map, kijk je best na of de webserver
(bijvoorbeeld Apache) het recht heeft om te schrijven in deze map. Voor Unixmachines betekent dit de instellingen
voor de eigenaar van de map op &quot;nobody&quaot; of &quot;apache&quot; zetten.</p>
<p>Op veel gedeelde hostinservers zul je waarschijnlijk alle bestandstoegang moeten beperken tot jouw groep
(om te verhinderen dat andere klanten van je host je bestanden kunnen komen bekijken en wijzigen), maar volledig
lezen en schrijvenrecht geven alle anderen (wat de webserver zal toelaten tot jouw bestanden) Spreek er over met
de beheerder van je server als je problemen hebt met dit veilig in te stellen.</p>
</blockquote>
<p>&nbsp;</p>
<h3 class="sectionheading"><a name="database"></a>5. Een databank maken</h3>
<blockquote>
<p>Je moet een lega databank maken (bv "moodle") in je databanksysteem
samen met een speciale gebruiker (bv "moodleuser") die toegang heeft tot die databank
(en alleen die databank). Je kunt ook de "root" gebruiker nemen als je wil, maar dit is niet aan te raden
voor een productiesysteem: als hackers je wachtwoord kraken, dan is je hele databanksysteem in gevaar, anders
slechts één databank
</p>
<p>Voorbeeldcode voor MySQL: </p>
<pre>
# mysql -u root -p
> CREATE DATABASE moodle;
> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.*
TO moodleuser@localhost IDENTIFIED BY 'yourpassword';
> quit
# mysqladmin -p reload
</pre>
<p>Voorbeeldcode voor PostgreSQL: </p>
<pre>
# su - postgres
> psql -c "create user moodleuser createdb;" template1
> psql -c "create database moodle;" -U moodleuser template1
> psql -c "alter user moodleuser nocreatedb;" template1
</pre>
<p>(Voor MySQL raad ik ten zeerste <a href="http://phpmyadmin.sourceforge.net/">phpMyAdmin</a>
aan voor het beheer van je databank - Je kunt dit dan allemaal doen via een webinterface).</p>
<p>Vanaf versie 1.0.8 ondersteunt Moodle tabelprefixen, zodat je veilig een databank kun delen met tabellen
van andere applicaties</p>
</blockquote>
<p>&nbsp;</p>
<h3 class="sectionheading"><a name="webserver" id="webserver"></a>6. Instellingen van de webserver controleren</h3>
<blockquote>
<p>Zorg er eerst voor dat je webserver ingesteld is om index.php als startpagina te gebruiken (eventueel aangevuld met
index.html, default.htm enz).</p>
<p>In Apache gebeurt dit door een DirectoryIndex parameter te gebruiken in je httpd.conf bestand. Het mijne ziet
er gewoonlijk zo uit:</P>
<blockquote>
<pre><strong>DirectoryIndex</strong> index.php index.html index.htm </pre>
</blockquote>
<p>Verzeker jezelf er van dat index.php in het lijstje staat (en voor de efficiëntie liefst ergens
bovenaan de lijst).</p>
<p>Verder <b>als je Apache 2 gebruikt</b>, moet je de <i>AcceptPathInfo</i>
variable inschakelen. Die zorgt er voor dat aan scripts parameters kunnen doorgegeven worden
zoals http://server/file.php/arg1/arg2.
Dit is noodzakelijk om relatieve links tussen je bronnen toe te laten, wat dan weer voor een grote
snelheidswinst oplevert voor bezoekers van je Moodle-site. Je kunt dit inschakelen door volgende lijnen in je
httpd.conf-bestand te zetten.</p>
<blockquote>
<pre><strong>AcceptPathInfo</strong> on </pre>
</blockquote>
<p>Ten derde vereist Moodle een aantal PHP-instellingen actief vóór het werkt.
<b>Op de meeste servers zullen deze al in de standaardinstellingen voorzien zijn.</b>
Hoewel sommige PHP-servers (en sommige van de recentere PHP-versies) andere instellingen kunnen hebben. Je kunt
ze vinden in het PHP configuratiebestand (meestal php.ini):</p>
<blockquote>
<pre>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
</pre>
</blockquote>
<p>Als je geen toegang hebt tot httpd.conf of tot php.ini op jouw server, of je hebt Moodle geïnstalleerd
op een server met andere toepassingen die andere instellingen vereisen, maak je dan geen zorgen, je kunt al
die standaardinstellingen nog overschrijven.
<p>Om dit te doen maak je een bestandje met als naam <b>.htaccess</b> in Moodle's
hoofdmap. Daarin zet je al deze instellingen. Dit werkt enkel op Apache servers en alleen als Overrides toegestaan
zijn.
<blockquote>
<pre>
DirectoryIndex index.php index.html index.htm
&lt;IfDefine APACHE2>
<b>AcceptPathInfo</b> on
&lt;/IfDefine>
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</pre>
</blockquote>
<p>Je kunt ook instellingen maken zoals de maximum grootte voor de geüploade bestanden.
<blockquote>
<pre>
LimitRequestBody 0
php_value upload_max_filesize 2M
php_value post_max_size 2M
</pre>
</blockquote>
<p>De eenvoudigste manier is het voorbeeldbestand kopiëren uit lib/htaccess en dat bewerken om het aan jouw noden
aan te passen. Het bevat verdere aanwijzingen, bijvoorbeeld, in een Unix shell:
<blockquote>
<pre>cp lib/htaccess .htaccess</pre>
</blockquote>
</blockquote>
<p>&nbsp;</p>
<h3 class="sectionheading"><a name="config"></a>7. Config.php bewerken</h3>
<blockquote>
<p>Nu kun je het configuratiebestand, <strong>config.php</strong>, bewerken met een tekstverwerker.
Dit bestand wordt door alle andere bestanden in Moodle gebruikt.</p>
<p>Maak om te beginnen een kopie van <strong>config-dist.php</strong> en noem ze config.php.
We doen dit, zodat je config.php niet overschreven zou worden als je Moodle later upgrade.</p>
<p>Bewerk <strong>config.php</strong> om de details van de databank te specifiëren die je net gemaakt hebt
(tabelprefix inbegrepen - let op: dit is vereist voor PostgreSQL), het siteadres, de map van het bestandssysteem
en de gegevensmap. In het configuratiebestand staan details en voorbeelden.</p>
<p>Na deze instellingen verloopt de rest van de installatie via een webinterface. Vanaf hier veronderstellen we dat
je site te vinden is op: <u>http://example.com/moodle</u></p>
</blockquote>
<p>&nbsp;</p>
<h3 class="sectionheading"><a name="admin"></a>8. Naar de admin pagina gaan</h3>
<blockquote>
<p>De adminpagina zou nu moeten werken op: <u>http://example.com/moodle/admin</u>.
Als je probeert naar de startpagina van je site te gaan, dan zul je toch automatisch naar de
adminpagina gestuurd worden. De eerste keer dat je deze pagina bezoekt, krijg je een licentieverklaring
te zien, die je moet goedkeuren voor de installatie kan verdergezet worden.</p>
<p>Moodle zal ook wat cookies in je browser proberen te zetten. Als je je browser ingesteld hebt om het gebruik
van cookies te controleren, dan <b>moet</b> je instellen om van Moodle cookies te accepteren, anders werkt
Moodle niet correct.
<p>Nu zal Moodle beginnen met het configureren van je databank en met het maken van tabellen om de gegevens in
te bewaren. Eerst worden de belangrijkste tabellen gemaakt. Je zou een aantal SQL-opdrachten moeten zien,
gevolgd door statusberichten (in groen of rood) die er uitzien zoals dit:</p>
<blockquote>
<p>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', timemodified int(10) unsigned NOT NULL default '0', PRIMARY KEY (id))
TYPE=MyISAM</p>
<p><font color="#006600">SUCCESS</font></p>
<p>...enzovoort, gevolgd door: <font color="#006600">Main databases set up
successfully.</font> </p>
</blockquote>
<p>Als je dit niet ziet, dan moeten er wat problemen met de databank of zijn of met de instellingen die in
config.php gedefinieerd zijn. Controleer of PHP niet in "Safe Mode" staat (commerciele web hosts
zetten dit soms aan). Je kunt PHP variablen controleren door een klein bestandje te maken en te uploaden met daarin
&lt? phpinfo() ?&gt en dat te bekijken met een browser. Controleer dit allemaal en probeer opnieuw.</p>
<p>Scroll down the very bottom of the page and press the &quot;Continue&quot;
link.</p>
<p>Als volgende pagina zie je een gelijkaardige pagina die de tabellen voor elke Moodle module maakt.Zoals de vorige
zouden deze <font color="#006600">green</font> moeten zijn.</p>
<p>Scroll helemaal naar onderaan de pagina en klik op de &quot;Continue&quot;
link.</p>
<p>Je zou nu een formulier moeten zien, waarin je meer configuratievariablen kunt ingeven, zoals de stanaardtaal,
SMTP-hosts enzovoort. Maak je niet te veel zorgen om alles nu juist te zetten - je kunt altijd terugkeren
en deze later bewerken met je beheer-interface. Scroll naar onderaan de pagina en klik op &quot;Save changes&quot;.</p>
<p>Als (en slecht als) je vastgeraakt op deze pagina, dan heeft je server waarschijnlijk, wat ik noem, het
'buggy referrerprobleem' Dit is gemakkelijk te herstellen: schakel de &quot;secureforms&quot; instelling uit
en probeer opnieuw.</p>
<p>De volgende pagina is een formulier waar je de parameters voor de voorpagina van je Moodlesite, zoals
de naam, opmaak, beschrijving enzovoort. kunt instellen. Vul dit in (je kunt altijd later terugkomen) en druk op
&quot;Save changes&quot;.</p>
<p>Ten slotte wordt je gevraagd een om een beherder aan te maken voor toegang toe de beheerpaginas. Vul
hier je eigen naam, e-mail enz in. Niet alle velden zijn verplicht, maar als je een belangrijk veld mist, dan krijg
je er opnieuw een aanvraagformulier voor.
</p>
<blockquote>
<blockquote>
<blockquote>
<blockquote>
<blockquote>
<p><strong>Zorg er voor dat je het paswoord en de gebruikersnaam die je
gekozen hebt voor de beheerder, goed kent, omdat die nodig zijn om in de toekomst toegang tot het beheer
te blijven hebben.</strong></p>
</blockquote>
</blockquote>
</blockquote>
</blockquote>
</blockquote>
<p>(If for any reason your install is interrupted, or there is a system error
of some kind that prevents you from logging in using the admin account, you
can usually log in using the default username of &quot;<strong>admin</strong>&quot;,
with password &quot;<strong>admin</strong>&quot;.)</p>
<p>Once successful, you will be returned to home page of your site. Note the
administration links that appear down the left hand side of the page (these
items also appear on a separate Admin page) - these items are only visible
to you because you are logged in as the admin user. All your further administration
of Moodle can now be done using this menu, such as:</p>
<ul>
<li>creating and deleting courses</li>
<li>creating and editing user accounts</li>
<li>administering teacher accounts</li>
<li>changing site-wide settings like themes etc</li>
</ul>
</blockquote>
<p>&nbsp;</p>
<h3 class="sectionheading"><a name="cron"></a>9. Set up cron</h3>
<blockquote>
<p>Some of Moodle's modules require continual checks to perform tasks. For example,
Moodle needs to check the discussion forums so it can mail out copies of posts
to people who have subscribed.</p>
<p>The script that does all this is located in the admin directory, and is called
cron.php. However, it can not run itself, so you need to set up a mechanism
where this script is run regularly (eg every five or ten minutes). This provides
a &quot;heartbeat&quot; so that the script can perform functions at periods
defined by each module.</p>
<p>Note that the machine performing the cron <b>does not need to be the same
machine that is running Moodle</b>. For example, if you have a limited web
hosting service that does not have cron, then you can might choose to run
cron on another server or on your home computer. All that matters is that
the cron.php file is called regularly. </p>
<p>The load of this script is not very high, so 5 minutes is usually reasonable,
but if you're worried about it you can reduce the time period to something
like 15 minutes or even 30 minutes. It's best not to make the time period
too long, as delaying mail-outs can slow down activity within the course.</p>
<p>First, test that the script works by running it directly from your browser:</p>
<blockquote>
<pre>http://example.com/moodle/admin/cron.php</pre>
</blockquote>
<p>Now, you need to set up some of way of running the script automatically and
regularly. </p>
<h4> Running the script from a command line</h4>
<p>You can call the page from the command line just as you did in the example
above. For example, you can use a Unix utility like 'wget':</p>
<blockquote>
<pre>wget -q -O /dev/null http://example.com/moodle/admin/cron.php</pre>
</blockquote>
<p>Note in this example that the output is thrown away (to /dev/null).</p>
<p>The same thing using lynx:</p>
<blockquote>
<pre>lynx -dump http://example.com/moodle/admin/cron.php &gt; /dev/null</pre>
</blockquote>
<p>Alternatively you could use a standalone version of PHP, compiled to be run
on the command line. The advantage with doing this is that your web server
logs aren't filled with constant requests to cron.php. The disadvantage is
that you need to have access to a command-line version of php.</p>
<blockquote>
<pre>/opt/bin/php /web/moodle/admin/cron.php
(Windows) C:\apache\php\php.exe C:\apache\htdocs\moodle\admin\cron.php
</pre>
</blockquote>
<h4>Automatically running the script every 5 minutes</h4>
<p><b>On Unix systems</b>: Use <b>cron</b>. Edit your cron settings from the commandline
using &quot;crontab -e&quot; and add a line like:</p>
<blockquote>
<pre>*/5 * * * * wget -q -O /dev/null http://example.com/moodle/admin/cron.php</pre>
</blockquote>
<p>Usually, the "crontab" command will put you into the 'vi' editor. You enter
"insert mode" by pressing "i", then type in the line as above, then exit insert mode by
pressing ESC. You save and exit by typing ":wq", or quit with saving using ":q!" (without the quotes).</p>
<p><b>On Windows systems</b>: The simplest way is to use this little package <a href="http://moodle.org/download/moodle-cron-for-windows.zip" title="Click to download this package (150k)" target="_blank">moodle-cron-for-windows.zip</a>
which makes this whole thing very easy. You can also explore using the built-in
Windows feature for "Scheduled Tasks".</p>
<p>On web hosts: Your web-based control panel may have a web page that allows
you to set up this cron process. Ask your administrator for details on how
it works.</p>
<p></p>
</blockquote>
<h3 class="sectionheading"><a name="course"></a>10. Create a new course</h3>
<blockquote>
<p>Now that Moodle is running properly, you can create a course. </p>
<p>Select &quot;Create a new course&quot; from the Admin page (or the admin
links on the home page).</p>
<p>Fill out the form, paying special attention to the course format. You don't
have to worry about the details too much at this stage, as everything can
be changed later by the teacher.</p>
<p>Press &quot;Save changes&quot;, and you will be taken to a new form where
you can assign teachers to the course. You can only add existing user accounts
from this form - if you want to create a new teacher account then either ask
the teacher to create one for themselves (see the login page), or create one
for them using the &quot;Add a new user&quot; on the Admin page.</p>
<p>Once done, the course is ready to customise, and is accessible via the &quot;Courses&quot;
link on the home page.</p>
<p>See the &quot;<a href="./?file=teacher.html">Teacher Manual</a>&quot; for more details
on course-building.</p>
</blockquote>
<p>&nbsp;</p>
<p align="CENTER"><font size="1"><a href="." target="_top">Moodle Documentation</a></font></p>
<p align="CENTER"><font size="1">Version: $Id$</font></p>
</body>