Upgrading from GRAMPS 2.2.x to 3.0.x

From Gramps
Revision as of 17:37, 8 August 2008 by Robocoder (talk | contribs) (cat)
Jump to: navigation, search
This is a work in progress.

Upgrading from GRAMPS 2.2.x to 3.0.x can be a pain-free process. The first step is to backup your database using GRAMPS' Export function. (Your version of GRAMPS may already automatically save copies of the .grdb and GRAMPS XML files.) The second step is to upgrade the application (discussed elsewhere). For the final step, this How-To article discusses some of the finer details in migrating your database.


The internal database format has changed between GRAMPS 2.2.x and 3.0.x. When you first start GRAMPS 3.0.x, your existing family tree(s) won't appear in the "Family Trees" window. Don't panic. You have not lost any data. Yet. ;)

If you didn't manually backup your database, look in ~/.gramps/env to see where your automatic backups are stored.

find ~/.gramps/env -name '*.grdb'

A path like /home/jdoe/.gramps/env/home/jdoe/subpath/data.grdb would suggest we look in the folder, /home/jdoe/subpath where we'll hopefully find files, data.backup.gramps (your family tree in GRAMPS XML format) and data.grdb.

Now would be a good time to make a copy of these files ... just in case.

If you don't have any backup files, you should revert the application back to GRAMPS 2.2.x and then make a backup.

Database Migration

  1. Launch GRAMPS 3.0.x.
  2. In the (Manage) "Family Trees" window, select "New" to create a new family tree database.
  3. Enter an appropriate name for your family tree. You can safely use the same name because your new family tree is stored in a different directory, ~/.gramps/grampsdb.
  4. Next, Import from your backup file, e.g., data.backup.gramps.
  5. Go to Media and check for broken links to be fixed. Broken links occur if you used Relative Paths.
  6. If you imported from a .grdb file, you will have to select an Individual before some functions work correctly (e.g., Pedigree).

Corrections appreciated. Enjoy!