The next major release of Vitro / VIVO contains an upgrade of Jena - from 2.10.1, to Jena 3.x (3.1.1 at time of writing). Whilst development is still progressing, in order to maximise amount of testing of this core upgrade, an alpha has been released.
What has changed
Jena 3 improves Jena's RDF 1.1 compatibility. Specifically, literal values always have datatypes. "Untyped" string literals are the same as the identical value typed as xsd:string. See the following document for more information
https://jena.apache.org/documentation/migrate_jena2_jena3.html
In addition, many dependencies and components have been updated - this includes Freemarker, commons-* libraries, jQuery and associated plugins.
Reloading the triple store
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
First you need to dump your existing Jena 2 triple stores. To do so, use the jena2tools utility, specifying the export command.
java -jar jena2tools.jar -d <vivo home dir> -e
Arguments:
-d - the location of the Vitro/VIVO home directory
-e - run in export mode
On execution, the programme will find your Vitro or VIVO configuration within the 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.
- 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.
jena2tools will be present in <vivo home dir>/bin when you install the 1.10.0 alpha. Alternatively, it can be downloaded here .
