Goal
This procedure describes the steps required to extract, configure, and deploy code for running UQAM's Vivo-i18n in Canadian-French
Sommaire
Prerequisite
To carry out this procedure, the following steps must have been carried out
1) Starting with basic installation: Java-Maven-Solr-GIT
2) Installing MySQL for Vivo-i18n
3) Installing Tomcat 8.5 for Vivo-1.11.0-i18n
Procedure
1- Configure the code's host environment and extract it
| Step | Action |
|---|
1) Creating the GIT directory |
| Code Block |
|---|
| sudo -s -u tomcat
mkdir /opt/tomcat/GIT
cd /opt/tomcat/GIT |
|
2) Retrieving the code
|
| Code Block |
|---|
| git clone https://bitbucket.org/uqam/vivo-uqam-i18n
username....
password... |
|
| Two directories are under 'vivo-uqam-i18n'. vivo-project-i18n: contains the vivo code itself. vivo-project-i18n-config: contains the files needed to configure vivo |
2- Configure SOLR for Vivo
| Step | Action |
|---|
1) Pepare Solr |
| Code Block |
|---|
| sudo systemctl stop solr |
|
2) Copy configuration files |
| Code Block |
|---|
| sudo -u solr cp -r /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n-config/solr/server/* /opt/solr/server/ |
|
3) Check vivocore in Solr |
| Code Block |
|---|
sudo systemctl start solr
http://YOUR_URL:8983/solr/#/vivocore_i18n/core-overview |
 Image Added
|
2- Preparing VIVO for first start
| Step | Action |
|---|
1) Create VIVO home |
| Code Block |
|---|
| sudo -u tomcat mkdir -p /opt/tomcat/vivo/home
sudo -u tomcat cp -r /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n-config/vivo/home/* /opt/tomcat/vivo/home/
|
|
2) Edit runtime.properties fileMake sure that attribute properties fit with current installation
|
| Code Block |
|---|
| sudo -u tomcat vi /opt/tomcat/vivo/home/config/runtime.properties |
| Code Block |
|---|
| language | bash |
|---|
| title | runtime.properties |
|---|
| Vitro.defaultNamespace = http://<adresse-ip-du-serveur>:8080/vivo/individual/
...
rootUser.emailAddress = vivo@uqam.ca
...
VitroConnection.DataSource.url = jdbc:mysql://localhost/vitrodb
VitroConnection.DataSource.username = vivo
VitroConnection.DataSource.password = <mot-de-passe-de-la-BD>
...
vitro.local.solr.url = http://<adresse-ip-du-serveur>:8983/solr/vivocore
...
RDFService.languageFilter = true
languages.selectableLocales = fr_CA, en_US, de_DE |
|
Check that the file contains the following code: |
| Code Block |
|---|
| sudo -u tomcat vi /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n/vivo-installer-i18n/settings_i18n_uqam.xml |
| Code Block |
|---|
| language | xml |
|---|
| title | settings_i18n_uqam.xml |
|---|
| <settings xmlns="http://maven.apache.org/SETTINGS/1.1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd">
<profiles>
<profile>
<id>defaults</id>
<properties>
<app-name>vivo</app-name>
<vivo-dir>/opt/tomcat/vivo/home</vivo-dir>
<tomcat-dir>/opt/tomcat</tomcat-dir>
<default-theme>wilma</default-theme>
</properties>
</profile>
</profiles>
<activeProfiles>
<activeProfile>defaults</activeProfile>
</activeProfiles>
</settings> |
|
3- Compiling code
| Step | Action |
|---|
1) get into the proper directory |
| Code Block |
|---|
| cd /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n |
|
2) Compile| Info |
|---|
First compile might take a while: lot of files to download and process |
|
| Code Block |
|---|
| sudo -u tomcat mvn -s ./vivo-installer-i18n/settings_i18n_uqam.xml install |
|
3) ValidateCompile process should result in the following message: |
| Code Block |
|---|
[INFO]
[INFO] --- maven-dependency-plugin:3.1.1:unpack (install) @ vivo-installer-webapp-i18n ---
[INFO] Configured Artifact: org.vivoweb:vivo-installer-webapp-i18n:1.11.0-SNAPSHOT:war
[INFO] Unpacking /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n/vivo-installer-i18n/webapp-i18n/target/vivo.war to /opt/tomcat/webapps/vivo with includes "" and excludes ""
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for VIVO Project for i18n 1.11.0-SNAPSHOT:
[INFO]
[INFO] VIVO Languages Canadian French ..................... SUCCESS [ 1.957 s]
[INFO] VIVO Languages Canadian French for Home ............ SUCCESS [ 3.621 s]
[INFO] VIVO Languages Canadian French for Web Ap .......... SUCCESS [ 8.434 s]
[INFO] Vitro Languages Canadian French .................... SUCCESS [ 0.003 s]
[INFO] Vitro Languages Canadian French for Web App ........ SUCCESS [ 1.702 s]
[INFO] VIVO Project for i18n .............................. SUCCESS [ 0.879 s]
[INFO] Vitro API - for i18n ............................... SUCCESS [ 39.580 s]
[INFO] VIVO api for i18n .................................. SUCCESS [ 7.767 s]
[INFO] VIVO installer for i18n ............................ SUCCESS [ 0.004 s]
[INFO] VIVO Install Home for i18n ......................... SUCCESS [ 37.261 s]
[INFO] Vitro Web App for i18n ............................. SUCCESS [ 4.192 s]
[INFO] VIVO Web App for i18n .............................. SUCCESS [ 7.361 s]
[INFO] VIVO Web App Installer for i18n .................... SUCCESS [ 7.937 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 02:11 min
[INFO] Finished at: 2019-11-27T23:43:06Z
[INFO] ------------------------------------------------------------------------ |
|
4- Accessing Vivo
| Step | Action |
|---|
1) Restart tomcat |
| Code Block |
|---|
| sudo systemctl restart tomcat |
|
2) First access to VIVO from browser |
| Info |
|---|
On first web access after compile VIVO présents this page: |
 Image Added
Click ot this link to get to the VIVO's start page
|
5- Final validation
To perform a final check, please refer to the Verify Your Installation section of the VIVO's documentation available on Lyrasis wiki.