<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//NL">
<html>
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org">
    <!-- this stylesheet will later on be added by lfparser automatically: -->
<style type="text/css">
<!--
  pre { font-family:monospace,Courier }
  pre.code { font-family:monospace,Courier;background-color:#aedbe8; }
  p.code { width:80%; alignment:center; background-color:#aedbe8; 
        border-style:none; border-width:medium; border-color:#aedbe8; 
        padding:0.1cm ; text-align:left }
-->
</style>

    <title></title>
  </head>

  <body>
    <h1>Een korte gids voor de installatie van CVW onder Linux</h1>

    <h4>ArticleCategory:</h4>
    Applications 

    <h4>AuthorImage:</h4>
    <img src="../../common/images/article310/JuanManuelTriana_CarlosAndresPerez.jpg" 
    alt="[foto van de Auteur]" width="110" height="210"> 

    <h4>TranslationInfo:</h4>

    <p>original in es <a href=
    "mailto:jutriana@uniweb.net.co,caperez@usaca.edu.co">Juan
    Manuel Triana,Carlos Andr&eacute;s P&eacute;rez</a></p>

    <p>es to en <a href="mailto:jutriana@uniweb.net.co">Juan Manuel
    Triana</a></p>

    <p>en to nl <a href="nospam:ghs(at)linuxfocus.org">Guus Snijders</a>
    </p>

    <h4>AboutTheAuthor:</h4>

    <p>Juan Manuel Triana werkt met Linux sinds de introductie daarvan in
    Columbia, rond 1995. Hij is reeds lange tijd Slackware voorstander en
    heeft zijn inspanningen geconcentreerd op Multimedia applicaties, met
    name geluid-verwerking en streaming. </p>

    <p>Carlos Andr&eacute;s P&eacute;rez is een specialist in Moleculaire
    Simulatie, candidaat Phd in Biotechnology. Technisch adviseur voor de
    Grupo de Investigaci&oacute;n en Educaci&oacute;n Virtual (GIEV) 
    Virtual Education Research Group. Addres: Universidad Santiago de 
    Cali, Calle 5&ordf; carrera 62 Campus Pampalinda, Cali &ndash; 
    Colombia.</p>

    <h4>Abstract:</h4>
    CVW (Collaborative Virtual Workspaces, gezamelijke virtuele 
    werkruimten) is een van de fijnste open source tools die beschikbaar
    is voor de ontwikkeling van virtueel onderwijs. Dit artikel beschrijft
    het installatie proces en gebruik in Suse Linux Professional 8.0. <br>
    <br>
    Op het moment zijn er geen verdere ontwikkelingen in de originele Cvw,
    maar de software wordt nu vertaald naar het Spaans en is natuurlijk in
    gebruik in de cursussen aan de Universiteit van Santiago de Cali in
    Colombia. Op moment van schrijven waren er zo'n 600 gebruikers van Cvw
    aan de universiteit.

    <h4>ArticleIllustration:</h4>
    <img src="../../common/images/article310/cvwlogo.jpg" 
    alt="[Illustratie]" hspace="10" width="83" height="103"> 

    <h4>ArticleBody:</h4>

    <h2>Wat is CVW?</h2>
    <a href="http://cvw.sourceforge.net">CVW (cvw.sourceforge.net)</a> is
    een gezamelijke software omgeving die voornamelijk in Java is 
    geschreven en een "virtueel gebouw" biedt waarin teams kunnen 
    communiceren, samenwerken en informatie delen, onafhankelijk van hun
    geographische locatie. Met CVW kunnen de interactieve mogelijkheden 
    van het net worden gebruikt in virtuele omgevingen waarin de mensen
    samenkomen om te leren, contact te maken, discussi&euml;ren en
    informatie uitwisselen, met behulp van vriendelijke tools. CVW is
    ontwikkeld door de <a href=
    "http://cvw.sourceforge.net">Mitre Corporation</a> en is volledig
    Open Source.

    <h2>Waarom CVW kiezen?</h2>

    <p>De <a href="http://www.gievirtual.com">GIEV</a> groep aan de
    Universiteit van Santiago de Cali heeft een aantal jaren gewerkt in
    onderzoek naar nieuwe platforms en virtuele omgevingen die een 
    eenvoudige integratie toestaan met bestaande onderwijs methodes. Na
    testen van commerci&euml;le software gingen we kijken naar Open Source
    ontwikkelingen en ontdekten CVW. Dit boodt alle belangrijke elementen
    die we zochten en besloten het uit te proberen. </p>

    <p>De installatie van CVW is niet erg gemakkelijk, zoals we al snel
    ontdekten. In de volgende regels zal ik het proces om dit prachtige
    platform op Suse 8.0 te krijgen beschrijven. </p>

    <p>We hebben een IBM Netvista machine gebruikt als server voor deze
    software. <a href="http://cvw.usaca.edu.co">De machine</a> heeft een
    Pentium 4 op 2.0 Ghz, 256MB Ram en 40 GB Harddrive en is verbonden met
    het universiteitsnetwerk. De Suse installatie verliep soepel, alleen
    de video gaf wat problemen (een ge&iuml;ntegreerde Intel 845), maar na
    een kernel compilatie liep de video al snel goed (1024x768 bij 24 
    bits). </p>

    <h2>Stap voor stap</h2>

    <p>De eerste stap is om de software te downloaden vanaf de <a href=
    "http://sourceforge.net/projects/cvw">project website</a>:</p>

    <p>We hebben de volgende applicaties nodig:</p>

    <ul>
      <li>CVW server</li>

      <li>CVW document server</li>

      <li>CVW client</li>
    </ul>

    <p>Er is ook een CVW Federated server beschikbaar die kan worden 
    ingezet op een cluster van CVW servers. </p>

    <p>Installeer eerst de CVW server. We pakten het bestand uit naar
    /opt/CVWserver en maakten een gebruiker ervoor aan. Het script om
    de server te starten is</p>

    <p>./cvw.boot start</p>

    <p>En om de uitvoering te stoppen:</p>

    <p>./cvw.boot stop</p>

    <p>De software raadt het aan om een gebruiker te maken, wij maakten
    de gebruiker cvw en gaven deze de rechten op de directory. Als je 
    kijkt naar het script (cvw.boot) moet je wat data opgeven zoals de
    installatie directory en, heel belangrijk, de TCP poort waarop CVW
    moet luisteren voor clients. De standaard toegewezen poort is 8888.
    Je hoeft dit alleen toe te voegen aan het bestand /etc/services. Het
    enige dat je moet veranderen als je installeerd onder Linux is de
    regel die het maximum aantal clients instelt, standaard is dit 
    ongelimiteerd maar onder Linux laat dit de service crashen. <br>
    <br>
     Als je een verbinding opzet met een browser, wordt je begroet met
    het volgende bericht:</p>

    <p>&lt;!--YourMOO--&gt;<br>
     &lt;!--<br>
     Welcome to the Collaborative Virtual Workspace.<br>
     This is version 4.0.2 of the CVW core.<br>
     If you are not using a CVW client ...<br>
     type: connect username password<br>
     to connect as an existing user<br>
     type: quit<br>
     to disconnect<br>
     --&gt;<br>
     I don't understand that. Valid commands at this point are<br>
     Help, COnnect, or Quit</p>

    <p>Dit betekend dat onze server klaar is om clients te bedienen. De
    tweede (en de pijnlijkste) stap is de installatie van de document 
    server.</p>

    <p>
    Pak het uit naar /opt/cvwdocserver en lees het README bestand. Nu 
    moet je je eerste beslissing nemen. <br>
    <br>
     De CVW docserver gebruikt Mysql als database en <a href=
    "http://jakarta.apache.org">Tomcat</a> (een Apache Java utility)
    om alle documenten te beheren die zijn opgeslagen in de virtuele
    werkruimte. Het tar.gz bestand bevat een jakarta/tomcat directory en
    een complete mysql installatie (3.23.27-beta).</p>

    <p>Wij houden niet zo van beta versies en Suse bood nieuwere jakarta
    en mysql versies die goed werkten, dus besloten we om deze aan te 
    passen aan de docserv vereisten. Met mysql waren er geen problemen, we
    verplaatsten alleen het database bestand naar mijn bestaande 
    installatie (/var/lib/mysql).<br>
     Het echte probleem begon met de Tomcat configuratie. Pogingen om de
    bestaande jakarta aan de configuratie van CVW's tomcat toe te voegen 
    leverden hoofdpijn op, omdat de commando's in verschillende delen 
    waren ondergebracht, ten slotte probeerden we om de bijgeleverde 
    Jakarta/Tomcat te gebruiken. </p>

    <p>Maar je moet verschillende dingen aanpassen voor een werkende
    applicatie: we lieten de jakarta/tomcat directory onder mijn docserv
    tree (/opt/cvwdocserv), dus moesten we in het apache configuratie 
    bestand (/etc/httpd/httpd.conf) de volgende regel toevoegen om 
    hiernaar te verwijzen:</p>

    <p>Include
    /opt/cvwdocserver/jakarta/tomcat/conf/tomcat-apache.conf</p>

    <p>Nu naar het tomcat-apache.conf bestand. Je moet het exacte adres
    van de jserv module in apache opgeven</p>

    <p>LoadModule jserv_module libexec/mod_jserv.so<br>
    </p>

    <p>Ook moet je het juiste adres van je tomcat installatie opgeven en
    de poort waarop wordt geluisterd (na enkele pogingen koos ik voor 
    8007):</p>

    <p>ApJServDefaultPort 8007<br>
     AddType test/jsp .jsp<br>
     AddHandler jserv-servlet .jsp<br>
     Alias /examples
    /opt/cvwdocserver/jakarta/tomcat/webapps/examples<br>
     &lt;Directory
    "/opt/cvwdocserver/jakarta/tomcat/webapps/examples"&gt;<br>
     Options Indexes FollowSymLinks<br>
     &lt;/Directory&gt;<br>
     ApJServMount /examples/servlet /examples<br>
     &lt;Location /examples/WEB-INF/ &gt;<br>
     AllowOverride None<br>
     deny from all<br>
     &lt;/Location&gt;<br>
     Alias /test /opt/cvwdocserver/jakarta/tomcat/webapps/test<br>
     &lt;Directory
    "/opt/cvwdocserver/jakarta/tomcat/webapps/test"&gt;<br>
     Options Indexes FollowSymLinks<br>
     &lt;/Directory&gt;<br>
     ApJServMount /examples/servlet /examples<br>
     &lt;Location /examples/WEB-INF/ &gt;<br>
     AllowOverride None<br>
     deny from all<br>
     &lt;/Location&gt;<br>
     Alias /test /opt/cvwdocserver/jakarta/tomcat/webapps/test<br>
     &lt;Directory
    "/opt/cvwdocserver/jakarta/tomcat/webapps/test"&gt;<br>
     Options Indexes FollowSymLinks<br>
     &lt;/Directory&gt;<br>
     ApJServMount /test/servlet /test<br>
     &lt;Location /test/WEB-INF/ &gt;<br>
     AllowOverride None<br>
     deny from all<br>
     &lt;/Location&gt;<br>
     ApJServMount /servlet /ROOT<br>
    </p>

    <p>Als dit gebeurt is, moet je het docserver script aanpassen, 
    cvwds.boot, dat dezelfde argumenten gebruikt als cvw.boot (start |
    stop). Wij pasten alleen de locale directories voor de docserver en de
    database aan en maakten commentaar van de regel die de mysql server
    stopt (omdat we ook eigen databases hebben draaien). </p>

    <p>Verder moet je controleren of de .jar bestanden in de webapps/app
    directory staan en niet in subdirectories. </p>

    <p>Als je geluk hebt, ben je bijna klaar. </p>

    <p>De laatste stap is het uitpakken van het client bestand. Wij deden
    dit onder /opt/CVWclient/. Het script met alle nodige data is 
    server.cvw, in ons geval pasten we de volgende regels aan:</p>

    <p># Property file for CVW<br>
     #<br>
     cvw.server.host=cvw<br>
     cvw.server.port=8888<br>
     cvw.server.name=cvw<br>
     cvw.docserver.host=cvw<br>
     cvw.docserver.port=8080<br>
     cvw.docserver.url=/app/docservlet<br>
     cvw.version=4.0<br>
     cvw.debug=true<br>
    <br>
     #############<br>
     # User Images<br>
     #############<br>
     #this url must end with a /<br>
     cvw.userimages.url=http://localhost/cvw/user-images/<br>
    </p>

    <p>De cvw.docserver.url is belangrijk... we weten niet waarom het
    origineel naar een andere locatie verwijst, na enkele testen ontdek
    je dat dit de MEEST BELANGRIJKE regel is om toegang te krijgen tot je
    docserver. </p>

    <p>Op dit punt ben je klaar om je eigen CVW server voor de eerste keer
    te benaderen. De eerste keer log je in als "Admin" zonder wachtwoord.
    </p>

    <center>
      <p><img src=
      "../../common/images/article310/administracion.png" width=
      "574" height="739"></p>
    </center>

    <p>Nu kun je je wachtwoord onder "File" veranderen en de Admin tool
    gebruik onder "View".</p>

    <p>Zoals het menu laat zien zijn er een hoop tools beschikbaar en dat
    is wat deze applicatie een referentie maakt in virtueel onderwijs. 
    </p>

    <center>
      <p><img src="../../common/images/article310/Cvw40-1.gif" 
       alt="cvw" width="374" height="354"><br>
      <img src="../../common/images/article310/Cvw40-2.gif" 
       alt="cvw" width="299" height="197"><br>
      <img src="../../common/images/article310/Cvw40-3.gif" 
       alt="cvw" width="495" height="553"></p>
    </center>

    <p>Deze configuratie is nu actief op onze server. Je kunt deze utility
    proberen. Als je meer informatie wilt: ze hebben een goede manual in
    PDF. </p>

    <p>Veel plezier.</p>
    <!-- vim: set sw=2 ts=2 et tw=74: -->
  </body>
</html>