...

In order to run VIVO, please read the section below "Completing the Installation".

Anchor
GitHub GitHub

Installing from GitHub

...

The VIVO home directory will now be created and the VIVO application installed to Tomcat. To run VIVO, please read the section below "Completing the Installation".

Custom Installer

If you want to use the source code / GitHub clone with your own customizations, you can exclude the supplied installer project, and use your own customized installer project instead. To do so, you need to supply the location of your custom installer project as the "vivo-installer-dir" property. This can be done on the command line or in the settings.xml. If you are supplying a relative path, it should be relative to the location of the VIVO/pom.xml.

...

The VIVO home directory will now be created and the VIVO application installed to Tomcat, including any customizations that are defined in your local installer project.  To run VIVO, please read the section below "Completing the Installation".

Anchor
Completing Completing

Completing the Installation

Configure the Database Schema

The default configuration of VIVO is to use MySQL as a backing store for Jena SDB. Whilst VIVO / Jena will create the necessary tables for the triple store, a database (schema) and authentication details need to have been created first. To do so, log in to MySQL as a superuser (e.g. root) 

$ 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> GRANT ALL ON vitrodb.* TO 'vitrodbUsername'@'localhost' IDENTIFIED BY 'vitrodbPassword';
mysql> FLUSH PRIVILEGES;

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';
mysql> FLUSH PRIVILEGES;

Configure the Home Directory

...

1. Download and install the latest 7.x version of Solr (installation instructions)
   1. The directory in which Solr is installed is referenced below as ${SOLR_HOME} (e.g. /opt/solr/solr-7.7.2)

   2. Package managers may result in ${SOLR_HOME} being different than the installation directory. You can confirm the value of ${SOLR_HOME} by visiting http://localhost:8983/solr and checking the value of "solr.solr.home" in the Java Properties list, or running 

      Code Block
      language bash
      curl --silent http://localhost:8983/solr/admin/info/system | grep -e "solr_home"

      
      

2. Add the vivocore directory of the vivo-solr GitHub repository and its contents into ${SOLR_HOME}/server/solr

   1. The end result should be a directory structure such as:

      No Format
      ${SOLR_HOME}/server/solr/vivocore/core.properties └── conf/ ├── currency.xml ├── elevate.xml └── ...

      
      

3. Start Solr

   No Format
   ${SOLR_HOME}/bin/solr start

   
   

4. Remove schema.xml from ${SOLR_HOME}/server/solr/vivocore/conf

   1. When solr was started it created the managed-schema automatically from the schema.xml and is no longer needed

5. Update VIVO runtime.properties as below to point to the URL of your Solr

   No Format
   vitro.local.solr.url = http://localhost:8983/solr/vivocore

   
   

6. Start VIVO!
   1. Note: If VIVO was started before connecting to Solr, please restart VIVO.

...

• When you Start tomcat , you see that Tomcat recognizes the webapp, and that the webapp is able to present the initial page.
• The startup status will indicate if the basic configuration of the system was successful. If there were any serious errors, you will see the status screen and will not be allowed to continue with VIVO. If there are warnings, you will see the status screen when you first access VIVO, but after that you may use VIVO without hinderance. In this case, you can review the startup status from siteAdmin -> Startup status.
  
• Log in as root.  Your root username is vivo_root@yourdomainname root@mydomain.edu (or the email you configured in runtime.properties).  The first time root password is rootPassword.  You will be asked to change it.

...