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.jar
genealogy-support.jar
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
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.
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.
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, an SQL database.