Manual Setup

Manual setup

Manually setting up the framework requires Apache Maven. So start of by getting Maven over here if you haven't already done so. Next, clone the git repository to a destination of your choice.

mkdir ~/dwerft_lpdc
git clone https://github.com/yovisto/dwerft.git ~/dwerft_lpdc

RML

Due to a new RML version it is at the moment safe to use this one.

1. $ git clone --recursive https://github.com/RMLio/RML-Mapper.git
2. $ cd RML-Mapper && mvn clean install -DskipTests

old way

Since there is a bug within rml you have to checkout the rml repository and fix one line.

1. $ git clone https://github.com/RMLio/RML-Mapper.git

2. Change .gitmodules from:
[submodule "RML-LogicalSourceHandler"]
  path = RML-LogicalSourceHandler
  url = https://github.com/RMLio/RML-LogicalSourceHandler.git
to:
[submodule "RML-LogicalSourceHandler"]
  path = RML-LogicalSourceHandler
  url = https://github.com/santifa/RML-LogicalSourceHandler.git

3. $ git submodule update --init --recursive 

To use the current version of the submodule, enter the directory and run git checkout master Lastly provide rml with mvn clean install.

The same change can be done with the RML DataRetrieval:

Change the url to
https://github.com/santifa/RML-DataRetrieval.git

If some encoding problem happens try -Dfile.encoding=UTF-8 as argument to the jvm.

TailR

git clone https://github.com/SemanticMultimedia/tlr-java-api.git
cd tlr-java-api
mvn clean install -DskipTests

If you plan on using an operation which utilizes the Preproducer API, make sure to provide valid credentials. Simply copy the template we provide to the tools directory, and with an editor of your choice add your credentials. Adjust other settings to your needs.

cd ~/dwerft_lpdc/tools
cp src/main/resources/DwerftConfig.properties .
vim DwerftConfig.properties

Irrespective of whether you added credentials or not, you can now execute the lpdc project by running the run script provided. The various arguments available are listed in the next section.

./run.sh <your_arguments>

The Arguments have their own wiki page.