FAIR Data Austria Services

Install

Pull the latest dev/master images on your client through:

docker login https://docker.martinweise.at
> Username: fda
> Password: fda-docker

The dev branch images have suffix :latest (=optional), to pull them execute the following

docker pull docker.martinweise.at/fda-analyse-service:latest
docker pull docker.martinweise.at/fda-discovery-server:latest
docker pull docker.martinweise.at/fda-gateway-service:latest
docker pull docker.martinweise.at/fda-database-managing-service:latest
docker pull docker.martinweise.at/fda-container-managing-service:latest
docker pull docker.martinweise.at/fda-query-service:latest
docker pull docker.martinweise.at/fda-table-service:latest
docker pull docker.martinweise.at/fda-ui:latest

The master branch images have suffix :stable, they are pulled similar:

docker pull docker.martinweise.at/fda-analyse-service:stable
...

Note: the domain martinweise.at is private and I do not own any of these images, it is just a necessary condition for Docker to pull from a (private, non-public) remote repository! The domain should of course be changed before release!

Build

Everything is handled by compose, just build it by running:

docker-compose build

Local development minimum requirements:

• Ubuntu 18.04 LTS
• Apache Maven 3.0.0
• OpenJDK 11.0.0

Local deployment minimum versions:

• Docker Engine 20.10.0
• Docker Compose 1.28.0

Deployment

The pipeline is set-up to build and test all commits. A commit to dev or master branch triggers additional jobs.

Development

A commit to dev triggers the following pipeline. It deploys the docker images to the docker registry hosted on the fda-runner server and deploys it also to a test server (fda-deployment) at TU Wien.

Production

A commit to master triggers the following pipeline. It deploys the docker images to the docker registry hosted on the fda-runner server and deploys it also to a production server tbd.

Start

Now start all services by running:

docker-compose up

Troubleshooting

FDA Runner

Hosted at TU Wien 128.130.202.89, only accessible from TU-Network

Important

Different MTU for HPC Cluster, edit for Docker to work with bridge mode the /etc/docker/daemon.json:

{
    "mtu": 1450
}

Virtual Machine

Ubuntu 20.04 LTS

Use openjdk-11...openjdk-8 does not work.

Do not use maven provided my Ubuntu 20.4 LTS. It cannot handle those injections spring-boot wants it to do.

It says: WARNING: An illegal reflective access operation has occurred WARNING: Illegal reflective access by com.google.inject.internal.cglib.core.$ReflectUtils$1 (file:/usr/share/maven/lib/guice.jar) to method java.lang.ClassLoader.defineClass(java.lang.String,byte[],int,int,java.security.ProtectionDomain)

Install maven from Apache Org.:

Download maven e.g. 3.6.3

wget https://www-us.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz -P /tmp

Untar downloaded file to /opt

sudo tar xf /tmp/apache-maven-*.tar.gz -C /opt

Install the alternative version for the mvn in your system

sudo update-alternatives --install /usr/bin/mvn mvn /opt/apache-maven-3.6.3/bin/mvn 363

Check if your configuration is ok. You may use your current or the 3.6.3 whenever you wish, running the command below.

sudo update-alternatives --config mvn