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.
Go to www.sf.net/projects/genealogy and download the latest release of Genealogy, consisting of the files
genealogy-src.jar (only if you want the source code)
Place the files in any directory.
Go to www.mysql.com and download the latest release of MySQL for your operating system.
The installation will be different for each operating system, but instructions for installation are on www.mysql.com in the MySQL manual, chapter 4.6 "Installing a MySQL Binary Distribution".
The MySQL system uses usernames and passwords to determine who has what kind of access.
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.
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
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.
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.
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.
You can also create new
projects, new researchers, and shuffle researchers around among
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
MySQL, an SQL database.
gnu.regexp, regular expressions for Java.
mm.mysql, a JDBC driver for MySQL.