Skip to content

Latest commit

 

History

History
50 lines (31 loc) · 2.3 KB

getting-started.md

File metadata and controls

50 lines (31 loc) · 2.3 KB

Getting started

The framework provides a set of scripts for building the projects, generating the instance models and running the benchmark.

Installation guide

The benchmark requires a 64-bit operating system and JDK 8. For development, we recommend Ubuntu-based Linux systems.

The projects are built using Gradle, but this is is handled by the Gradle wrapper scripts, so there it's not required to install Gradle on your machine.

Setup

Provided that you start with a fresh Ubuntu server installation, you can run the provided install scripts like this:

scripts/install-jdk.sh && \
./gradlew initScripts

Optional dependencies

Some tools requires dependencies that cannot be handled by the build system. For example, some require the installation of a database manager or adding artifacts to your local Maven repository.

  • MySQL: install with

    sudo apt-get install -y mysql-server

    and set the root password to empty. This might be tricky on latest Ubuntu systems, see the MySQL README for details.

  • SQLite: install with

    sudo apt-get install -y sqlite3

Usage

See the How to run the benchmark document.

Importing to Eclipse

The projects are developed and tested with Eclipse Neon.

To develop the Train Benchmark, you need a Gradle Eclipse plugin from the Eclipse Marketplace, e.g. the Buildship: Eclipse Plug-ins for Gradle. We also recommend installing the Eclipse Groovy tooling from https://github.com/groovy/groovy-eclipse/wiki.

To import the projects, choose Import... | Gradle Project, specify the root directory as the repository directory and import them with the default Gradle distribution (Gradle wrapper (recommended)). If Eclipse prompts you if you would like to overwrite existing Eclipse project descriptors, choose Keep.