Comparaison des versions

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

...

What is UQAM-DEV?

UQAM-DEV is an execution and developpement environnement development environment for VIVO.

...

 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.

Image Removed

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:

...

https://www.

...

topquadrant.com/

...

topbraid-composer-install/

Download and install the right version for your operating system

Image Added

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 

...


StepDescription

2.1 Unzip and launch

Eclipse

TopBraid Composer

In your favorite directory (ex.: in my case C:\60-UQAM-DEV-Rev4), unzip the Eclipse tbcfe package and click on the executable to launch the application.

Avertissement

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



Image Added

Image Removed

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.

Image RemovedImage Added

Eclipse Topbraid will then display a general information window. Dismiss it to get to Eclipse main interface:

Image Removed

Image Added

2.2

Eclipse Installing new

Installing UQAM-DEV with TopBraid Installing New Software

Under Help Menu, Select Install New Software


2.3 Adding 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.

Image Removed

enter 

2.4 Assign UQAM-DEV Software

In 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.

Image Removed

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.

Image Removed

2.6 Select the desired features

After a few seconds, Eclipse will display the features that are most convenient for you.

Select them, and click on Next.

Image Removed

in the Work With Field and 'Select All' check box

Then click on the 'Next' button.

Image Added

2.4

2.7

Complete the installation

Answer 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.

8

5 Complete the configuration

For this configuration step, Eclipse will restart twice. You will therefore see those two splash screens appear before you can access your workspace.

Image RemovedImage Added

3 Testing the installation

Here are a few observations checks that will help ensure that UQAM-DEV is correctly configured.

ObservationCheckDescription

3.1

)

Perspectives and projects

After the UQAM-DEV has been installed:

  1. Click the Open Perspective icon
  2. Select Java

The list of projects should appear as shown in the second image.


Image RemovedImage RemovedImage AddedImage Added

3.2

)

Project Contents

Each 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 Tools

This step completes and validates the installation of the external tools that are ready to be configured in UQAM-DEV.

  1. scroll Scroll down the menu corresponding to the external tools button, and choose organize favorites Organize Favorites...
  2. in In the dialog box that will appear, click on Add..., then Select All, then OK and OK.
  3. by By clicking the external tools button again you should see the list of shortcuts allowing you to perform the actions necessary to manage VIVO.

3.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 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 installation

With the file manager, access the directory containing eclipseEclipse. Observe in this directory if the four servers are present as shown in the figure.

Image RemovedImage Added

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

...

NameURL
UQAM-DEV Rev 4 updateSitehttp://vivo-i18n.dev.uqam.ca:8080/uqam-dev/releaserev410/