What happens at GenJ Installation or Update?


From the GenJ download page you download GenJ for an installation or for an update. According to the options of your browser this installation package will arrive in a folder on your computer, say 'Download'. The file is a zipped (compressed) package to reduce the size during download and contains all the files needed for installation.


Windows: Unzip genj_win-nn.zip and start the setup.exe. The installer genj_install-<nnnn>.jar is started. If indicated it should be allowed in the firewall.

  • Select the language for the installation dialog
  • Accept the license conditions
  • Define the installation path, e.g. 'C:\Program Files\GenJ' where the program code of GenJ will be stored.
  • Decide whether to generate links in the start menu and on the desktop
  • Define where in the start menu the GenJ entry shall be
  • Select the languages to be installed in Genj. Afterwards only those can be selected in the Program Options.

Debian Linux, Ubuntu: in user mode, no admin rights needed

jar: Double-click on the genj_install-nn.jar activates the Java Run-Time Environment (RTE) to install GenJ.

(If on your system .jar is not assigned to Java and an archive program opens instead, close this and start the installation with right-click and context menu 'open with Java'.)

zip: expand the zip file into a folder of your choice, e.g. programs/genj and start run.sh.

On the GNOME desktop in Linux you can generate a launcher with icon in the panel:
right-click on a free space of the panel → 'add launcher' → 'custom application launcher' → 'type: application; name: GenJ; command: <path>/genj/run.sh'.

Mac: <who can describe?>

All systems: Normally the downloaded file is not needed anymore and can be deleted.

First Start

At the first start GenJ will generate a system folder .genj with the specific permanent information of your installation, e.g. the option settings of GenJ and your GEDCOM files, the log file etc.
(To see this folder you have to make system folders visible in your file manager.)
In Windows you will find it actually in c:\Documents and Settings\user\Application Data\GenJ3, in Linux in your home directory under .genj3.

Your GEDCOM files

You now may create your GEDCOM files.
:!: It is strongly recommended to store your data in a completely separate folder, e.g. 'Genealogy'. A common place in Windows is c:\Documents and Settings\user\My Documents. Better is to put the directory in another partition for user files. This is for easier backup.

GenJ Updates

To update GenJ you may download Unstables of GenJ and unzip them as explained above into your existing Genj program code folder. Use the option 'overwrite existing files'.

:!: With this folder structure you can easily understand that a re-installation or an update of the program can never corrupt your GEDCOM data nor your option settings.

en/manual/installation_update.txt · Last modified: 2010/12/01 19:29 by kpschubert
Get GenealogyJ at SourceForge.net. Fast, secure and Free Open Source software downloads Recent changes RSS feed Creative Commons License Driven by DokuWiki