Objectif
Ce procédure décrit les étapes nécessaires pour extraire, configurer et déployer le code pour l'exécution en fr_CA de Vivo i18n de l'UQAM
Sommaire
Prérequis
Pour réaliser cette procédure, les étapes suivantes doivent avoir été réalisées
a) Installation de base: Java-Maven-Solr-GIT
b) Installer MySQL pour Vivo-i18n
c) Installer Tomcat 8.5 pour Vivo-i18n 1.11.0
Procédure
1- Configurer l'environnement d'accueil du code et l'extraire
Étape | Action |
---|---|
1) Créer le répertoire GIT | sudo -u tomcat mkdir /opt/tomcat/GIT cd /opt/tomcat/GIT |
2) Extraire le codeRemplacez <votre-loggin> par votre loggin | sudo -u tomcat git clone https://<votre-loggin>@bitbucket.org/michelheonuqam/vivo-uqam-i18n.git |
3) Analyse de l'extraction | Deux répertoires sont sous 'vivo-uqam-i18n' vivo-project-i18n: contient le code vivo proprement dit vivo-project-i18n-config: contient les fichiers nécessaires à la configuration de vivo |
2- Configurer SOLR pour Vivo
Étape | Action |
---|---|
1) Préparer solr | sudo systemctl stop solr |
2) Copier les fichier de configuration | sudo -u solr cp -r /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n-config/solr/server/* /opt/solr/server/ |
3) Valider vivocore dans solr | sudo systemctl start solr http://VOTRE_URL:8983/solr/#/vivocore |
2- Préparation de VIVO avant la préparation
Étape | Action |
---|---|
1) Créer l'espace home de vivo | 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) Éditer le fichier runtime.propertiesValider le fichier afin d’assigner la bonne valeur aux attributs | sudo -u tomcat vi /opt/tomcat/vivo/home/config/runtime.properties 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 |
3) Éditer et configurer le fichier de settings de l'installateur de VivoS'assurer le contenu du fichier contienne le code suivant | sudo -u tomcat vi /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n/vivo-installer-i18n/settings_i18n_uqam.xml 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- Compiler le code
Étape | Action |
---|---|
1) se positionner dans le bon répertoire | cd /opt/tomcat/GIT/vivo-uqam-i18n/vivo-project-i18n |
2) Lancer la compilationLa première compilation est assez longue et beaucoup de fichiers sont téléchargés | sudo -u tomcat mvn -s ./vivo-installer-i18n/settings_i18n_uqam.xml install |
3) ValiderLa compilation devrait se terminer par texte suivant: | [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- Accéder à Vivo
Étape | Action |
---|---|
1) Redémarrer tomcat | sudo systemctl restart tomcat |
2) Accèder à ViVo dans le fureteur | Lors d'un premier démarrage de Vivo, le site présente cette page Cliquez sur le lien pour obtenir cette page |
5- Vérification finale
pour effectuer une vérification finale, nous pour proposons d'accéder à la section Verify Your Installation de la procédure d'installation du Vivo sur le site de Lyrasys