mg-benchmarking-tool

Java Data Mining Package - Benchmarking Tool

Requirements

This project is based on the default Maven JMH archetype described here.

Java version

In order to run the benchmarks make sure you have Java 8 as default. Run the following command to know:

java -version

If you don't have Java 8 installed search how to install in your system and then use the following command to set your default version:

sudo update-alternatives --config java

Maven

Make sure you also have a Maven version installed compatible with your Java installation. Check proper output of:

mvn --version

Linux perf profiler

Install

The profiler used to measure alongside JMH is perf. For its proper execution you'll need to check your running kernel version with:

uname -r

Once you know you can just use apt to install your kernel's specific version (e.g. for 5.3.0-42-generic):

sudo apt install linux-tools-5.3.0-42-generic

Enable

You'll need to modify some system flags:

• Change from 3 to -1 the /proc/sys/kernel/perf_event_paranoid file
• Change from 1 to 0 the /proc/sys/kernel/nmi_watchdog file

Usage

Run the benchmarks

As every JMH project you will need to run the following steps given that you are in the project directory:

mvn clean install

This will create a target/ directory containing the executable file benchmarks.jar. To execute just type:

java -jar target/benchmarks.jar -prof perf

For the assembler alternative use:

java -jar target/benchmarks.jar -prof perfasm