Setting up your Quadriga development environment (Java)

Required Software

Before you clone the Quadriga GitHub Repository, you need the following software installed:

• Eclipse Luna with WTP (Java EE version should do it; a later version of Eclipse might work as well) 
• Apache Tomcat 7

• Java 1.8 JDK or greater (it is important that you install the Java Development Kit (JDK) not the Java Runtime Environment (JRE))

• MySQL Community Edition
• Neo4j Community Edition

GitHub Repos

Once the above software is installed, clone the following two repositories in your workspace:

• Quadriga (https://github.com/diging/quadriga): 
  https://github.com/diging/quadriga.git
• QStore4s (https://github.com/diging/qstore4s): 
  https://github.com/diging/qstore4s.git

Configuration

QStore4S

Quadriga uses QStore4S (or just QStore) as backend. QStore itself uses Neo4j to store graphs. You need to configure the following properties:

Neo4j username and password

After you've installed Neo4j, start the Neo4j server and go to http://localhost:7474/. The first time you do that, Neo4j will ask you to set your password. Remember what password you choose!

In your QStore4S project in Eclipse, locate the pom.xml file. In that file around line 15, you have to specify your username and password for Neo4j. The username will be neo4j, but you have to replace the password you chose in the following line:

<neo4j.password>myneo4j</neo4j.password>

Replace 'myneo4j' with your Neo4j password.

Quadriga

Quadriga is the project you will be working on. You have to configure the following properties.

MySQL

In your MySQL server, create a database called 'quadriga'. If you call it something else than that, you have to adjust the database property in the pom.xml file of the Quadriga project (around line 22):

<database.url>jdbc:mysql://localhost:3306/quadriga</database.url>

Replace 'quadriga' with the database name you chose.

Create a user in your MySQL instance called 'dbadmin' with the password 'dbadmin' that has access to the database you've created. If you use a different usename and password, you can adjust that in the pom.xml file as well:

<database.username>dbadmin</database.username>
<database.pw>dbadmin</database.pw>

QStore4S

Next, you have to make sure that Quadriga finds QStore. In or around line 25 in the Quadriga pom.xml, make sure the property 'qstore.url' is set to:

<qstore.url>http://localhost:8080/qstore4s</qstore.url>