Skip to content

Latest commit

 

History

History
executable file
·
60 lines (43 loc) · 4.03 KB

prerequisites.md

File metadata and controls

executable file
·
60 lines (43 loc) · 4.03 KB

PrerequisitesExercise 1Exercise 1.1Exercise 2Exercise 4Exercise 5Exercise 6


Prerequisites

In order to be able to solve the exercises described in this tutorial a software development environment with GIT, Java 17, Maven 3.8, Docker, docker-compose, a Java IDE like Eclipse or IntelliJ, a BPMN Editor like the Camunda Modeler and a minimum 16GB of RAM is needed. Make sure you read through the introductory documentation pages located here. You also want to have some amount of experience in HL7 FHIR R4.

GIT

git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.

  • An installation guide for Linux, Mac and Windows can be found here: installation guide
  • The most basic git CLI commands are described here: commands

Java 17

Process plugins for the DSF are written using the Java programming language in version 17. Various open source releases of the Java Developer Kit (JDK) 17 exist, you are free in your choice.

Maven 3.8

When implementing DSF processes, we use Maven 3.8 to manage the software project's build, reporting and documentation workflow.

  • An installation guide for Maven 3.8 can be found here: installation guide
  • The most important maven commands are described here: commands

You can also find all DSF Maven artifacts here.

Docker and docker-compose

To be able to test the implemented processes, we use a dev-setup based on Docker and docker-compose. This allows us to simulate multiple organizations with different roles and run the processes across "organizational boundaries".

Host entries for dev-setup

The following entries are required in the hosts file of your computer so that the FHIR servers of the simulated organizations can be accessed in your web browser. On Linux and Mac this file is located at /etc/hosts. On Windows you can find it at C:\Windows\System32\drivers\etc\hosts.

127.0.0.1	dic
127.0.0.1	cos
127.0.0.1	hrp
127.0.0.1   keycloak

Java IDE

For the development of the processes we recommend the use of an IDE, e.g. Eclipse or IntelliJ:

BPMN Editor

To simplify modeling of BPMN processes, we recommend a graphical editor, e.g. the Camunda Modeler:

  • An installation guide for the Camunda Modeler can be found here: installation guide
    • CAVE: When creating models with Camunda Modeler, make sure you create a Camunda 7 model, not a Camunda 8 model. The DSF relies on Camunda 7 which is incompatible with Camunda 8.

Hardware

The minimum hardware requirements to run all simulated organizations as part of the Docker dev-setup is 16 GB of RAM.


PrerequisitesExercise 1Exercise 1.1Exercise 2Exercise 4Exercise 5Exercise 6