<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<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>Petit guide pour l'installation de CVW sous Linux</h1>

    <h4>ArticleCategory:</h4>
    Applications 

    <h4>AuthorImage:</h4>
    <img src="../../common/images/article310/JuanManuelTriana_CarlosAndresPerez.jpg" alt="[Photo of the Author]" 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>es to fr <a href="mailto:Christophe.BENARD(at)wanadoo.fr">Christophe
    B�nard</a></p>

    <h4>AboutTheAuthor:</h4>

    <p>Juan Manuel Triana a travaill&eacute; avec Linux d&egrave;s son
    arriv&eacute;e en Colombie, aux alentours de 1995. D&eacute;fenseur
    &agrave; outrance de la Slackware, il a centralis&eacute; son travail
    sur les applications Multim&eacute;dia et sp&eacute;cialement le
    streaming audio.</p>

    <p>Carlos Andr&eacute;s P&eacute;rez est sp&eacute;cialiste en Simulation
    Mol&eacute;culaire, et doctorant en Biotechnologie, Conseiller Technique
    pour le Groupe d&acute;Investigation en Education Virtuelle (GIEV) Virtual
    Education Research Group. Adresse: Universit&eacute; Santiago de Cali,
    Calle 5&ordf; carrera 62 Campus Pampalinda, Cali &ndash; Colombia.</p>

    <h4>Abstract:</h4>
    CVW (Collaborative Virtual Workspaces) est un des outils les plus
    int&eacute;ressants disponibles en Open Source pour le
    d&eacute;veloppement d&acute;environnements d&acute;&eacute;ducation
    virtuelle. Cet article d&eacute;crit l&acute;installation sur un
    syst&egrave;me Suse Linux Professionnel 8.0. <br>
    <br>
    La version originale de Cvw ne fait pas l&acute;objet de plus ample
    d&eacute;veloppement pour l&acute;instant mais le logiciel est actuellement
    en cours de traduction vers l&acute;Espagnol, et naturellement, il est
    utilis&eacute; dans les cours &agrave; l&acute;Universit&eacute; Santiago
    de Cali en Colombie. Au moment de la r&eacute;daction de cet article,
    on compte environ 600 utilisateurs de Cvw au sein de l&acute;universit&eacute;.

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

    <h4>ArticleBody:</h4>

    <h2>Qu&acute;est-ce que CVW?</h2>
    <a href="http://cvw.sourceforge.net">CVW (cvw.sourceforge.net)</a> est un
    environnement logiciel collaboratif &eacute;crit principalement en Java,
    qui offre un "b&acirc;timent virtuel" au sein duquel les &eacute;quipes
    peuvent communiquer, collaborer, et partager l&acute;information, o&uacute;
    qu&acute;elles se trouvent.
    Gr&acirc;ce &agrave; CVW, les possibilit�s interactives du R&eacute;seau
    peuvent &ecirc;tre exploit&eacute;es en des espaces virtuels o&uacute; les
    gens se r�unissent pour apprendre, interagir, discuter et partager de
    l&acute;information, en utilisant une s&eacute;rie d&acute;outils simples.
    CVW a &eacute;t&eacute; d&eacute;velopp&eacute; par  <a href=
    "http://cvw.sourceforge.net">Mitre Corporation</a> et est totalement Open
    Source.

    <h2>Pourquoi avoir choisi CVW ?</h2>

    <p>Le groupe <a href="http://www.gievirtual.com">GIEV</a> de
    l&acute;Universit&eacute; Santiago de Cali en Colombie, a travaill&eacute;
    pendant plusieurs ann&eacute;es &agrave; la recherche de nouvelles
    plates-formes et de moyens virtuels qui assurent une int&eacute;gration
    facile avec les m&eacute;thodes &eacute;ducatives existantes. Apr�s avoir
    &eacute;prouv&eacute; diff&eacute;rents logiciels commerciaux, nous
    nous sommes tourn&eacute;s vers les alternatives Open Source et avons
    d&eacute;couvert CVW. Comme il poss&eacute;dait tous les
    &eacute;l&eacute;ments que nous cherchions, nous avons d&eacute;cid&eacute;
    de le tester.</p>

    <p>CVW n&acute;est pas facile &agrave; installer, comme nous l&acute;avons
    d&eacute;couvert assez t&ocirc;t. Dans les lignes qui suivent, je vais
    d&eacute;crire la proc&eacute;dure permettant de faire fonctionner cette
    merveilleuse plate-forme sous Suse 8.0.</p>

    <p>Nous avons re&ccedil;u un IBM Netvista pour tester ce logiciel.
    <a href="http://cvw.usaca.edu.co">Ce serveur</a> dot&eacute;
    d&acute;un Pentium 4 &agrave; 2.0Ghz, de 256Mo de Ram et de 40Go de disque dur,
    &eacute;tait connect&eacute; au r&eacute;seau de l&acute;Universit&eacute;.
    L&acute;installation de Suse n&acute;a pos&eacute; aucun probl&egrave;me
    majeur, si ce n&acute;est la vid&eacute;o qui m&acute;a caus&eacute; quelques
    soucis (un circuit Intel 845 int&eacute;gr&eacute;), mais une compilation
    du noyau a permis &agrave; la vid&eacute;o de fonctionner dans des
    conditions plus qu&acute;acceptables (1024x768 en 24 bits).</p>

    <h2>Pas &agrave; pas</h2>

    <p>La premi&egrave;re &eacute;tape consiste &agrave;
    t&eacute;l&eacute;charger le programme depuis  <a href=
    "http://sourceforge.net/projects/cvw">le site web du projet</a>:</p>

    <p>Les applications n&eacute;cessaires sont les suivantes:</p>

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

      <li>CVW document server</li>

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

    <p>Est &eacute;galement disponible CVW Federated server qui ne fonctionne
    que pour les clusters de serveurs CVW.</p>

    <p>Il faut d&acute;abord installer le serveur CVW. J&acute;ai
    d&eacute;compress&eacute; le fichier dans /opt/CVWserver et
    cr&eacute;&eacute; un utilisateur qui puisse l&acute;ex&eacute;cuter.
    Le script servant &agrave; d&eacute;marrer le serveur est:</p>

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

    <p>Et pour arr&ecirc;ter l&acute;application:</p>

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

    <p>Le programme recommande la cr&eacute;ation d&acute;un utilisateur,
    nous avons donc cr&eacute;&eacute; un utilisateur cvw et lui avons
    donn&eacute; les droits sur le r&eacute;pertoire. Si l&acute;on jette
    un oeil au script (cvw.boot), on note qu&acute;il faut renseigner certaines
    donn&eacute;es telles que le r&eacute;pertoire d&acute;installation, et,
    plus important, le port TCP sur lequel CVW va d&eacute;tecter les connexions
    des clients. Par d&eacute;faut, il s&acute;agit du port 8888.
    Nous le confirmons dans le script /etc/services. La seule chose que
    l&acute;on doit modifier lors d&acute;une installation pour Linux,
    c&acute;est la ligne qui fixe le nombre maximum de connexions clientes, qui
    par d&eacute;faut est illimit&eacute;, mais provoque une panne du service
    sous Linux.<br>
    <br>
    Quand on se connecte en utilisant un navigateur, un message
    s&acute;affiche:</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>Cela signifie que notre serveur est en mesure de recevoir les
    requ&ecirc;tes des clients. Le seconde &eacute;tape (et la plus
    p&eacute;nible) est d&acute;installer CVW document server.</p>

    <p>
    On suit la m&ecirc;me proc&eacute;dure que pour CVW server, on
    d&eacute;compresse l&acute;archive dans /opt/cvwdocserver et on jette un
    oeil au fichier README. Le moment est venu de prendre notre premi&egrave;re
    d&eacute;cision.<br>
    <br>
    CVW document server utilise une base de donn&eacute;es Mysql et <a href=
    "http://jakarta.apache.org">Tomcat</a> (un utlitaire Java d&acute;Apache)
    pour g&eacute;rer tous les documents stock&eacute;s dans l&acute;espace de
    travail virtuel. Le fichier tar.gz contient un r&eacute;pertoire
    jakarta/tomcat et une installation compl&ecirc;te de Mysql (3.23.27-beta).
    </p>

    <p>Nous n&acute;appr&eacute;cions pas les versions b&eacute;ta et Suse offrait
    des versions plus r&eacute;centes de Jakarta et Mysql, qui fonctionnaient
    plut&ocirc;t bien. Nous les avons donc ajust&eacute;es aux conditions requises
    par CVW document server. Mysql n&acute;a pos&eacute; aucun probl&egrave;me,
    il a juste fallu d&eacute;placer le fichier de base de donn&eacute;es vers
    l&acute;installation existante (/var/lib/mysql).<br>
    Le vrai probl&egrave;me s&acute;est pos&eacute; lors de la configuration
    de Tomcat. Adapter la configuration initiale de Jakarta &agrave; celle de
    CVW document server s&acute;est r&eacute;v&eacute;l&eacute; un
    v&eacute;ritable casse-t&ecirc;te, car les commandes (quand elles existaient)
    &eacute;taient localis&eacute;es &agrave; des emplacements distincts, de
    sorte que nous avons fini par d&eacute;cider de donner sa chance
    &agrave; la version de Jakarta/Tomcat livr&eacute;e avec CVW document server.</p>

    <p>Il faut toutefois apporter plusieurs modifications pour que
    l&acute;application fonctionne: j&acute;ai laiss&eacute; le r&eacute;pertoire
    jakarta/tomcat l&agrave; o&uacute; il a &eacute;t&eacute; d&eacute;compress&eacute;,
    sous l&acute;arborescence de docserv (/opt/cvwdocserv). Dans le fichier de
    configuration d&acute;Apache (/etc/httpd/httpd.conf), il faut ajouter cette
    ligne:</p>

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

    <p>Au tour du fichier tomcat-apache.conf maintenant. Il faut renseigner
    la localisation exacte du module jserv dans Apache</p>

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

    <p>Il est &eacute;galement n&eacute;cessaire d&acute;indiquer la localisation
    de l&acute;installation de  Tomcat et le port d&acute;&eacute;coute (mon
    choix s&acute;est port&eacute; sur le port 8007, apr&egrave;s plusieurs
    essais):</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>Une fois ces r&eacute;glages effectu&eacute;s, il convient de modifier
    le script cvwds.boot, qui utilise les m&ecirc;mes arguments que le script
    cvw.boot (start | stop).
    Les seules corrections apport&eacute;es concernent les r&eacute;pertoires
    locaux du serveur et de la base de donn&eacute;es, et la mise en commentaires
    des lignes provoquant l&acute;arr&eacute;t du serveur Mysql (car
    d&acute;autres bases de donn&eacute;es doivent continuer &agrave; fonctionner).
    </p>

    <p>Il faut &eacute;lement v&eacute;rifier que les fichiers .jar soient bien
    localis&eacute;s dans le r&eacute;pertoire webapps/app, et non pas
    dans un sous-r&eacute;pertoire.</p>

    <p>Avec un peu de chance, c&acute;est preque termin&eacute;.</p>

    <p>L&acute;&eacute;tape finale consiste &agrave; d&eacute;compresser le
    fichier client. Nous l&acute;avons r&eacute;alis&eacute; sous /opt/CVWclient/ .
    Le script contenant toutes les informations requises est nomm&eacute;
    server.cvw, et les lignes qui suivent sont extraites de notre fichier:</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>La ligne cvw.docserver.url est tr&egrave;s importante... nous ignorons
    pour quelle raison la configuration par d&eacute;faut pointe vers une
    autre adresse. Apr&egrave;s plusieurs essais, on a d&eacute;couvert que cette
    ligne est la PLUS IMPORTANTE pour pouvoir acc&eacute;der au docserver.</p>

    <p>Tout est pr&ecirc;t pour le premier acc&egrave;s au server CVW.
    Lors de la premi&egrave;re connexion, il faut utiliser le compte "Admin"
    sans mot de passe.</p>

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

    <p>Il est maintenant possible de modifier le mot de passe en passant par
    le menu "File" et d&acute;utiliser l&acute;outil d&acute;dministration
    gr&acirc;ce au menu "View".</p>

    <p>Comme le menu le montre, de nombreux outils sont accessibles et font de
    cette application une r&eacute;f&eacute;rence dans le domaine de
    l&acute;&eacute;ducation virtuelle.</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>Cette configuration fonctionne aujourd&acute;hui parfaitement sur notre
    serveur. Vous pouvez essayer cet utilitaire. Pour obtenir plus ample
    information: t&eacute;l&eacute;chargez le manuel au format pdf.</p>

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