Genealogy Logo
A Groovy Java Project
Latest version: 0.0.5pre1

Note: Running this software in MS-DOS, Windows 3.1, or Windows 95 will not work; you will need to upgrade to Windows 98. Other operating systems should have no problems.

Note: At this stage in the project, Genealogy is not for the ordinary user. To set up the software, you must have significant experience in your operating system!

Note: You must have Java 1.3.x installed.

1. Install Genealogy.

1.1 Collect Genealogy.

Go to and download the latest release of Genealogy, consisting of the files

1.2 Install Genealogy.

Place the files in any directory.

2. Install and run MySQL

2.1 Collect MySQL.

Go to and download the latest release of MySQL for your operating system.

2.2 Install MySQL.

The installation will be different for each operating system, but instructions for installation are on in the MySQL manual, chapter 4.6 "Installing a MySQL Binary Distribution".

2.3 Configure MySQL.

The MySQL system uses usernames and passwords to determine who has what kind of access.

2.3.1 Initial setup.

If you have already installed and used MySQL on your computer, you can skip this step.

First, run the program mysql_install_db, located in the MySQL installation directory. This creates a user called "root" with no password, who is allowed to do anything.

Next, change root's password to some password you choose (some_pass ):

> mysqladmin -u root password some_pass
> mysqladmin -u root@localhost password some_pass

If you got an error about not being able to connect to the local MySQL server, then MySQL is not running. Consult chapter 4.16 "Post-installation Setup and Testing" of the MySQL manual.

3. Running Genealogy

When you run Genealogy, you will be required to enter a username and password that you will use to access the database. I suggest genadmin as the username. Enter whatever password you like.

If you have not previously used the program, Genealogy will next ask for the database administrator username (root) and password. This is as in step 2.3.1.

3.1 Importing Rootsweb Census Transcription File

Rootsweb census transcription project files are available at the Rootsweb Census Transcription Project Completed Transcriptions page .

Download a few files within the same state and county. Now run:

java -cp yourdir/genealogy.jar:yourdir/genealogy-support.jar groovyj.genealogy.GenwebCensusImporter file1 file2 ...

(all on one line) where yourdir is the directory you placed the Genealogy jar files in, file1 is the first transcription file, file2 is the second transcription file, and so on. NOTE: On a Windows platform, you must use a semicolon (;) instead of a colon (:).

If all goes well, Genealogy will parse the files -- which takes very little time -- and add all the data as Assertions in the database -- which takes quite a while.

3.2 Projects and Researchers

You can also create new projects, new researchers, and shuffle researchers around among projects:

java -cp yourdir/genealogy.jar:yourdir/genealogy-support.jar groovyj.genealogy.Main

(all on one line) where yourdir is the directory you placed the Genealogy jar files in. NOTE: On a Windows platform, you must use a semicolon (;) instead of a colon (:).


Groovy Java Genealogy is made possible by the following open-source projects:

MySQL MySQL, an SQL database.

gnu.regexp, regular expressions for Java.

mm.mysql logo mm.mysql, a JDBC driver for MySQL.