Setup

Start LinkedDataHub

This section assumes you will be running on your local machine, i.e. localhost. If you intend to run it on a different host, change the system base URI.

Prerequisites:

• bash shell. It should be included by default on Linux. On Windows you can install the Windows Subsystem for Linux.
• Java's keytool available on $PATH. It comes with the JDK.
• openssl available on $PATH.
• Docker installed
• Docker Compose installed

Steps:

1. Fork the LinkedDataHub repository and clone the fork into a folder
2. In the folder, create an .env file and fill out the missing values (you can use .env_sample as a template). For example:

   COMPOSE_CONVERT_WINDOWS_PATHS=1
   COMPOSE_PROJECT_NAME=linkeddatahub
   
   PROTOCOL=https
   HTTP_PORT=81
   HTTPS_PORT=4443
   HOST=localhost
   ABS_PATH=/
   
   OWNER_MBOX=john@doe.com
   OWNER_GIVEN_NAME=John
   OWNER_FAMILY_NAME=Doe
   OWNER_ORG_UNIT=My unit
   OWNER_ORGANIZATION=My org
   OWNER_LOCALITY=Copenhagen
   OWNER_STATE_OR_PROVINCE=Denmark
   OWNER_COUNTRY_NAME=DK

3. Setup SSL certificates/keys by running this from command line (replace $owner_cert_pwd and $secretary_cert_pwd with your own passwords):

   ./scripts/setup.sh .env ssl $owner_cert_pwd $secretary_cert_pwd 3650

   The script will create an `ssl` sub-folder where the SSL certificates and/or public keys will be placed.
4. Run this from command line:

   docker-compose up --build

   LinkedDataHub will start and create the following sub-folders:
   1. data where the triplestore(s) will persist RDF data
   2. uploads where LinkedDataHub stores content-hashed file uploads

You are now the owner of this LinkedDataHub instance; certs/owner.p12 is your WebID certificate. Password is the OWNER_KEY_PASSWORD value.

After a successful startup, the last line of the Docker log should read:

linkeddatahub_1    | 02-Feb-2020 02:02:20.200 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in 3420 ms

Reset

If you need to start fresh and wipe the existing setup (e.g. after configuring a new base URI), you can do that using:

sudo rm -rf data uploads && docker-compose down -v