About

Work in progress: transformation and web access for hbz’s digitalisiertedrucke.de data.

Build

Prerequisites: Java 8, Maven 3; verify with mvn -version

Create and change into a folder where you want to store the projects:

• mkdir ~/git ; cd ~/git

Build the hbz metafacture-core fork:

• git clone https://github.com/hbz/metafacture-core.git
• cd metafacture-core
• mvn clean install -DskipTests
• cd ..

Get digitalisiertedrucke, set up the Play application, and run the tests:

• git clone https://github.com/hbz/digitalisiertedrucke.git
• cd ~ ; wget http://downloads.typesafe.com/typesafe-activator/1.3.10/typesafe-activator-1.3.10-minimal.zip
• unzip typesafe-activator-1.3.10-minimal.zip
• cd git/digitalisiertedrucke ; ~/activator-1.3.10-minimal/bin/activator test

See the .travis.yml file for details on the CI config used by Travis.

Data import

To transform the bzipped Marc-XML source data to JSON and index into an embedded Elasticsearch index, run:

~/activator-1.3.10-minimal/bin/activator "runMain ImportData"

Metadata transformations are implemented with Metafacture.

Web app

Development mode

To start the web app in development mode, run:

~/activator-1.3.10-minimal/bin/activator run

And visit http://localhost:9000

Production mode

Customize conf/application.conf, set:

• play.crypto.secret to a custom value
• index.location to the absolute path of the deployed repo, e.g. "/home/sol/git/digitalisiertedrucke"
• index.host to the host name of the deployment machine, e.g. "quaoar1.hbz-nrw.de"

Then start the app in production mode, with the port to run on:

~/activator-1.3.10-minimal/bin/activator "start 6000"

Eclipse setup

To generate an Eclipse project (import in Eclipse as existing project), run:

~/activator-1.3.10-minimal/bin/activator compile "eclipse with-source=true"