Be sure to review System Requirements before installing VIVO. 

Anchor
Distribution Distribution

Installing from Distribution

...

Download the distribution from the VIVO repository on GitHub. The standard distribution consists of the projects required to create a home directory for VIVO, and to copy the web application and search index. All the compiled code and dependencies are resolved from the Maven central repository at the time you run Maven. 

The standard distribution is laid out as follows:

...

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

Set rights(as root) on tomcat's webapp directory to enable automatic install in the coming step with:

chmod -R 777 <tomcat-dir>/webapps

Permissions

Make sure:

• The maven user has write permission to the Tomcat webapps directory. Maven will fail silently if it cannot copy files to tomcat.
• The tomcat user has write permission to the <vivo-dir>/home  directory.

Installing Installing VIVO

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

...

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

...

This file needs to be created following the Maven Settings Reference. A template file already exists in the "installer" directory within the VIVO project, called "example-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

Default Installer

Permissions

Make sure:

• The maven user has write permission to the Tomcat webapps directory. Maven will fail silently if it cannot copy files to tomcat.
• The tomcat user has write permission to the <vivo-dir>/home  directory.

Installing VIVO

Default Installer

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

...

$ mysql -u root -p
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 2
Server version: 5.7.9 MySQL Community Server (GPL)
Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
 
mysql> CREATE DATABASE vitrodb CHARACTER SET utf8utf8mb4 COLLATE utf8mb4_unicode_ci;
mysql> GRANT ALL ON vitrodb.* TO 'vitrodbUsername'@'localhost' IDENTIFIED BY 'vitrodbPassword';

For MySQL 8+, the second command must be split into two commands like so:

mysql> CREATE USER 'vitrodbUsername'@'localhost' IDENTIFIED BY 'vitrodbPassword';
mysql> GRANT ALL PRIVILEGES ON vitrodb.* TO 'vitrodbUsername'@'localhost';

Configure the Home Directory

...