Installer GeneWeb sous OS X

Language:	English • français

Installation simplel

Traces sur une fenêtre terminal au démarrage de GeneWeb.

L'installation la plus simple se passe de la façon suivante (testée au moins sur OSX Yosemite) :

• Télécharger la version appropriée. La dernière version disponible sur [1] est geneweb-6.07.tgz.
• Cliquer deux fois sur le fichier .tgz construit dans votre dossier téléchargements un nouveau dossier appelé geneweb-6.07.
• Déplacez ce dossier à l'endroit de votre choix.
• Démarrez GeneWeb en cliquant deux fois sur l'icône du fichier GeneWeb.command (et non sur els icônes de gwd ou gwsetup). Ceci devrait ouvrir une fenêtre terminal avec une trace du démarrage, et une page dans votre navigateur préféré avec la page de démarrage de GeneWeb.

Page de démarrage de GeneWeb.

• Si la fenêtre terminal vous indique un échec au démarrage, ceci peut être du à certains aspects de vorte environnement.

Essayez la procedure suivante :

• Faites une copie de sauvegarde de GeneWeb.command
• Ouvrez le fichier GeneWeb.command dans un éditeur de texte.
• remplacez la ligne

trap 'kill $pids' 1 2

par

killall gwd

killall gwsetup

et sauvegardez le résultat.

• Démarrez GeneWeb en cliquant deux fois sur l'icône de la nouvelle version de GeneWeb.command.

Installation de versions multiples

Il est possible d'installer sur votre ordinateur (ou serveur) plusieurs versions de GeneWeb qui pourront être démarrées alternativement, ce qui peut être utile pour faire migrer des bases d'une version à l'autre.

La première étape consiste à organiser une structure de dossier qui contiendra les divers éléments. Les options sont variées et dépendent des goûts personnels, mais la proposition faite ici à pour objectif d'expliciter le rôle de chaque dossier afin de vous permettre de faire votre propre choix.

Nous faisons l'hypothèse que tous les dossiers sont rassemblés sous une racine appelée /Home/Genealogie. Ce dossier contiendra deux sous-dossiers :

• GeneWeb : contenant les fichiers exécutables et certains fichiers paramètre associés
• GeneWeb-Bases : contenant toutes les données généalogique et des fichiers paramètres spécifiques aux bases. Dans la suite de ce document, ce dossier sera appelé bases/.

et des fichiers commande de lancement de plusieurs versions de GeneWeb différentes.

iMac-H:Genealogy Henri$ cd ~/Genealogy/
iMac-H:Genealogy Henri$ pwd
/Users/Henri/Genealogy
iMac-H:Genealogy Henri$ ls -al
total 24
drwxr-xr-x   5 Henri  staff    170 14 oct 12:57 .
drwxr-xr-x+ 81 Henri  staff   2754 14 oct 13:28 ..
-rw-r--r--@  1 Henri  staff  10244 14 oct 13:28 .DS_Store
drwxr-xr-x   8 Henri  staff    272 14 oct 12:59 GeneWeb
drwxr-xr-x  13 Henri  staff    442 14 oct 13:04 GeneWeb-Bases
-rwxr-xr-x@  1 Henri  staff   3036  8 sep 12:14 Gw-Mac-6.08.command
-rwxr-xr-x@  1 Henri  staff   3160 20 sep 05:55 Gw-Mac-7.00.command
iMac-H:Genealogy Henri$ 

Structure du dossiers GeneWeb sous Mac OS X (binaries et code source).

GeneWeb

Le contenu de GeneWeb est organisé de la façon suivante :

Plusieurs dossiers GeneWeb-x.yy-Mac contiennent, chacun pour une version de GeneWeb, le même ensemble de fichiers que dans l'installation simple.

Le dossier GeneWeb-6.08-Mac contient un dossier bases/ inutilisé car l'exécution de la commande gwd.command qu'il contient aura pu le créé.

Dans chaque dossier GeneWeb-x.yy-Mac on trouvera la même structure de sous-dossiers :

• CHANGES.txt
• gw/ : le dossier contenant un ensemble cohérent d'exécutables pour une version de GeneWeb. On se réfèrera à se dossier très souvent dans la documentation.
  • a.gwf : le fichier de configuration d'une base par défaut
  • consang : l'exécutable de calcul de consanguinité
  • css/ : le dossier de stockage des styles en cascade
  • etc/ : le dossier de stockage des fichiers template
  • ged2gwb : l'exécutable de lecture d'un fichier au format format GEDCOM vers une base .gwb
  • ged2gwb2 : l'exécutable de lecture d'un fichier au format format GEDCOM vers une base .gwb (nouveau format optimisé pour les grosses bases)
  • gwc : alias de gwc1
  • gwc1 : l'exécutable de lecture d'un fichier au format GWformat vers une base .gwb
  • gwc2 : l'exécutable de lecture d'un fichier au format format GWformat vers une base .gwb (nouveau format optimisé pour les grosses bases)
  • gwd : l'exécutable du serveur HTTP qui reçoit les requêtes vers les bases en renvoie les pages HTML
  • gwd.arg : le fichier des paramètres de lancement de gwd
  • gwd.log : la trace d'exécution de gwd
  • gwd.xcl : fichier d'exclusion
  • gwsetup : l'exécutable du serveur HTTP qui reçoit els requêtes de gestion des bases (création, sauvegardes, suppression, renommage),
  • gwu : l'exécutable qui exporte depuis une base un fichier au format GWformat
  • images/ : le dossier contenant les icônes utilisées par gwd et gwsetup
  • lang/ : le dossier contenant les fichiers utilisés pour la traduction de l'interface utilisateur
  • only.txt : un fichier contenant une liste d'adresses IP contrôlant l'accès au serveur
  • setup/ : un dossier contenant les fichiers template utilisés par gwsetup
  • tags.txt : un fichier donnant la liste des Tags HTML autorisés dans les notes
  • update_nldb : l'exécutable recalculant les index des pages de notes de la base
• gwd : un fichier script lançant l'exécution de gwd
• gwsetup : un fichier script lançant l'exécution de gwsetup
• LICENSE.txt : le fichier décrivant la license de GeneWeb
• START.html : la page HTML de démarrage de GeneWeb (qui apparaîtra après l'exécution de l'un des fichiers commande GeneWeb/Gw-Mac-x.yy.command

On ignore dans l'immédiat les deux dossiers gw-6.08-alpha-src et gw-7.00-Mac (code source) et le fichier gwget-7-00.sh

GeneWeb-Bases

Le dossier GeneWeb-Bases est organisé de la façon suivante :

Folder structure under Mac OSX for GeneWeb-Bases (Genealogy data).

• mabasei.gwb/ : chaque bases est conservée dans un dossier séparé
• mabase-i.gwf : un fichier de configuration spécifique à chaque base. Si absent gw/a.gwf
• cnt/ : contient les compteurs d'accès à chaque base et le fichier robot listant les adresses IP devant être exclues suite à leur comportement.
• etc/ : contient, dans autant de fichiers mabase-i que nécessaire, des fichiers template spécifiques à chaque base qui viennent se substituer à ceux de gw/etc. L'ordre de recherche des fichiers est :
  • .../bases/etc/base
  • .../bases/etc
  • .../gw/etc/base
  • .../gw/etc
• images/ : contient, dans autant de fichiers mabase-i que nécessaire, des fichiers images associées aux personnes.
• lang/ :
• src : contient, dans autant de fichiers mabase-i que nécessaire, des fichiers .txt , et un dossier images( voir Insérer des images dans les notes, et les commandes m=SRC or m=IMH).
• un ou plusieurs fichiers .auth référencé dans mabase-i.gwf définissant le contrôle d'accès pour les visiteurs, amis et magiciens (voir Accès).

Starting Gwd and Gwsetup

Traces in terminal window at GeneWeb start.

With this folder organisation, clicking on $HOME/Genealogy/Gw-Mac-7.00.command (whose content is here) will open a terminal window, kill previously running versions of gwd and gwsetup, start a fresh one and open the same start page as above.

For the diehards, here are all the parameters that gwd accepts at launch time:

iMac-H:gw Henri$ ./gwd -help
Usage: gwd [options] where options are:
  -hd <dir>
       Directory where the directory lang is installed.
  -dd <dir>
       Directory where the documentation is installed.
  -bd <dir>
       Directory where the databases are installed.
  -wd <dir>
       Directory for socket communication (Windows) and access count.
  -cgi
       Force cgi mode.
  -images_url <url>
       URL for GeneWeb images (default: gwd send them)
  -images_dir <dir>
       Same than previous but directory name relative to current
  -a <address>
       Select a specific address (default = any address of this computer)
  -p <number>
       Select a port number (default = 2317); > 1024 for normal users.
  -setup_link
       Display a link to local gwsetup in bottom of pages.
  -allowed_tags <file>
       HTML tags which are allowed to be displayed. One tag per line in file.
  -wizard <passwd>
       Set a wizard password: access to all dates and updating.
  -friend <passwd>
       Set a friend password: access to all dates.
  -wjf
       Wizard just friend (permanently)
  -lang <lang>
       Set a default language (default: fr).
  -blang
       Select the user browser language if any.
  -only <address>
       Only inet address accepted.
  -auth <file>
       Authorization file to restrict access. The file must hold lines
       of the form "user:password".
  -no_host_address
       Force no reverse host by address
  -digest
       Use Digest authorization scheme (more secure on passwords)
  -add_lexicon <lexicon>
       Add file as lexicon.
  -log <file>
       Redirect log trace to this file.
  -robot_xcl <cnt>,<sec>
       Exclude connections when more than <cnt> requests in <sec> seconds.
  -min_disp_req
       Minimum number of requests in robot trace (default: 6)
  -login_tmout <sec>
       Login timeout for entries with passwords in CGI mode (default 1800s)
  -redirect <addr>
       Send a message to say that this service has been redirected to <addr>
  -trace_failed_passwd
       Print the failed passwords in log (except if option -digest is set)
  -nolock
       Do not lock files before writing.
  -max_clients <num>
       Max number of clients treated at the same time (default: no limit)
       (not cgi).
  -conn_tmout <sec>
       Connection timeout (default 120s; 0 means no limit)
  -daemon
       Unix daemon mode.
  -chwd <comm>
       Call command when wdoc changed
iMac-H:gw Henri$

From sources

The folders gw-x.yy contain sources for version x.yy of GeneWeb. Executing the Makefile in this folder (after having Installed OCaml) will create a distribution folder containing all data necessary for execution of GeneWeb. Renaming this distribution folder to GeneWeb-x.yy-Mac and moving it into the GeneWeb folder discussed above brings us to a known situation.

The file gwget-7-00.sh is a shell script that will fetch the latest version of GeneWeb (currently version 7.00) from the GitHub repository, compile it and move the resulting distribution folder appropriately.

Of course, the structure above can be extended to more that two versions of GeneWeb, and to more than two bases. Appropriate editing of the shell scripts and command files may be necessary.