This document describes how to upgrade database from one version of AllegrGraph to a later version of AllegroGraph. Using the same technique, you can also make a copy of a database. The tools and methods described in this document work for all versions of AllegroGraph, 4.4 and later. This includes upgrading from version 4.x to version 5.y.

If you have AllegroGraph version 3.x and want to upgrade to version 5.x please contact Franz Inc. Customer Support (

If you want to upgrade from a version v4.x where x < 4 (e.g., from 4.3 to 5.1.1), see pre-v4.4 Upgrade Guide.

You want two things to be moved from the earlier version to the later: the data and the server settings. The data is the set of triples. The server settings are (more or less) everything else: user information, security settings, etc.

Upgrades from version 4.x

We have version X and a new version Y, with version X <= version Y. The steps are these:

  1. Using agraph-backup of version X, archive all the repositories and settings into the directory specified as an argument (see Backup and Restore for agraph-backup usage).
  2. agraph-backup --port X-port backup-all <directory> 
  3. Using agraph-backup of version Y, restore all the repositories and settings.
  4. agraph-backup --port Y-port restore-all <directory> 

After restoring the settings, you must restart the new (version Y) AG server to reflect the changes.

If the original installation uses catalogs other than root, the same catalogs need to exist in the destination configuration.

Automatic Upgrade

When an archive created by older version of agraph-backup is restored, either by restore or restore-all, the database is converted to the current version by default.

To suppress this operation, give --noconvert option to agraph-backup.