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
| Step | |
|---|---|
1.1 Select the Git perspective 1.2 Choose 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
| Steps | Description |
|---|---|
| 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 This is how your Project Explorer should look after the importation |
|
3. Compiling and running VIVO
| Steps | Description |
|---|---|
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 Then, start Tomcat. |
|
| |
3.4 Tomcat will launch in another window. Upon success, the server will
This new window has to stay open for Tomcat to run. |
|
3.5 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.6 Enter the following credentials to access Vivo in administrator mode:
|
|
