Old Release

This documentation relates to an old version of VIVO, version 1.9.x. Looking for another version? See all documentation.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Installing from Distribution

Overview

 

vivo-1.9.0-rel/
  pom.xml
  default-settings.xml
  home/
    pom.xml
    src
  solr/
    pom.xml
    src
  webapp/

    pom.xml
    src

 

Installing from GitHub

Preparing the Repositories

In order to install the development code from GitHub, you need to clone both the Vitro and VIVO repositories from the vivo-project organization. These clones should be in sibling directories called "Vitro" and "VIVO" respectively:

$ git clone https://github.com/vivo-project/Vitro.git Vitro -b develop
$ git clone https://github.com/vivo-project/VIVO.git VIVO -b develop
$ ls -l
drwxr-xr-x  user  group  1 Dec 12:00  Vitro
drwxr-xr-x  user  group  1 Dec 12:00  VIVO

If you do not place the Vitro code in a sibling directory called "Vitro", then you will have to supply the "vitro-core" property to Maven - e.g. mvn package -Dvitro-core=~/Vitro

It is expected that the Maven project numbers are kept in sync between the Vitro / VIVO projects, however, depending on when you update / sync your repositories, you may need to adjust the project version numbers for the build to work.

Preparing the Installation Settings

In order to fully install VIVO, you need to create a settings file that provides some essential information:

app-name

vivo-dir

tomcat-dir

This file needs to be created following the Maven Settings Reference. A template file has already exists in the "installer" directory within the VIVO project, called "default-settings.xml". You may copy this file (it can be called anything you like), and edit the contents to fit your requirements / system configuration.

Installing VIVO

Once you have an appropriate settings file (these instructions will assume that you are using installer/default-settings.xml - replace this with your actual file), you simply need to run Maven, specifying the install goal, and your settings file.

$ cd VIVO
VIVO$ mvn install -s installer/default-settings.xml
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO] 
[INFO] Vitro
[INFO] Vitro Dependencies
[INFO] Vitro API
[INFO] VIVO
[INFO] VIVO API
[INFO] Vitro Web App
[INFO] VIVO Web App
[INFO] Vitro Home
[INFO] VIVO Home
[INFO] Vitro Solr App
[INFO] VIVO Installer
[INFO] VIVO Prepare Home
[INFO] VIVO Prepare Solr App
[INFO] VIVO Prepare Web App
[INFO]                                                                         
....
 
  • No labels