Comparaison des versions

Ancienne version 7

changes.mady.by.user Dickner, Nicolas

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Dickner, Nicolas

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Info
titleStatus

in draft

Sommaire

0. What is UQAM DEV?

UQAM DEV is an execution and developpement environnement for VIVO.

1. Requirements

All the 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 install those tools on your platforms, unless you want to use them outside of Eclipse.

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.

Image Modified

For further information, you can read the Eclipse platform overview.

1.2 Java JDK

En An essential prerequisite for the operation of UQAM-DEV is the installation of Java . The command below presents its installation in the Linux environment.

...

JDK, version 8.

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 prerequisite requirement may be useful for developers who wish to connect to a Linux Desktop via the Windows Remote Desktop.

Bloc de code
sudo apt install openjdk-8-jdk
java -version

...

.

...

Bloc de code
sudo apt -y install xrdp tigervnc-standalone-server
sudo systemctl enable xrdp

1.4 Other tools

...

1.5 Knowing the basic information about eclipse IDE

2 Installing UQAM-DEV

StepDescription
2.1 
 Uncompress Eclipse and Start-it
Unzip and launch Eclipse
In your favorite directory, unzip the 
 eclipse 
Eclipse package and click on the executable to 
 start 
launch the application.Image Removed

 Avertissement
Before launching Eclipse, make sure you modified the .ini file as described in section 1.3

Image Added
By default, Eclipse will ask you to select a workplace. The actual location of that workplace has little importance. You can locate it wherever you want, choose to use it as default if desired, and proceed.
Image Added
Eclipse will then display a general information window. Dismiss it to get to Eclipse main interface:Eclipse appearance after choosing the workspace and closing the welcome window.

2.2 Eclipse Installing new Software
Under Help MenueMenu, Select Install New Software

2.3 Adding 
 UQAM-DEV 
 Software Site
From 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-DEV 
After having assigned the name and location of the archive, click OK and then OK again in the preference window.
Software
In the Add Site form, provide the following name and URL:
UQAM-DEV
Image Removed
UQAM-DEV URL = 
http://vivo-i18n.dev.uqam.ca:8080/uqam-dev/release/
Then click OK and then OK again in the preference window.
Image Added

2.5 Select UQAM-DEV in Available Software Windows
If 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 features
After a few seconds of waiting, you will be able to choose Eclipse will display the features that are most convenient for you.
After the sectionSelect them, and click on the Next button.
2.7 Complete the installation
Answer 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 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, eclipse you will offer you to reboot. Accept the proposal by clicking on the Yes buttonbe offered to restart Eclipse. Click Yes.

2.8 Complete the configuration
For this configuration step, eclipse Eclipse will restart twice. You will therefore see this those two splash screens appear two times before you can access your workspace.
Image Modified
Image Added
3 Testing installation
Here are a few observations that will help ensure that UQAM-DEV is correctly configured
ObservationDescription
1) Perspectives and 
 Projects
projects
After 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 :
  1. Click the Open Perspective icon
  2. Select Java
The list of projects should appear as shown in the red circle on the left side of the figuresecond image.

Image RemovedImage AddedImage Added
2) Project Contents
For each Each project starting with a number , contains a list of files needed to use run VIVO is presented. Make sure that the files that are part of your installation look like the figure shown here
3) Setup External Tools
This step completes and validates the installation of the external tools that are ready to be configured in UQAM-DEV.In 1) 
  1. scroll down the menu corresponding to the external tools button, and choose organize favorites...
In 2) 
  1. in the dialog box that will appear, click on 
 ADD
  1.  Add..., then Select All, then OK and OK.
In 3) 
  1. 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)Image Added
Image Removed
2)
Image Removed
3)
Image Added
Image Added
Image Modified
4) Setup Run Configurations
This 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 installation
With the file manager, access the directory containing eclipse. Observe in this directory if the four servers are present as shown in the figure.
...
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
NameURL
UQAM-DEV updateSitehttp://vivo-i18n.dev.uqam.ca:8080/uqam-dev/release/