Home

MDQ-SERVER

Overview

This project implements the Metadata Query Protocol based on the technology found in the Shibboleth Metadata Aggregator. See project README.

Build / Install

The project itself results in a self contained jetty based server that listens on port 9000.

Build

• obtain source and build the project
• after the below commands are executed you will have
  • target/mdq-server-0.0.1-SNAPSHOT.jar

git pull https://github.com/iay/mdq-server.git
cd mdq-server
mvn -Prelease clean install 

Install

• create an APPHOME environment for your JAR - we will refere to ${MDQ_HOME}

export MDQ_BUILD=~/mdq-server/
export MDQ_HOME=/opt/mdq-server
mkdir -p /opt/mdq-server/bin /opt/mdq-server/conf /opt/mdq-server/data /opt/mdq-server/logs
cp $MDQ_BUILD/target/mdq-server-0.0.1-SNAPSHOT.jar $MDQ_HOME/bin/mdq-server.jar

Run

This project uses spring boot to get things rolling at startup. We can therefore use a few configuration files with command line overrides to tell the application where to find its configuration information.

Example startup commands:

java -Dapp.home=${MDQ_HOME} -jar ${MDQ_HOME}/bin/mdq-server.jar \
        --spring.config.location=file://${MDQ_HOME}/conf/mdq-server.properties

OR using sudo

sudo java -Dapp.home=${MDQ_HOME} -jar ${MDQ_HOME}/bin/mdq-server.jar \
        --spring.config.location=file://${MDQ_HOME}/conf/mdq-server.properties

Template files

The stock template files can be located in the source tree at ${MDQ_BUILD}/src/main/resources To customise the configuration you will want to recreate these files in your ${MDQ_HOME}/conf directory.

• config.xml
• logback.xml
• mdq-server.properties