Development Environment Installation

Prerequired

Node.js is cross-platform meaning that Mint can work on Windows, OSX and Linux. For that, the tool requires the installation of: Node.js, MySQL and Yarn. Mint requires Node.js 8.9.0 or above, the installation of a MySQL database, Redis and Yarn.

NodeJs Installation

• Download Node.js 8.9.0 or above (includes npm) : https://nodejs.org/en/download/
• Install Node.js

MySQL Installation

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

Yarn Installation

• Download Yarn 1.7.0 or above : https://yarnpkg.com/lang/en/docs/install/
• Install following the instructions according to the OS chosen.

Redis Installation

• Download the last Redis stable version (4.0) : https://redis.io/download
• Install following the instructions according to the OS chosen.

Retrieve Mint Source Code

Mint source code is hosted on GitHub. To retrive it, you can:

• Download it as zip file : https://github.com/ersilva/Mint/archive/master.zip
• Clone the Git repository
  • Install git: https://git-scm.com/downloads
  • Clone the repository: git clone https://github.com/ersilva/Mint.git

Configure the tool

Edit the config.js file which is in the config folder of the project.

Property	Description	Default Value
db.host	MySQL database host	localhost
db.port	MySQL database port	3306
db.port	MySQL database name	mint_db
db.port	MySQL database login	root
db.port	MySQL database password	root
measure.host	MEASURE Platform host	localhost
measure.host	MEASURE Platform port	8085

Start the Application

1. Start MySQL
2. install the packages required using yarn:
   $ yarn install
3. Populate database. Just for the first time is indispensable to populate the database with the machines description, for this run the command:
   yarn run seeds:up
4. Set enviroment variable (development, production or test):
   In Windows :
   SET NODE_ENV=production
   In Linux :
   export NODE_ENV=production
5. Start the tool:
   yarn run start
6. Registration.
   Once the tool is running it can be registered into the Measure platform.