Deployment¶

User¶

Dependencies¶

AskOmics need the Virtuoso triplestore to work.

or install via docker

docker pull askomics/virtuoso

docker run --name my-virtuoso \                                                                                                                              
    -p 8890:8890 -p 1111:1111 \
    -e SPARQL_UPDATE=true \ 
    -v /tmp/virtuoso_data:/data \         
    -d askomics/virtuoso

replace /tmp/virtuoso with a directory of your choice.

Your virtuoso is available at localhost:8890.

Manual installation¶

Dependencies¶

Installation needs some dependencies,

Ubuntu 18.04

sudo apt update
sudo apt install -y git python3 python3-venv python3-dev zlib1g-dev libsasl2-dev libldap2-dev npm

Fedora 28/29

sudo dnf install -y git gcc gcc-c++ redhat-rpm-config zlib-devel bzip2 python3-devel openldap-devel npm

Installation¶

Clone the AskOmics repository, and checkout the latest version

git clone https://github.com/askomics/askomics.git
cd askomics
# chekout the latest version
git checkout $(git describe --abbrev=0 --tags)

If you have installed virtuoso via docker, you have to inform AskOmics that the load url is not localhost:6543, but another ip address (dockers can’t access host by http://localhost)

Run

docker exec my-virtuoso netstat -nr | grep '^0\.0\.0\.0' | awk '{print $2}'

and add

askomics.load_url=http://xxx.xx.x.x:6543

into configs/production.virtuoso.ini and configs/development.virtuoso.ini (replace xxx.xx.x.x with the ip obtained)

Install and run

./startAskomics.sh -d prod -t virtuoso

AskOmics is available at localhost:6543

Upgrade¶

Checkout the latest version is the AskOmics git directory.

git checkout $(git describe --abbrev=0 --tags)

Installation with docker¶

Pull the latest stable version of AskOmics

docker pull askomics/askomics

Run

docker run -p 6543:6543 askomics/askomics

AskOmics is available at localhost:6543

Upgrade with

docker pull askomics/askomics

Installation with docker-compose¶

Clone the askomics-docker-compose repository

git clone https://github.com/askomics/askomics-docker-compose

Choose which services you need and run with the docker-compose command. for example, if you need askomics+virtuoso :

cd askomics-docker-compose/virtuoso
docker-compose up -d

AskOmics is available at localhost/askomics

Upgrade with

# Stop dockers
docker-compose down
# upgrade the repo
git pull
# upgrade dockers
docker-compose pull
# start AskOmics
docker-compose up -d

Developer¶

Fork the AskOmics repository

then, clone your fork

git clone https://github.com/USERNAME/askomics.git # replace USERNAME with your github username

Install AskOmics

Run it with dev mod

./startAskomics.sh -d dev -t virtuoso

AskOmics is available at localhost:6543