Upgrading from GRAMPS 2.2.x to 3.0.x

From Gramps
Jump to: navigation, search

Upgrading from GRAMPS 2.2.x to 3.0.x can be a pain-free process.

  1. The first step is to backup your GRAMPS 2.2.x database using GRAMPS Export function. (Your version of GRAMPS may already automatically save copies of the .grdb and GRAMPS XML files.)
  2. The second step is to upgrade the application (discussed elsewhere).
  3. For the final step, this How-To article discusses some of the finer details in migrating your database.

New GRAMPS 3.x database format

GRAMPS 3.x uses a newer database format than GRAMPS 2.2.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. Your GRAMPS 2.2.x family database is safe and you have not lost any data.

If you did not 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 (your family tree in GRAMPS .grdb format) .

Now would be a good time to make a backup 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).

See also