installation.md

title:  Installation Manual
subtitle: Demographic Data Server
author: Maxime ARIF
date: 19/01/2022
toolversion: 4.3.x
function: Engineer
version: 1.02
status: Approved
reference: KER1-MAN-IHE-DEMOGRAPHIC_DATA_SERVER_INSTALLATION-1_02
customer: IHE-EUROPE

Sources and package

Demographic Data Server is a Maven project. Sources are available on the INRIA's Gitlab project at the following URL :

https://gitlab.inria.fr/gazelle/applications/test-design/DemographicDataServer.git

If you would like to checkout the sources on your system you might want to use the following git command, provided git is installed on your system.

git clone https://gitlab.inria.fr/gazelle/applications/test-design/DemographicDataServer.git

Note that the latest executable can be extracted from our nexus repository as well at : Nexus Repository Manager.

Important, if you download the ear from Nexus, it will have a name such as DemographicDataServer-ear-X.X.X.ear. Then be sure to rename it to DemographicDataServer.ear otherwise the deployment will fail.

Installation

This tool has to be deployed using a JBoss 7.2 application server and runs with a PostgreSQL database.

If you do not have yet a JBoss server installed in your environment, proceed as described in General consideration page.

Database creation

Your database must have a user named gazelle.

1. Download the SQL scripts archive from Nexus Repository Manager (search for DemographicDataServer-ear-X.X.X-sql.zip).
2. Unzip the archive into a folder DemographicDataServer-sql
3. Connect to your database :

psql -U gazelle

4. Execute the SQL statement to create the database.

CREATE DATABASE "demographic-data-server" OWNER gazelle ENCODING UTF8 ;

5. Initialize database by running :

psql -U gazelle demographic-data-server < DemographicDataServer-sql/init-x.x.x.sql

Deployment