Tutorial Build FHIR Server On Windows

tags: fhir-project fhirserver

This tutorial is designed for FHIR developer wishing to build a FHIR Server in a Windows OS. In this tutorial, we will try to build the server in a localhost mode instead of public server.

Table of Contents

• Tutorial Build FHIR Server On Windows
  • Table of Contents
  • Prerequisite
  • Build HAPI FHIR Server Step
    • A. Install Postgresql and Create Database
    • B. Download Java Development Kit (JDK)
    • C. Install Apache Tomcat
    • D. Download HAPI-FHIR Starter source code
    • E. Install Spring tool suit 4 (STS 4)
    • F. Debug hapi-fhir-starter-project in STS 4
    • G. Deploy a WAR File to Tomcat web service

Prerequisite

Basic Knowledge:

• Java language

Software Installation:

Type	Usage	Software Name	Version used in this tutorial
Database	Store FHIR Resouces data	Postgresql	12.10
FHIR starter source code	Deploy a FHIR server using HAPI FHIR JPA	hapi-fhir-jpaserver-starter	helm-v0.8.0 (always strive for the latest-updated version)
Java Development Kit (JDK)	HAPI FHIR works on Java environment, so it'll requires a JDK in order to run	Oracle Java (JDK)	15.0.2
Web Server	Provide Java web server environment for the FHIR Server	Apache Tomcat	9.0
JAVA IDE	For developing Spring-based enterprise applications	Spring tool suit 4(STS 4)	4.14.1

Build HAPI FHIR Server Step

We executed this tutorial on a Windows 10 x64-bit laptop

A. Install Postgresql and Create Database

Time: 5-10 mins

1. Install
   

   • version: 12.10
   • url: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

2. Create a new Role
   2.1 Open PgAdmin 4
   

   
   2.2 Right click on the [Login/Group Roles] -> Click [Create] -> Click [Login/Group Role]
   

   2.3 Input role name
   

   2.4 Input password
   

   2.5 Enable [Can Login?] setting -> Click [Save]
   

3. Create a new Database
   3.1 Right click on the [Databases] -> Click [Create] -> Click [Database]
   

   
   3.2 Input database name -> Select the role created in step 2 -> Click [Save]
   

B. Download Java Development Kit (JDK)

• version: 15.0.2
• url: https://www.oracle.com/java/technologies/javase/jdk15-archive-downloads.html

C. Install Apache Tomcat

• version: 9.0
• url: https://tomcat.apache.org/download-90.cgi

D. Download HAPI-FHIR Starter source code

• version: helm-v0.8.0
• url: https://github.com/hapifhir/hapi-fhir-jpaserver-starter.git

E. Install Spring tool suit 4 (STS 4)

• version: 4.14.1
• url: spring.io/tools

F. Debug hapi-fhir-starter-project in STS 4

1. Setting JDK
2. Setting Apache Tomcat
3. Import HAPI FHIR starter
   3.1 Edit PostgreSQL
   3.2 Edit server address
4. Debug

G. Deploy a WAR File to Tomcat web service