Migrating GraphDB Configurations

If you want to migrate your GraphDB configurations and replicate the setup, there are three steps that you need to follow:

  1. Back up your repository by copying the binary image (explained in more detail here), or restore it from an RDF export or from a binary image or zip backup (explained in more detail here).

For steps 2 and 3, it is useful to know that the GraphDB distribution package consists of several folders that are described in detail here.

  1. Copy the config directory to the new instance. It contains the logback and the GraphDB configuration.
  2. Copy the work directory to the new instance. It contains all Workbench-related details, e.g., saved queries, users, user roles, etc.

Hint

To migrate from one GraphDB version to another, follow the steps in the last column of the table below.

Compatibility between the versions of GraphDB, Connectors and third party connectors

GraphDB RDF4J Connectors Elasticsearch Lucene Solr Steps for migrating to a newer version
8.11.x 2.5.2 11.0.0 6.6.x 7.7.x 7.7.x  
8.10.x 2.5.2 11.0.0 6.6.x 7.7.x 7.7.x  
8.9.x 2.4.6 10.1.0 6.6.x 7.7.x 7.7.x Recreate all the connectors with the repair option.
8.8.x 2.4.2 10.0.0 6.3.x 7.4.x 7.4.x No special attention needed.
8.7.x 2.3.2 9.0.0 6.3.x 7.4.x 7.4.x Recreate all the connectors with the repair option. Need to rebuild Semantic similarity search indexes.
8.6.x 2.3.2 8.0.0 6.2.x 7.2.x 7.2.x Need to rebuild GeoSPARQL index.
8.5.x 2.2.4 7.2.0 5.3.x 6.5.x 6.5.x No more system repository in future installations. During the upgrade procedure, system repository will be removed while the data insight will be backed up. There will be config.ttl file in each repository directory with config data. Important points: 1. Cannot query System repo. 2. More strict parser - IRI validation according to RFC3987
8.4.x 2.2.2 7.2.0 5.3.x 6.5.x 6.5.x Autocomplete is no longer part of the fingerprint. In case of cluster, this will lead to out of sync for the workers. Stop the master and rename the txlog for backup purposes. Start the master again.
8.3.x 2.2.2 7.1.0 5.3.x 6.5.x 6.5.x No special attention needed.
8.2.x 2.2.1 7.0.0 5.3.x 6.5.x 6.5.x No special attention needed.
8.1.x 2.1.6 6.0.2 2.4.0 6.2.1 6.2.1 Recreate all the connectors with the repair option. Please note the breaking changes for each connector. https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking-changes-5.0.html https://lucene.apache.org/solr/guide/6_6/upgrading-solr.html#upgrading-solr
8.0.x 2.0.3 6.0.2 2.4.0 6.2.1 6.2.1 No special attention needed. Important points: 1. The engine replaces PCSO and PCOS indexes with CPSO. 2. Remove the owlim-license parameter from the repository TTL configuration.
7.2.x   5.1.1 2.3.1 5.5.0 5.5.0 Ask for support
7.1.x   5.1.0 2.3.1 5.5.0 5.5.0 Ask for support
7.0.x   5.0.1 2.3.1 5.5.0 5.5.0 Ask for support
6.6.x   4.2.7 1.7.2 4.10.4 4.10.4 Ask for support
6.5.x   4.2.3 1.7.2 4.10.4 4.10.4 Ask for support
6.4.x   4.1.2 1.6.0 4.10.4 4.10.4 Ask for support
6.3.x   4.0.1 1.6.0 4.10.4 4.10.4 Ask for support
6.2.x   4.0.1       Ask for support
6.1.x   3.1.4       Ask for support
6.0.x   3.0.0   3.6.2   Ask for support