Install

Java

NOTE: It seems that BlazeGraph has problem with Java v10.0.0

• blazegraph/database#89
• https://sourceforge.net/p/bigdata/discussion/676946/thread/771a036f/

Downgrading Java version will help:

How can I see all versions of a package that are available in the archive? How To Install Java with apt on Ubuntu 18.04

java -version
sudo apt install openjdk-8-jre
sudo apt install openjdk-8-jdk
java -version
sudo update-alternatives --config java
# choose the version you want (1.8.0)
java -version

Preparing virtual environment

sudo -H virtualenv qmul-infrastructure-2-env
sudo chown -R `whoami` qmul-infrastructure-2-env
source qmul-infrastructure-2-env/bin/activate
sudo -H python -m pip install -r requirements.txt

Installing dependencies

pip3 install virtualenv
 /home/mprinc/.local/bin/virtualenv
# probably some better place later
cd /var/services
/home/mprinc/.local/bin/virtualenv qmul-infrastructure-2-env
source /var/services/qmul-infrastructure-2-env/bin/activate
cd /var/repos/semanticMediator/
pip3 install -r requirements.txt
# pip3 install rpyc

Blazegraph & SEPA

Ensure you have a running instance of Blazegraph and SEPA. They can be downloaded from GitHub. To run blazegraph, enter in folder Endpoints and run:

cd SEPA
java -jar blazegraph.jar

To run SEPA, enter in folder Engine, rename endpoint-blazegraph.jpar to endpoint.jpar and run:

cd SEPA
# java -jar SEPAEngine_0.8.4.jar
java -jar engine-v0.9.1.jar

Install sepy library

git clone https://github.com/arces-wot/SEPA-python3-APIs
cd SEPA-python3-APIs/
# cd /var/repos/SEPA-python3-APIs
source /var/services/qmul-infrastructure-2-env/bin/activate
cd /var/repos/semanticMediator/
python3 setup.py build
# this you might to run as sudo if you do not use virtual environment
python3 setup.py install

Installing sparqlGenerate

https://github.com/sparql-generate/sparql-generate/tree/master/sparql-generate-jena

git clone https://github.com/sparql-generate/sparql-generate
cd sparql-generate/sparql-generate-jena
# this craches on tests (and licences)
mvn package
# to disable tests and licencing issues
# https://stackoverflow.com/questions/7456006/maven-packaging-without-test-skip-tests
mvn package -Drat.numUnapprovedLicenses=100 -DskipTests

Installing sparqlGenerate-ws

git clone https://github.com/miguel76/sparql-generate-ws
cd sparql-generate-ws/
java -jar target/sparql-generate-ws.jar 6060
# cd /var/services/sparqlGenerate-ws
# java -jar sparql-generate-ws.jar 6060

Building Local repo

• using mvn deploy:deploy-file
  • mvn deploy:deploy-file
• manually

cd sparql-generate-ws/
# migth be not necessary
mkdir repo
# Either explicitly described jar lib
mvn deploy:deploy-file \
    -Durl=file://repo \
    -Dfile=sparql-generate-jena-1.2.3-SNAPSHOT.jar \
    -DgroupId=com.github.thesmartenergy \
    -DartifactId=sparql-generate-jena \
    -Dpackaging=jar -Dversion=1.2.3-SNAPSHOT


# or implicitly described (in `pom.xml`) jar lib
mvn deploy:deploy-file \
    -Durl=file://repo \
    -Dfile=sparql-generate-jena-1.2.3-SNAPSHOT.jar \
    -DpomFile=../sparql-generate/sparql-generate-jena/pom.xml

Then update pom.xml by adding local repo and adding dependency (it will be searched in local repo):

<repositories>
  <repository>
    <id>project.local</id>
    <name>project</name>
    <url>file:${project.basedir}/repo</url>
  </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.thesmartenergy</groupId>
        <artifactId>sparql-generate-jena</artifactId>
        <version>1.2.3-SNAPSHOT</version>
    </dependency>
    <!-- ... -->
</dependencies>
<!-- ... -->

Build:

mvn package

You should be able to run it now:

cd sparql-generate-ws
java -jar target/sparql-generate-ws.jar 6060

Installing Mediator

Install external git mappings

git submodule init
git submodule update

# If there is a problem try to remove `.gitmodules` and recreate
# https://git-scm.com/docs/git-submodule
# https://stackoverflow.com/questions/3336995/git-will-not-init-sync-update-new-submodules
git submodule add https://gitlab.com/desmovalvo/europeana-to-audiocommons src/services/mediator/lib/mappings/europeana-to-audiocommons

git submodule add https://github.com/miguel76/freesound-to-audiocommons src/services/mediator/lib/mappings/freesound-to-audiocommons

git submodule add https://gitlab.com/desmovalvo/jamendo-to-audiocommons src/services/mediator/lib/mappings/jamendo-to-audiocommons

Configuring the mediator

There is a default version of the YAML configuration file mediaconf.example.yaml that you should copy into mediaconf.yaml and set properly.

Edit the YAML configuration file to add your API keys for Freesound, Jamendo and Europeana. Note: these are not the end-user keys for the providers, but rather Audio Commons global-level keys with higher lelvel privileges, since they need to serve N users, so for example number of daily search accesses should be much higher than for a regular single-user keys.

If needed, change the URIs of the underlying services (SEPA, SPARQL-Generate) as needed.

Running the mediator

cd semanticMediator
# cd /var/repos/semanticMediator/
# source /var/services/qmul-infrastructure-2-env/bin/activate

python3 mediator.py -c <CONFIG_FILE.yaml>
# for example
# python3 mediator.py -c mediaconf.yaml

Run

# cd /Users/sasha/Documents/data/development/QMUL/infrastructure-2
cd <mediator-repos>

1st terminal. Run blazegraph:

cd SEPA
java -jar blazegraph.jar

2nd terminal. Run SEPA:

cd SEPA
# java -jar SEPAEngine_0.8.4.jar
java -jar engine-v0.9.1.jar

3rd terminal. Run SPARQL-generator web service:

cd sparql-generate-ws/
java -jar target/sparql-generate-ws.jar 6060
# or five in parallel
java -jar target/sparql-generate-ws.jar 6061
java -jar target/sparql-generate-ws.jar 6062
java -jar target/sparql-generate-ws.jar 6063
java -jar target/sparql-generate-ws.jar 6064
java -jar target/sparql-generate-ws.jar 6065

source qmul-infrastructure-2-env/bin/activate
cd semanticMediator/src/services/mediator
# cd /var/repos/semanticMediator/src/services/mediator
# source /var/services/qmul-infrastructure-2-env/bin/activate

# or (when inside the mediator)
source ../../../../qmul-infrastructure-2-env/bin/activat

python3 mediator.py -c <CONFIG_FILE.yaml>
# for example
python3 mediator.py -c mediaconf.yaml

Run on server

SPARQL-Gen services

# service-1
ssh -i ~/.ssh/sasha-iaas-no.pem [email protected]
# service-2
ssh -i ~/.ssh/sasha-iaas-no.pem [email protected]
# service-3
ssh -i ~/.ssh/sasha-iaas-no.pem [email protected]

sudo systemctl status m-sparqlGenerate-ws
sudo systemctl stop m-sparqlGenerate-ws
sudo systemctl restart m-sparqlGenerate-ws

cd /var/services/sparqlGenerate-ws/

/usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java -jar sparql-generate-ws.jar 6060

ColaboFlow Audit Service

sudo systemctl status s-colaboflow-audit
sudo systemctl stop s-colaboflow-audit
sudo systemctl restart s-colaboflow-audit

cd /var/repos/colabo/src/services/services/colaboflow-audit/dist/
/usr/bin/nodejs /var/repos/colabo/src/services/services/colaboflow-audit/dist/index.js

ColaboFlow Go Service

sudo systemctl status s-colaboflow-go
sudo systemctl restart s-colaboflow-go

cd /var/repos/colabo/src/services/services/colaboflow-go/dist/
/usr/bin/nodejs /var/repos/colabo/src/services/services/colaboflow-go/dist/index.js

blazegraph

sudo systemctl status m-blazegraph
sudo systemctl stop m-blazegraph

cd /var/services/sepa/
/usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java -server -Xmx4g -jar blazegraph.jar

SEPA

sudo systemctl status m-sepa
sudo systemctl stop m-sepa
cd /var/services/sepa/
/usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java -jar engine-v0.9.1.jar

SemanticMediator

# ssh to the server
ssh -i ~/.ssh/sasha-iaas-no.pem [email protected]

sudo systemctl status m-mediator
sudo systemctl stop m-mediator
sudo systemctl restart m-mediator

cd /var/repos/semanticMediator/src/services/mediator/
source /var/services/mediator3/bin/activate
python mediator.py -c mediaconf.yaml

Tests

from local machine

curl -v -H "Content-Type: application/json" -X GET http://localhost:9027/audioclips/search?pattern=dog

http://localhost:9027/audioclips/search?pattern=dog

The project contains a few unit tests in folder tests. To run them, enter in folder tests and type:

$ MEDIATORTEST=testconf.yaml python3 -m unittest tests.MediatorTests

Changing for the test

Sessions:

session-cache-missing-multiple-sparql-gen
session-cache-missing-multiple-1-sparql-gen

edit:

• infrastructure-2/semanticMediator/src/services/mediator/mediaconf.yaml
  • change sessionId
• audio-commons-provisioning/provisioning/files/services/flow/go/global-server.js
  • change the list of sparql-gen service instancs

Restart services:

sudo systemctl restart s-colaboflow-go
sudo systemctl restart m-mediator

Run tests:

cd /Users/sasha/Documents/data/development/QMUL/infrastructure-2/semanticMediator/src/services/mediator/tests/
sh ./cache-missing.sh