Installing GeneWeb under OS X
|Language:||English • français|
The simplest install is as follows (process verified on OS X Yosemite):
- Download the appropriate version. The latest stable version available is
- Double-clicking on the downloaded .tgz file creates a subfolder
- Rename this folder to your liking, for instance
- Move this folder where you prefer.
- Start GeneWeb by double-clicking the
GeneWeb.commandin this folder (not
gwsetup). This should open a terminal window and browser window with the start page of GeneWeb.
- Note that on recent macOS versions, executable code must be signed for execution to proceed. For unsigned executables (which is currently the case for GeneWeb), one must
- click-right and select the "open" option. After one such process, double-clicking will be accepted.
- If the terminal windows just opened indicated "failure", this may be due to some idiosyncrasies of your environment.
- Try the following:
- Open the file
GeneWeb.commandin a text editor
- Replace the line
- Open the file
trap 'kill $pids' 1 2
- and save the result back to disk.
- Start GeneWeb by double-clicking the new
When GeneWeb is running on a machine, it behave like a web server and will accept URLs following a precise syntax. You can lauch GeneWeb with a lot of parameters, for example as a Unix daemon or behind a real HTTP server with CGI.
With this direct and simple installation approach, the bases created and managed by GeneWeb are located in
/MyGeneWeb/bases. To setup GeneWeb in a more elaborate configuration, where code and bases are separated in two distinct folders, see the bases page.
Multiple versions install
Installing multiple versions of GeneWeb is possible. The following section describes one approach. One of its benefits is to make more explicit several aspects of the folder structure expected by GeneWeb.
The first step is to organise a folder structure which will contain the various elements. Although style and taste may vary, here is a proposal for such a structure which is rather general, identifies the various components associated with GeneWeb and is amenable to changes.
All the genealogy files are located in a folder called Genealogy sitting in “Home”, and containing two sub-folders "GeneWeb" (sources and binaries), “GeneWeb-Bases” (bases and other base specific data. a specific base may be called base in the following discussions and examples) and two command files launching each one particular version of gwd and gwsetup (see below):
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$
In this organisation, the
GeneWeb folder contains one or several GeneWeb distribution (detailed organisation of one distribution folder), and the
GeneWeb-Bases folder contains one or several genealogy bases.
This setup has the advantage of maintaining active at least two running versions of GeneWeb which may be handy for moving bases from one version to the other.
The two folders gw-6.08-alpha-src and gw-7.00-Mac and file gwget-7-00.sh relate to GeneWeb sources and will be discussed in section #From sources.
Starting gwd and gwsetup
With this folder organisation, clicking on
$HOME/Genealogy/Gw-Mac-7.00.command (download it here, you have to execute a chmod +x on this file to use it) 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.
Compilation from sources requires installation of OCaml. This is best done with Opam which will handle module dependencies.
Once Opam is installed, you can install the appropriate version of Ocaml (4.13.0 or 4.14.0) by running:
opam switch create ocaml.4.13.0
Compiling GeneWeb requires installation of a collection of modules:
opam install benchmark camlp5 camlp-streams cppo dune jingoo markup num odoc ounit ppx_blob opam install ppx_deriving ppx_import stdlib-shims syslog uucp uunf uutf zarith opam install calendars.1.0.0 opam install unidecode.0.2.0
Obtaining and compiling the sources of GeneWeb is done through the following set of commands:
git clone https://github.com/geneweb/geneweb.git cd geneweb ocaml ./configure.ml make distrib
If some "undefined module" error message appear during compilation, do a
opam install missing_module and repeat the
make distrib command.
Note that the file
dune-project contains the list of modules used by GeneWeb.
Successful execution of
make distrib creates a
distribution folder which you can rename and relocate wherever you whish, and you are in the situation assumed at the start of this chapter.