Document Status : draft, awaiting review
This section presents a step-by-step execution of the process of extracting, compiling, and executing VIVO with UQAM-DEV.
1. Cloning VIVO and VIVO installer repositories
1.1 Select the Git perspective 1.2 Click on Clone Git repository |
|
1.3 Provide the repository URI : https://github.com/UQAM-VIVO/Vivo-installer-i18n.git and click Next |
|
1.4 Select The feature/i18n_en_CA branch must be used for now, but will eventually be merged in master. |
|
1.5 Make sure the proper path to the Git directory is provided 1.6 Click Finish to add the repository to UQAM-DEV. |
|
1.7 Repeat steps 1.1 through 1.6 using the following repositories URI: https://github.com/vivo-project/Vitro.git https://github.com/vivo-project/VIVO.git https://github.com/vivo-project/Vitro-languages.git https://github.com/vivo-project/VIVO-languages Note: for developement purposes, you would have to clone VIVO repositories in your own GitHub account and clone those URI instead. Make sure to select the appropriate branch ! For the current i18n initiative, the working branch is |
|
| 1.8 When all the repositories are cloned, your Git perspective should look like this: |
|
2. Importing VIVO code into the UQAM-DEV workspace
| 2.1 In the menu File, select Import |
|
| 2.2 Select Maven > Existing Maven Projects, and click next |
|
2.3 Provide the path to the Git repository, and click Finish |
|
| 2.4 Selecting the Java perspective, this is how your Project Explorer should look after the importation |
|
3. Compiling and running VIVO
Temporary steps pending merge of 3.0.1 In the Git perspective, right-click on the repository Vivo-installer-i18n 3.0.2 In the contextual menu, select Switch to 3.0.3 Then select the |
|
Temporary steps pending merge of 3.0.4 In the Java perspective, right-click on vivo-installer-home-i18n 3.0.5 Select Maven 3.0.6 Select Update Project... |
|
Temporary steps pending merge of 3.0.7 Make sure vivo-installer-home-i18n is checked, then click OK. Steps 3.0.1 through 3.0.7 must be performed prior to compiling whenever a Git repository was switched to a different branch. |
|
| 3.1 In the Java perspective, select vivo-project-i18n INSTALL |
|
| 3.2 The Console tab will display the Maven stack trace. |
|
| 3.3 Once Maven has compiled the build with success, start Solr. |
|
| 3.4 When first starting Solr, you might have to authorize its execution through the Firewall. Choose the parameters you deem adequate, and click Authorize. |
|
| 3.5 Solr is running. |
|
| 3.6 Then, start Tomcat. |
|
3.7 Tomcat will launch from another window. Upon success, the server will display the following message:
This new window has to stay open for Tomcat to run. Closing the window is actually the method used to shut down the server. |
|
3.8 VIVO will be available at http://localhost:8080/vivo/ It may take some time for the initial page to load, as VIVO will be building its database. When first loading, VIVO will issue a FreemarkerEmailFactory$Setup warning. Ignore it and click on Continue. |
|
3.9 Enter the following credentials to access VIVO in administrator mode:
|
|
4. Loading a fr_CA sample dataset
| 4.1 Follow this link to download the dataset on your computer : sample-data-fr_localhost-vivo.ttl | |
| 4.2 In VIVO, log in as administrator (see point 3.9 above) and click on Site Admin. |
|
| 4.3 Click on Add / Remove RDF data |
|
4.4 Upload the dataset downloaded on step 4.1 4.5 Select Add mixed RDF 4.6 Select Turtle format 4.7 Check create classgroups automatically 4.8 Submit |
|
4.9 VIVO might take some time to populate the triplestore. |
|
