Status
in draft
1. Requirements
1.1 Eclipse IDE Neon 3 for J2EE Developers
The neon-3 version is required for compatibility with the Topbraid Composer 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.
https://www.eclipse.org/downloads/packages/release/neon/3
1.2 Java
En essential prerequisite for the operation of UQAM-DEV is the installation of Java. The command below presents its installation in the Linux environment.
1.2 Linux xrdp (optional for Windows Remote Desktop)
This optional prerequisite may be useful for developers who wish to connect to a Linux Desktop via the Windows Remote Desktop.
sudo apt install openjdk-8-jdk java -version
1.3 Configuration Linux pour la Connexion à Distance de Windows (Remote Desktop)
sudo apt -y install xrdp tigervnc-standalone-server sudo systemctl enable xrdp
1.4 Other tools
All the other tools necessary for VIVO development such as Maven, GIT, code editor, etc. are directly integrated into the eclipse environment. It is therefore not necessary to make any configuration specific to your platform.
1.5 Knowing the basic information about eclipse IDE
2 Installing UQAM-DEV
| Step | Description |
|---|---|
2.1 Uncompress Eclipse and Start-itIn your favorite directory unzip the eclipse package and click on the executable to start the application. |
Eclipse appearance after choosing the workspace and closing the welcome window.  |
2.2 Eclipse Installing new SoftwareUnder Help Menue, Select Install New Software |
|
2.3 Adding UQAM-DEV 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. |
|
2.4 Assign the URL of UQAM-DEVAfter having assigned the name and location of the archive, click OK and then OK again in the preference window. |
UQAM-DEV URL = http://vivo-i18n.dev.uqam.ca:8080/uqam-dev/release/ |
2.5 Select UQAM-DEV in Available Software Windows |
|
2.6 Select the desired featuresAfter a few seconds of waiting, you will be able to choose the features that are most convenient for you. After the section, click on the Next button. |
|
2.7 Complete the installationAnswer positively to all the questions you are asked and then, finalize the installation by clicking on the Finish button. The following dialogue should appear and you just have to wait 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, eclipse will offer you to reboot. Accept the proposal by clicking on the Yes button. |
|
2.8 Complete the configurationFor this configuration step, eclipse will restart twice. You will therefore see this splash appear two times before you can access your workspace. |
|
3 Testing installation
Here are a few observations that will help ensure that UQAM-DEV is correctly configured
| Observation | Description |
|---|---|
1) Perspectives and ProjectsAfter the UQAM-DEV has been installed, the list of perspectives should appear as shown in the red circle at the top right. If the Java perspective is selected, then the list of projects will appear as shown in the red circle on the left side of the figure. |
|
2) Project ContentsFor each project starting with a number, a list of files needed to use VIVO is presented. Make sure that the files that are part of your installation look like the figure shown here |
|
3) Setup External ToolsThis step completes and validates the installation of the external tools that are ready to be configured in UQAM-DEV. In 1) scroll down the menu corresponding to the external tools button, and choose organize favorites... In 2) in the dialog box that will appear, click on ADD, then Select All, then OK and OK. In 3) by clicking the external tools button again you should see the list of shortcuts allowing you to perform the actions necessary to manage VIVO. | 1)
2)
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... In 2) in the dialog box that will appear, click on 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)
|
5) Validating Servers installationWith the file manager, access the directory containing eclipse. 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.