Summary
Introduction
This page presents the procedure for migrating data from DSpace to VIVO. It answers the use case of a VIVO instance in read-only mode used to present the metadata contained in DSpace
Goals
- The scenario to be realized by this procedure consists in developing the necessary steps in order to migrate the metadata of two DSpace instances (the DSpace-6 Demo instance and the DSpace-7 Demo instance) to a local VIVO instance
- At the end of this procedure, the experimenter should have a fully operational VIVO instance containing the metadata harvested from DSpace-6-Demo DSpace-7-Demo, both of which are available from the web.
- The experimenter will also have in his possession, the necessary information to harvest in VIVO the metadata of a DSpace instance that he will have chosen and that it is possible to harvest from an OAI-PMH endpoint
Useful addresses
| Title | URL | Description |
|---|---|---|
| DSpace-6 Demo Home Page | https://demo.dspace.org/ | This entry page links to other links concerning the DSpace-6 demo |
| DSpace-6 Demo UI | https://demo.dspace.org/xmlui/ | This page is the DSpace-6 api allowing to manipulate metadata |
| DSpace-6 OAI Api | https://demo.dspace.org/oai/request | OAI API used to harvest data |
| DSpace-7 Demo Home Page | https://demo7.dspace.org/home | This entry page links to other links concerning the DSpace-7 demo |
| VIVO Project GitHub Home Page | https://github.com/vivo-project | Source code location needed to install VIVO |
| DSpace-VIVO Integration Project (DV-IP) | https://github.com/vivo-community/DSpace-VIVO | Source code location for the migration of DSpace metadata to VIVO |
| DSpace-VIVO ETL Example | https://github.com/vivo-community/DSpace-VIVO/tree/main/test/org.vivoweb.dspacevivo.etlexample | Source code location for extract-transform-load (ETL) metadata processing from DSpace to VIVO |
Useful variable and constant names
| Title | Var Name | Var Value | Description |
|---|---|---|---|
| Project root directory | DVIP_HOME_PRJ | ~/dspace-vivo-prj | The value content is a suggestion |
| Git root directory | GIT_REPO | $HOME_PRJ/00-GIT | Directory containing extracted GIT projects |
Software requirements
- jdk 11
- maven 3.6.3
- Linux Ubuntu
- No solr or tomcat instance should be running on the computer
Setting up
Put in place the necessary resources for the operation of VIVO
| Step name and description | Commands |
|---|---|
| Setting up project | mkdir -p ~/dspace-vivo-prj/00-GIT |
| Retrieve the DV-IP source code | git clone https://github.com/vivo-community/DSpace-VIVO |
| Install Solr + Tomcat | ./DSpace-VIVO/releng/org.vivoweb.dspacevivo.installer/00-INIT/install-tomcat-solr-app.sh |
| Installing/compiling VIVO | ./DSpace-VIVO/releng/org.vivoweb.dspacevivo.installer/01-VIVO/vivo-git-clone.sh ./DSpace-VIVO/bundles/org.vivoweb.dspacevivo/script/vivo-compile-and-deploy-for-tomcat.sh |
Run - Start/Stop VIVO | Starting VIVO source ./DSpace-VIVO/bundles/org.vivoweb.dspacevivo/script/00-env.sh solr-start.sh tomcat-start.sh To show VIVO in a Web Browser browse-vivo.sh For stopping VIVO tomcat-stop.sh solr-stop.sh |
