Development Environment Installation

In this section, we will present how to setup a development environment for the MeasurePlatform.

Prerequired

The Measure Platform can be executed both on Linux or Windows systems. For that, the platform requires the installation of: MySQL, Elasticsearch, Kibana and Java 1.8.

MySQL Installation

• Download MySQL Community Server 5.7 or above : https://dev.mysql.com/downloads/mysql/
• Install MySQL using the folloing instruction : https://dev.mysql.com/doc/refman/5.7/en/installing.html
• Create a new database named "measureplatform".

Elasticsearch Installation

• Downloade Elasticsearch 5.4 or above (as zip): https://www.elastic.co/downloads/elasticsearch
• Unzip the application in your tool directory.

Kibana Installation

• Downloade Kibana v 5.4 or above (as zip): https://www.elastic.co/downloads/kibana
• Unzip the application in your tool directory.

Java 1.8 Installation

• Download and install the jdk8 in youe environment: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Eclipse IDE

• Download and install the last version of Eclipse IDE for Java EE Developers: https://www.eclipse.org/downloads/eclipse-packages/

Retrive the MeasurePlatform Source Code

The Measure Platform source code is hosted on GitHub. To retrive it, you can:

• Download it as zip file : https://github.com/ITEA3-Measure/MeasurePlatform
• Clone the Git repository
  • Install git: https://git-scm.com/downloads
  • Clone the repository: git clone https://github.com/ITEA3-Measure/MeasurePlatform.git

You can now import the Measure Platform as a new Maven project in Eclipse.

Configure the platform

Edit the application.properties file which is at root of the project :

General Properties

Property	Description	Default Value
spring.datasource.url	JDBC URL of the database ex: "jdbc:mysql://"+ ip of computer in which is installed MySQL +"/" + database name.	jdbc:mysql://localhost/measureplatform
spring.datasource.username	Loign MySQL.	root
spring.datasource.password	Password MySQL.	root
spring.datasource.driver-class-name	Driver JDBC for MySQL	com.mysql.jdbc.Driver
measure.repository.path	Past of an empty directory which will be used to store upladed measures.	c:/MeasurePlatform/storage
measure.kibana.adress	Ip Adress of the Kibana istallation.	localhost:5601
server.port	Port of the MeasurePlatform web application	80

Mail Server configuration

In order to register new users, you have to configure a mail server.

Property	Description	Default Value
spring.mail.host	Url of the mail service	smtp.gmail.com
spring.mail.port	Port of the mail service	587
spring.mail.username	Login of the mail account
spring.mail.password	Password of the mail account
spring.mail.protocol	mail protocole	smtp
spring.mail.tls	-	true
spring.mail.properties.mail.smtp.auth	-	true
spring.mail.properties.mail.smtp.starttls.enable	-	true
spring.mail.properties.mail.smtp.ssl.trust=	-	smtp.gmail.com

Start the Application

1. Start MySQL
2. Start Elasticsearch : ./elasticsearch-5.4.0/bin/elasticsearch
3. Start Kibana:./kibana-5.4.0/bin/kibana
4. Start the Measure platform:

• From Eclipse As Release: Select the "MeasurePlatformApp.java" file and Right Click > Run as > Java Application

• From Eclipse As Debug: Select the "MeasurePlatformApp.java" file and Right Click > Debug as > Java Application

To access to the platform: http://localhost:80/#/