GeneWeb - Serveur ou CGI

<b><b>Gwd</b></b>, quand il est lancé, est un serveur. En principe, la
troisième adresse: "http://ordinateur:2317/base" est celle
à utiliser pour les gens de l'extérieur.

<p>

Cependant, cela ne s'applique qu'aux ordinateurs visibles de
l'extérieur, c'est-à-dire ceux qui sont connectés
directement sur Internet.

<p>

Si vous passez par un fournisseur d'accès, votre ordinateur
personnel n'est pas visible. Dans ce cas, on ne peut rien
faire. C'est au fournisseur d'accès d'installer
{GeneWeb} sur son site. Au moment où j'écris ces
lignes (oct 98), je ne crois pas qu'aucun fournisseur d'accès
ne l'ait installé.

<p>

La suite ne concerne donc que ceux qui ont une connexion directe sur
Internet.

<p>

Si vous êtes sous Unix ou Windows NT (donc pas Windows 95), vous
avez dû entrer dans l'ordinateur en tant qu'utilisateur, en
donnant votre nom de "login" et votre mot de passe. Vous voulez
peut-être alors sortir sans que {GeneWeb} s'arrête.

<p>

Vous avez alors deux solutions pour résoudre ce problème:
l'installation en "service" et en l'installation en "cgi".


==Installation en "service " ==

Dans ce mode de fonctionnement, vous n'avez pas besoin qu'un serveur Web soit
installé sur votre ordinateur. <b><b>Gwd</b></b> <em>est</em> un serveur Web
à lui tout seul. Sa seule différence avec les
autres serveurs, c'est qu'il ne sert que de la
généalogie.

<ul>

<li> Si vous êtes sous Unix, au lieu de taper juste "<b>Gwd</b>", tapez:

<pre>
     nohup gwd 2&gt;&amp;1 &amp             (sous "sh", "ksh", "bash")
     nohup gwd &gt;&amp; nohup.out &amp;     (sous "csh", "tcsh")
</pre>

Vous pourrez alors vous déconnecter. <b>Gwd</b> continuera à
tourner et enverra sa trace sur le fichier "nohup.out" que vous
pourrez consulter plus tard. Pour l'arrêter, il faut regarder
quel est son numéro de processus, avec la commande "ps" et le
tuer avec la commande "kill".

</ul>

<p>

</ul>

<ul><li> Si vous êtes sous Windows NT, vous pouvez installer
"gwd" en "service" en utilisant l'utilitaire "srvany.exe", en
étant connecté en tant qu'administrateur. À
partir de Windows NT Ressource Kit, vous avez besoin de: srvany.exe,
instsrv.exe, peut-être srvinstw.exe et delsrv.exe, too. D'abord,
copiez srvany.exe dans un répertoire (dossier) de votre
ordinateur (par exemple C:\GeneWeb) et installez-le en service (un
utilitaire graphique sympa pour ça est srvinstw.exe):

<PRE>      instsrv GeneWebServer c:\GeneWeb\srvany.exe
</PRE>

Dans Services dans le panneau de configuration, cliquez GeneWebServer,
puis sur Startup et choisissez Automatique ou Manuel. Dans la boite
"se connecter comme", choisissez le compte sous lequel le service sera
lancé et son mot de passe (c'est nécessaire pour avoir
accès au réseau). {GeneWeb} sera lancé en
présisant les clés "registry" avec regedt32:

<PRE>
1. sous HKLM\System\CurrentControlSet\Services\GeneWebServer créez
   une nouvelle clé "Parameters"
   
2. créez là deux nouvelles valeurs (type REG_SZ) Application et
   AppDirectory, par exemple:
   Application: REG_SZ: C:\GeneWeb\gw\gwd.exe
   AppDirectory: REG_SZ: C:\GeneWeb\gw
</PRE>

Maintenant, vous pouvez contrôler le service GeneWeb dans le
panneau de configuration -&gt; Services -&gt; GeneWebServer
"Startup"/"Stop" ou en tapant "net start GeneWebServer" ou "net stop
GeneWebServer" à l'invite de commandes. Pour enlever
GeneWebServer, l'arrêter et taper "delsrv GeneWebServer" ou
"instsrv GeneWebServer remove".

</ul>


==Installation en "cgi" ==


Dans ce mode de fonctionnement, il faut qu'un serveur Web soit
installé sur votre ordinateur. Les "cgi" sont des programmes que
le serveur Web peut lancer. Seul l'administrateur système est
autorisé à ajouter des "cgi". Il faut donc
préalablement lui demander la permission.

<p>

<ul><li>

Sous Unix, si vous avez par exemple installé {GeneWeb} dans
le répertoire "/home/dupont/geneweb", fabriquez un fichier que
vous allez nommer "geneweb" et contenant les lignes suivantes:

<pre>
     #!/bin/sh
     DIR=/home/dupont/geneweb/gw
     cd $DIR
     $DIR/gwd -cgi 2&gt;/dev/null
</pre>

Rendez ce shell script exécutable (chmod +x geneweb) et demandez
à votre administrateur système d'installer ce fichier
dans le répertoire des "cgi". Demandez-lui également
quelle est l'adresse Web à utiliser. Ce sera sûrement
quelque chose du genre:

<pre>
     http://gnagna.xx.fr/cgi-bin/geneweb
</pre>

<p>

Si vous ouvrez l'adresse URL ci-dessus dans votre navigateur, vous
verrez apparaître une page qui vous demandera juste
"Base:". Entrez le nom de votre base. Vous pouvez aussi ajouter
directement "?b=durand" à cet URL, si "durand" est le nom
de votre base.

<p>

Remarques:
<p>
<ul>

<li> Si cette dernière commande ne fonctionne pas, il est possible
que le serveur Web n'ait pas le droit d'accès à la base ni
aux autres répertoires. Effectuez les opérations suivantes:

<pre>
     cd /home/dupont/geneweb/gw
     chmod 777 . lang images base.gwb
</pre>

<li> Si cela répond mais est très lent, il se peut que
ce soit dû au fait que le répertoire de la base est monté par
NFS (Network File System). Il est préférable que ce ne
soit pas le cas: si c'est possible, copiez donc le répertoire
geneweb sur un disque local du serveur Web. Si cela ne vous est pas
possible, ajoutez l'option "-nolock" dans l'appel de la commande
<b>Gwd</b> du fichier "geneweb" ci-dessus:

<pre>
     $DIR/gwd -cgi -nolock
</pre>

</ul>

</ul>

<ul><li>

Sous Windows NT, si vous avez par exemple installé
{GeneWeb} dans le répertoire "c:\home\dupont\geneweb",
créez un fichier que vous allez nommer "gwd.arg" et contenant
les lignes suivantes:

<pre>
     -hd
     c:\home\dupont\geneweb\gw
     -bd
     c:\home\dupont\geneweb\gw
     -cgi
</pre>

<p>

Ce sont les options que l'on peut passer à la commande
"Gwd". Faire "gwd -help" pour voir l'ensemble de ces options.

<p>

Demandez ensuite à votre administrateur système:
<p>
<ul>

<li> D'installer le fichier "gwd.arg" dans le répertoire des
"cgi".

<li> De copier le fichier "gwd.exe" du répertoire "geneweb"
dans ce même répertoire des "cgi".

</ul>

<p>

Demandez-lui l'adresse à utiliser. Ce sera sûrement
quelque chose du genre:

<pre>
     http://gnagna.xx.fr/cgi-bin/gwd.exe
</pre>

<p>

Si vous ouvrez cette adresse URL dans votre navigateur, vous verrez
apparaître une page qui vous demandera juste "Base:". Entrez le
nom de votre base. Vous pouvez aussi ajouter directement "?b=durand"
à cet URL, si "durand" est le nom de votre base.

<p>

Remarque: si cette dernière commande ne fonctionne pas, il est
possible que le serveur Web n'ait pas le droit d'accès à
la base ni aux autres répertoires. Il faut donner les droits de
lecture et d'écriture au répertoire "geneweb", à
son sous-répertoire "gw" et aux sous-répertoires "lang",
"durand.gwb", "images" (et "cnt" si ce répertoire existe).

</ul>


==Installation en "service" ou en "cgi"?  ==

Si vous avez le choix entre installation en "service" ou en "cgi", notez
les points suivants:

<ul>

<li> En mode "cgi", les requêtes sont indirectes, puisqu'il faut
passer par le serveur Web, ce qui peut ralentir
légèrement le traitement.

<li> Sous Unix, l'installation en "service" est plus facile,
puisqu'elle ne nécessite pas la permission ni l'intervention de
l'administrateur système.

<li> Sous Windows NT, vous devrez de toutes façons passer par
votre administrateur système, lequel va sûrement
préférer le mode "cgi" qui est beaucoup plus simple
à installer et plus contrôlable.

<li> Évidemment, s'il n'y a pas de serveur Web sur votre ordinateur,
seule l'installation en "service" est possible.

</ul>

<p>

<br>
<center>Retour vers [[[diruse/Mode d'Emploi]]]</center>

