magnusenger/armillaria

RDF cataloging interface

Armillaira

RDF cataloging interface.

Architecture

A coarse overview of the system architecture

Setup

Eventually, a debian package will be provided, but for now, you must manually set up your environment.

The instructions will probably work with any Debian/Ubuntu-flavoured distro. My development setup is Ubuntu 64-bit version 14.04.

Runtime dependencies

Openlink Virtuoso quad-store

Armillaria is developed and tested against Virtuoso 7, which must be compiled from source:

TODO build instructions

Elasticsearch

I recommend installing a package from the official repostitories:

wget -O - http://packages.elasticsearch.org/GPG-KEY-elasticsearch | sudo apt-key add -
echo "deb http://packages.elasticsearch.org/elasticsearch/1.1/debian stable main" | sudo tee -a /etc/apt/sources.list
sudo apt-get update && sudo apt-get install elasticsearch
sudo service elasticsearch start

Development dependencies

Go

The (very limited) server backend is coded in Go.

There are pacakges for Ubuntu:

sudo apt-get install golang

If you want the latest and greatest I recommend the official binary distributions:

wget https://storage.googleapis.com/golang/go1.2.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.2.2.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

Either way, you must make sure to set your GOPATH environment variable. This tells Go where to install dependencies locally. After installing Go, type go env to check if GOPATH is set, otherwise do it yourself:

export GOPATH=/home/<your username>/go  # for example

Of course, you should add the above export-statements to your .bashrc, .profile or similar, to avoid having to enter it every time you open a new shell.

If you want to know more about using the Go tools, please consult its exellent documentation.

Configuration

Armellaria has a configuration file where you must fill out a few things:

mv data/config_example.json data/config.json
editor data/config.json

Fetch dependencies and setup indexes (expects Elasticsearch to be running on localhost:9200):

make deps
make indexes && make mappings

To start the server type:

make run