LinuxFocus article number 310 http://linuxfocus.org

door Juan Manuel Triana,Carlos Andrés Pérez <jutriana/at/uniweb.net.co caperez/at/usaca.edu.co> Over de auteur: 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. Carlos Andrés Pérez is een specialist in Moleculaire Simulatie, candidaat Phd in Biotechnology. Technisch adviseur voor de Grupo de Investigación en Educación Virtual (GIEV) Virtual Education Research Group. Addres: Universidad Santiago de Cali, Calle 5ª carrera 62 Campus Pampalinda, Cali – Colombia. Vertaald naar het Nederlands door: Guus Snijders <ghs(at)linuxfocus.org>

Een korte gids voor de installatie van CVW onder Linux Kort: 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. 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. _________________ _________________ _________________

Wat is CVW?

Waarom CVW kiezen?

De GIEV 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ë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.

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.

We hebben een IBM Netvista machine gebruikt als server voor deze software. De machine 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ïntegreerde Intel 845), maar na een kernel compilatie liep de video al snel goed (1024x768 bij 24 bits).

Stap voor stap

De eerste stap is om de software te downloaden vanaf de project website:

We hebben de volgende applicaties nodig:

• CVW server
• CVW document server
• CVW client

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

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

./cvw.boot start

En om de uitvoering te stoppen:

./cvw.boot stop

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.

Als je een verbinding opzet met een browser, wordt je begroet met het volgende bericht:

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

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

Pak het uit naar /opt/cvwdocserver en lees het README bestand. Nu moet je je eerste beslissing nemen.

De CVW docserver gebruikt Mysql als database en Tomcat (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).

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).
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.

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:

Include /opt/cvwdocserver/jakarta/tomcat/conf/tomcat-apache.conf

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

LoadModule jserv_module libexec/mod_jserv.so

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

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

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).

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

Als je geluk hebt, ben je bijna klaar.

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:

# Property file for CVW
#
cvw.server.host=cvw
cvw.server.port=8888
cvw.server.name=cvw
cvw.docserver.host=cvw
cvw.docserver.port=8080
cvw.docserver.url=/app/docservlet
cvw.version=4.0
cvw.debug=true

#############
# User Images
#############
#this url must end with a /
cvw.userimages.url=http://localhost/cvw/user-images/

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.

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.

Nu kun je je wachtwoord onder "File" veranderen en de Admin tool gebruik onder "View".

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

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.

Veel plezier.

2005-07-21, generated by lfparser_pdf version 2.51