Installing dependencies
Make sure you have make, maven, java 8+, docker, postgresql-client and docker-compose installed and all permissions to use them.
Docker and docker-compose are only needed, if you use a local database. More on this in the starting section.
On Ubuntu 18.04:
sudo apt update && sudo apt install make maven docker docker-compose postgresql-client-common postgresql-client-10
sudo groupadd docker
sudo usermod -aG docker $USER
Reboot to start the docker daemon and set user permissions.
Starting owlkeeper
To start our demo on the remote server use make start-demo-remote
(Be aware the remote server is a tad slow.)
If you want to start the demo on a local server, just make start-demo-locally
.
Owlkeeper will compile, start a local database server, deploy the demo data and then start itself.
To start it locally without changing the db make start-locally
Database bootstrap
We are using docker based database for development and testing. In order to use it, make sure your system has the latest version of Docker installed.
Creating the database
You can start the database by running make db-start
and stop it by make db-stop
Bootstrapping tables, functions and triggers
Just run make bootstrap
Running tests
In order to run test against the default database with dummy data, run make test
Compiling
Run make compile