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.

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

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-relrel-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.

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

...

$ 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 utf8;
mysql> utf8mb4 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

...

VIVO is a multithreaded web application that may require more threads than are permitted under the default configuration of your operating system's installation's default configuration. Ensure that your installation can support the required number of threads for your application.  For a Linux production environment you may wish to make the following edits to /etc/security/limits.conf, replacing apache and tomcat with the appropriate user or group name for your setup:

...