How to setup GERBIL

This page describes the needed steps to setup a local GERBIL system. Note that you don't have to do this if you want to test an annotator or a dataset since this can be done using our online system.

Downloading and running the system

Prerequesites

• Java 1.7 or newer
• maven 2

Download the program

The easiest way to get GERBIL is to download it from GitHub.

git clone -b master https://github.com/AKSW/gerbil.git

Download the data

If you are using linux, you can simply run start.sh which will download the data, extract it and starts the system listening on http://localhost:1234/gerbil .

If you are using another operation system or want to download the data to a specific folder you can get the data from https://github.com/AKSW/gerbil/releases/download/v1.2.5/gerbil_data.zip Please extract the data and configure the system.

Configure GERBIL

If you have used the start.sh script, the system should already be configured. Otherwise you should open src/main/properties/gerbil.properties and set org.aksw.gerbil.DataPath to the folder containing the data of the extracted gerbil.zip file.

Start GERBIL

GERBIL can simply be started by running the start.sh script or running mvn clean tomcat:run

Note that while starting GERBIL can show the following warning: [main] WARN [org.aksw.gerbil.datasets.datahub.DatahubNIFLoader] - <Couldn't get any datasets with the gerbil tag from DataHubIO. Exception: org.springframework.web.client.HttpClientErrorException: 404 Not Found>

This warning shouldn't cause any problems and can be ignored.

Restrictions

Due to licensing restrictions, we are not allowed to upload the following datasets:

• AIDA/CoNLL
• Microposts 2013
• Microposts 2014

Regarding the annotators, it is possible that a key or registration is needed to use them without limitations. Please take a look at this wiki page: https://github.com/AKSW/gerbil/wiki/How-to-get-API-keys