...
Info | ||
---|---|---|
| ||
in draft |
Sommaire |
---|
...
What is UQAM-DEV?
UQAM-DEV is an execution and developpement environnement development environment for VIVO.
- See also : What is UQAM-DEV?
...
Requirements
All the tools necessary for VIVO development – such as Maven, GIT, code editor, ontology engineering and editing, etc. – are directly integrated into the Eclipse environment.
It is therefore not necessary to install those tools on your platforms, unless you want to use them outside of Eclipse.
1
...
The neon-3 version is required for compatibility with the Topbraid Composer Free Edition Ontology Editor.
Follow the link below to install the J2EE developer version of eclipse for the desired platform. In this demonstration we will be using the 64-bit version of Linux.
For further information, you can read the Eclipse platform overview.
1.2 Java JDK
An essential prerequisite for the operation of UQAM-DEV is the installation of Java JDK, version 8.
...
Installing TopBraid Composer
This release (Rev 4) is based on the TopBraid Composer (TBC) software. TBC is an ontological engineering tool. It allows ontology editing, the aggregation of several ontologies and the representation of ontology content in a visual form. UQAM-DEV Rev.4 is based on the technology of this tool.
The installation of UQAM-DEV starts with the download of TBC Free Edition which is available from this link:
...
...
...
Download and install the right version for your operating system
2 Installing UQAM-DEV
You can continue the installation of UQAM-DEV by following these steps:
1.3 Setting-up Eclipse ini file
Some parameters must be changed in $ECLIPSE_HOME/eclipse.ini.
Under Ubuntu, replace the vmargs parameters with:
Bloc de code |
---|
-vmargs
--add-modules=ALL-SYSTEM
-Dsun.jnu.encoding=UTF-8
-Dfile.encoding=UTF-8
-Dosgi.requiredJavaVersion=1.8
-Dosgi.dataAreaRequiresExplicitInit=true
-Dosgi.instance.area.default=@user.home/eclipse-workspace
-XX:+UseG1GC
-XX:+UseStringDeduplication
-Xmx4096M
-Xms640M
-XX:SurvivorRatio=16
-XX:NewRatio=3 |
Under Windows, you should as well add a vm parameter, providing the path to your Java bin directory:
Bloc de code |
---|
-vm
C:\Program Files\Java\jdk1.8.0_171\bin |
1.4 Linux xrdp (optional for Windows Remote Desktop)
This optional requirement may be useful for developers who wish to connect to a Linux Desktop via the Windows Remote Desktop.
Bloc de code |
---|
sudo apt -y install xrdp tigervnc-standalone-server
sudo systemctl enable xrdp |
...
Step | Description | ||
---|---|---|---|
2.1 Unzip and launchEclipseTopBraid ComposerIn your favorite directory (ex.: in my case
| By default, Eclipse TopBraid will ask you to select a workplaceworkspace. The actual location of that workplace that workspace has little importance. You can locate it wherever you want, choose to use it as default if desired, and proceed. Eclipse Topbraid will then display a general information window. Dismiss it to get to Eclipse main interface: | ||
2.2Eclipse Installing newInstalling UQAM-DEV with TopBraid Installing New SoftwareUnder Help Menu, Select Install New Software | |||
2.3 Adding Software SiteFrom the Available Software window, click on the Available Software Sites link to bring up the preference window. Then click on the add button. | enter 2.4 Assign UQAM-DEV SoftwareIn the Add Site form, provide the following name and URL: UQAM-DEV http://vivo-i18n.dev.uqam.ca:8080/uqam-dev/releaserev410/ Then click OK and then OK again in the preference window. | ||
2.5 Select UQAM-DEV in Available Software WindowsIf UQAM-DEV fails to appear in the dropdown menu, you may refresh it by clicking Cancel, and selecting again the menu Install New Software as in step 2.2. | |||
2.6 Select the desired featuresAfter a few seconds, Eclipse will display the features that are most convenient for you. Select them, and click on Next. | |||
in the Work With Field and 'Select All' check box Then click on the 'Next' button. | |||
2.42.7Complete the installationAnswer positively to all the questions and finalize the installation by clicking on Finish. The following dialogue should appear and you just have to wait a little while until the process is complete. You will be asked security questions, you must accept them by clicking on the OK button. At the end of the installation, you will be offered to restart Eclipse. Click 'Yes'. | |||
2.85 Complete the configurationFor this configuration step, Eclipse will restart twice. You will therefore see those two splash screens appear before you can access your workspace. |
3 Testing the installation
Here are a few observations checks that will help ensure that UQAM-DEV is correctly configured.
ObservationCheck | Description |
---|---|
3.1)Perspectives and projectsAfter the UQAM-DEV has been installed:
The list of projects should appear as shown in the second image. | |
3.2)Project ContentsEach project starting with a number contains a list of files needed to run VIVO. Make sure that the files that are part of your installation look like the figure shown here. | |
3).3 Setup External ToolsThis step completes and validates the installation of the external tools that are ready to be configured in UQAM-DEV.
| |
3.4)Setup Run ConfigurationsThis step completes and validates the installation of the run tools that are ready to be configured in UQAM-DEV. In 1) scroll down the menu corresponding to the Run button, and choose organize favorites Organize Favorites... In 2) in the dialog box that will appear, click on ADD'Add', then 'Select All', then 'OK' and 'OK'. In 3) by clicking the Run button again you should see the list of shortcuts allowing you to perform the actions necessary to compile VIVO. | 1) 2) 3) |
3.5)Validating Servers installationWith the file manager, access the directory containing eclipseEclipse. Observe in this directory if the four servers are present as shown in the figure. |
Conclusion
At the end of this procedure you should have a complete installation of the UQAM-DEV. You can refer to the other documents in this wiki to learn how to compile and run a VIVO instance.
Appendix
List of useful
...
links
Name | URL |
---|---|
UQAM-DEV Rev 4 updateSite | http://vivo-i18n.dev.uqam.ca:8080/uqam-dev/releaserev410/ |