Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

https://jena.apache.org/documentation/migrate_jena2_jena3.html

...

Upgrading your triple

...

stores

It is required that you As described in the Jena upgrade document, it is advisable to reload any SDB and TDB triple stores when upgrading to Jena 3 . Whilst there are command line utilities to do this provided as part of Jena, these have shortcomings with scalability. Plus, they are inconvenient to use as you need to know how to connect to your triple stores to use them. To make this process easier, the VIVO team has developed a couple of tools to handle this process.

Dumping the triple stores

using the procedure and tools described below.


Info
titleWarning

VIVO/Vitro uses two triple stores – a configuration triple store typically stored using TDB in <home>/tdbModels, and a content triple store typically stored using SDB in MySQL.  The procedures described below assume that you are running this standard configuration.  If you are not, you will need a custom procedure for upgrading your triple stores.


Export the triple stores

Warning
  • To export successfully, you need to ensure no other programs are accessing your triple stores.
  • Your file system must have the space available and be capable of storing files large enough to contain your entire triple store serialisation.

First you need to export First you need to dump your existing Jena 2 triple stores. To do so, shutdown Tomcat, and use the jena2tools utility provided with VIVO 1.10, specifying the export command.

...

On execution, the program will find your Vitro or VIVO configuration within the vivo/vitro home directory, and get the necessary information to connect to your configuration triple store (usually <home>/tdbModels), and your content triple store (usually in SDB). If your triple store(s) are not SDB or TDB backed, then it will simply skip them.

It will then extract the contents of the available triple stores, and dump them to <vivo home dir>/dumps in TriG format.

...

.


jena2tools will be present in <vivo home dir>/bin when you install the 1.10.0 alphabeta. Alternatively, it can be downloaded here  GitHub.

Warning

Before executing, ensure that your triple stores are empty.

...

That means dropping all the tables in the SDB schema, and deleting any files in the TDB directory

Importing

...

the triple stores

Having dumped exported your Jena 2 triple stores, you can reload them using jena3tools, specifying the import command.

...

-d - the location of the Vitro/VIVO home directory

-i - run in import mode

...

...

Before executing, ensure that your triple stores are empty. That means dropping all the tables in the SDB schema, and deleting any files in the TDB directory


On execution, the program will find your Vitro or VIVO configuration within the home directory, as well as the dumps that you have created with jena2tools. It will import them into SDB or TDB triple stores, based on the configuration of your Vitro / VIVO instance.

jena3tools will be present in <vivo home dir>/bin when you install the 1.10.0 alphabeta. Alternatively, it can be downloaded here GitHub.

...