Repository files navigation

VIVO is an open source semantic web tool for research discovery -- finding people and the research they do.

VIVO supports editing, searching, browsing and visualizing research activity in order to discover people, programs,facilities, funding, scholarly works and events. VIVO's search returns results faceted by type for rapid retrieval ofdesired information across disciplines.

https://vivo.lyrasis.org/

https://wiki.lyrasis.org/display/VIVO/

Installation instructions for all releases can be found at this location on the wiki:
https://wiki.lyrasis.org/display/VIVODOC/All+Documentation

When you select the wiki pages for technical documentation for the release you would like to install athttps://wiki.lyrasis.org/display/VIVODOC/All+Documentation, please open the Installing VIVO section and follow the instructions.

VIVO docker container is available atvivoweb/vivo with accompanyingvivoweb/vivo-solr. These can be used independently or with docker-compose.

Docker Compose variable substitution:

.env defaults

SOLR_RESET_CORE=falseSOLR_VERBOSE=noSOLR_HOST_PORT=8983SOLR_CONTAINER_PORT=8983SOLR_CORES=./vivo-coresVIVO_RESET_HOME=falseVIVO_VERBOSE=noVIVO_TDB_FILE_MODE=directVIVO_HOST_VIVO_HOME=./vivo-homeVIVO_CONTAINER_VIVO_HOME=/usr/local/vivo/homeVIVO_HOST_PORT=8080VIVO_CONTAINER_PORT=8080

• SOLR_RESET_CORE: Convenience to reset VIVO Solr core when starting container.Caution, will require complete reindex.

• SOLR_VERBOSE: Increase log verbosity.

• SOLR_HOST_PORT: Host port binding for solr service port mapping.

• SOLR_CONTAINER_PORT: Container port binding for solr service port mapping.

• SOLR_CORES: Solr cores data directories on your host machine which will mount to volume in docker container. Set this environment variable to persist your Solr data on your host machine.

• VIVO_RESET_HOME: Convenience to reset VIVO home when starting container.Caution, will delete local configuration, content, and configuration model.

• VIVO_VERBOSE: Increase log verbosity.

• VIVO_TDB_FILE_MODE: TDB file mode. Seehttps://jena.apache.org/documentation/tdb/configuration.html#file-access-mode.

• VIVO_HOST_VIVO_HOME: VIVO home directory on your host machine which will mount to volume in docker container. Set this environment variable to persist your VIVO data on your host machine.

• VIVO_CONTAINER_VIVO_HOME: VIVO home directory within the container.

• VIVO_HOST_PORT: Host port binding for VIVO Tomcat service port mapping.

• VIVO_CONTAINER_PORT: Container port binding for VIVO Tomcat service port mapping.

Before building VIVO, you will also need to clone (and switch to the same branch, if other than main) ofVitro. The Vitro project must be cloned to a sibling directory next to VIVO so that it can be found during the build.

Build and start VIVO.

1. In VIVO (with Vitro cloned alongside it), run:

mvn clean package -s installer/example-settings.xmldocker-compose up

To build and run local Docker image.

docker build -t vivoweb/vivo:development .docker run -p 8080:8080 vivoweb/vivo:development

There are several ways to contact and join the VIVO community. All of them are listed athttps://vivoweb.org/contact/.

If you would like to contribute code to the VIVO project, please read instructions atthis page. Contributors welcome!

If you are using VIVO in your publications or projects, please cite the software paper in the Journal of Open Source Software:

• Conlon et al., (2019). VIVO: a system for research discovery. Journal of Open Source Software, 4(39), 1182,https://doi.org/10.21105/joss.01182

@article{Conlon2019,  doi = {10.21105/joss.01182},  url = {https://doi.org/10.21105/joss.01182},  year = {2019},  publisher = {The Open Journal},  volume = {4},  number = {39},  pages = {1182},  author = {Michael Conlon and Andrew Woods and Graham Triggs and Ralph O'Flinn and Muhammad Javed and Jim Blake and Benjamin Gross and Qazi Asim Ijaz Ahmad and Sabih Ali and Martin Barber and Don Elsborg and Kitio Fofack and Christian Hauschke and Violeta Ilik and Huda Khan and Ted Lawless and Jacob Levernier and Brian Lowe and Jose Martin and Steve McKay and Simon Porter and Tatiana Walther and Marijane White and Stefan Wolff and Rebecca Younes},  title = {{VIVO}: a system for research discovery},  journal = {Journal of Open Source Software}}