Docker WissKI

Prerequisites

Get the data

Clone the repository. In case of problems with large files just download the zip.

Linux

Install Docker. You may want to apply some post-installation steps.

Windows

Install Docker Desktop. You may need to install the WSL 2 Linux kernel.

Beware if you are using Virtualization software like VirtualBox, they may conflict with your Docker-Software in Windows.

You need a GraphDB standalone server zip file. Apply on the GraphDB free downloadpage, they will send you an email with a link to the stand alone server; safe the file as graphdb.zip in the graphdb_context folder (latest testet version: 10.8.0).

Setup

Script-driven (only Linux)

Run ./setup.bash to set your database credentials and port definitions. Definition of the Triplestore and Pathbuilder names are not implemented yet. The names are set to 'default'.

Windows and without script

Open .example-env file, provide the credentials and ports according to your needs and save it as .env.

# Database settings
DB_ADMINISTRATION_PORT=8081
DB_DRIVER=mysql
DB_HOST=mariadb
DB_NAME=DATABASE
DB_PASSWORD=USERPW
DB_PORT=3306
DB_ROOT_PASSWORD=ROOTPW
DB_USER=DBUSER

# Drupal settings
DRUPAL_PASSWORD=SUPERSECRET
DRUPAL_PORT=80
DRUPAL_USER=admin
DRUPAL_VERSION=11.0.5 # For a list of Drupal releases see: https://www.drupal.org/node/3060/release
SITE_NAME=My WissKI

# WissKI settings
DEFAULT_GRAPH=https://my.wiss-ki.eu/
DEFAULT_DATA_MODEL=1

# Graphdb settings
GRAPHDB_PORT=7200

# SOLR settings
SOLR_PORT=8983

If you change something in the .env or Dockerfiles, you have to rebuild the images with docker compose build!

Start

Run docker compose up -d to start containers in background.

Logs

You can check the logs of each container by typing docker logs <container-name>, i.e. docker logs dockerwisski_drupal_1.

Docker compose environment

Services

There are five services corresponding to four containers

drupal/ dockerwisski_drupal_1
graphdb/ dockerwisski_graphdb_1
mariadb/ dockerwisski_mariadb_1
phpmyadmin/ dockerwisski_phpmyadmin_1
solr/ dockerwisski_solr_1

To browse your services enter your domain and the port of the service (i.e. localhost:7200 if you installed it on your local machine and left the default graphdb port).

To connect to your services over the internal docker network, you have to provide the service name (drupal, mariadb, solr, graphdb) as host instead of localhost or 172.168.0.1. For example the correct setting in the settings.php for host is not 'host' => 'localhost', but 'host' => 'mariadb'.

Editing

If you want to jump into a container, open a console and type

docker exec -it <container-id> bash

for example

docker exec -it dockerwisski_drupal_1 bash

gets you into the drupal container.

Volumes

All containers have three bind volumes:

drupal-data stores your drupal root directory
mariadb-data corresponds to /var/lib/mysql
solr-data to SORL root dir

and one docker managed volume:

graphdb-data to Graphdb /graphdb

You find these bind volumes in your git directory and the docker managed under /var/lib/docker/volumes/<composer-prefix>_<volume name>/_data (Linux - you have to be root to access) or at the location shown in your Docker Desktop settings (Premium Feature). Please check the right permissions, if you copy or alter files and folders.