From dd73b9b588d7b7411e78bf9f25fed1ceba82958f Mon Sep 17 00:00:00 2001 From: Maf <maf@kereval.com> Date: Thu, 14 Mar 2019 10:38:13 +0100 Subject: [PATCH] adding release note 2.2.0 & update installation documentation --- HPD-Simulator/installation.md | 36 +++++++++++++ HPD-Simulator/release-notes/2_2_0.md | 77 ++++++++++++++++++++++++++++ 2 files changed, 113 insertions(+) create mode 100644 HPD-Simulator/release-notes/2_2_0.md diff --git a/HPD-Simulator/installation.md b/HPD-Simulator/installation.md index 7608f67..b70ced2 100755 --- a/HPD-Simulator/installation.md +++ b/HPD-Simulator/installation.md @@ -134,6 +134,42 @@ The HPD Simulator tool is a Maven 3 project, sources are available on Inria’s This application runs under JBoss 7.2.0-GA and uses a postgreSQL 9 database. + +## Database creation + +Your database must have a user **gazelle** + +1. Connect to your database +```bash +psql -U gazelle +``` + +1. Execute the SQL statement to create the database. +```sql +CREATE DATABASE "hpd-simulator" OWNER gazelle ENCODING 'UTF8' ; +``` + +## Deployment + +To deploy HPDSimulator : + +1. Download the ear from our Nexus repository [https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~HPDSimulator-ear](https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~HPDSimulator-ear) (search for **HPDSimulator-X.X.X.ear**) + +1. Paste the archive **HPDSimulator.ear** in the JBoss deployment directory `${JBOSS7_HOME}/standalone/deployments/` + +1. Display JBoss server logs, start JBoss and wait for **ear** deployment. + +1. The application can be browsed at [http://localhost:8080/HPDSimulator](http://localhost:8080/HPDSimulator) +_Port could also be different whether you have modified the JBoss configuration._ + +1. **WARNING** : From version 2.2.0, datasources have been extracted from the **ear**. The template file can be found in /src/main/application/datasource in the source or in the file HPDSimulator-X.X.X-sql.zip from the nexus. +For more informations about how to manage that externalization, please refer to [general considerations for JBoss7](https://gazelle.ihe.net/gazelle-documentation/General/jboss7.html). + +Datasource name : HPDSimulatorDS + +Database name : hpd-simulator + + ## Components HPD Simulator integrates the three actors defined by the Healthcare Provider Directory integration profile of IHE: diff --git a/HPD-Simulator/release-notes/2_2_0.md b/HPD-Simulator/release-notes/2_2_0.md new file mode 100644 index 0000000..a6c8c81 --- /dev/null +++ b/HPD-Simulator/release-notes/2_2_0.md @@ -0,0 +1,77 @@ +--- +title: Release note +subtitle: HPDSimulator - 2.2.0 +toolversion: 2.2.0 +releasedate: 2019-03-14 +author: Maxime ARIF +function: Software Engineer +customer: IHE-EUROPE +reference: KER3-RNO-IHE-HPD_SIMULATOR_2_2_0 +--- + +# All changes + +## Improvement +* \[[HPD-192](https://gazelle.ihe.net/jira/browse/HPD-192)\] Extract datasource configuration +* \[[HPD-193](https://gazelle.ihe.net/jira/browse/HPD-193)\] Update SQL scripts archive + +# Dependencies + +``` +[INFO] Scanning for projects... +[INFO] ------------------------------------------------------------------------ +[INFO] Reactor Build Order: +[INFO] +[INFO] HPDSimulator +[INFO] HPDSimulator - EJB - JAR +[INFO] HPDSimulator - WAR +[INFO] HPDSimulator - EAR +[INFO] +[INFO] ------------------------------------------------------------------------ +[INFO] Building HPDSimulator 2.1.3-SNAPSHOT +[INFO] ------------------------------------------------------------------------ +[INFO] +[INFO] --- gazelle-plugins:1.60:check-dependencies (default-cli) @ HPDSimulator --- +Check dependencies :: All the dependencies are up to date. +[INFO] +[INFO] ------------------------------------------------------------------------ +[INFO] Building HPDSimulator - EJB - JAR 2.1.3-SNAPSHOT +[INFO] ------------------------------------------------------------------------ +[INFO] +[INFO] --- gazelle-plugins:1.60:check-dependencies (default-cli) @ HPDSimulator-ejb --- + net.ihe.gazelle.maven version ejb 1.0.3 2.0.0 yes +[INFO] +[INFO] ------------------------------------------------------------------------ +[INFO] Building HPDSimulator - WAR 2.1.3-SNAPSHOT +[INFO] ------------------------------------------------------------------------ +[INFO] +[INFO] --- gazelle-plugins:1.60:check-dependencies (default-cli) @ HPDSimulator-war --- +Check dependencies :: All the dependencies are up to date. +[INFO] +[INFO] ------------------------------------------------------------------------ +[INFO] Building HPDSimulator - EAR 2.1.3-SNAPSHOT +[INFO] ------------------------------------------------------------------------ +[INFO] +[INFO] --- gazelle-plugins:1.60:check-dependencies (default-cli) @ HPDSimulator-ear --- +Check dependencies :: All the dependencies are up to date. +[INFO] ------------------------------------------------------------------------ +[INFO] Reactor Summary: +[INFO] +[INFO] HPDSimulator ....................................... SUCCESS [ 14.585 s] +[INFO] HPDSimulator - EJB - JAR ........................... SUCCESS [ 3.442 s] +[INFO] HPDSimulator - WAR ................................. SUCCESS [ 1.829 s] +[INFO] HPDSimulator - EAR ................................. SUCCESS [ 2.051 s] +[INFO] ------------------------------------------------------------------------ +[INFO] BUILD SUCCESS +[INFO] ------------------------------------------------------------------------ +[INFO] Total time: 29.343 s +[INFO] Finished at: 2019-03-13T16:06:46+01:00 +[INFO] Final Memory: 45M/719M +[INFO] ------------------------------------------------------------------------ +``` + +net.ihe.gazelle.maven:version:2.0.0 is not be used only with Jboss8 AS and thus is not used in this version of HPDSimulator which still runs under Jboss7 AS. + +# Remarks + +This version of the HPDSimulator tool uses the jdbc driver provided by the Jboss7 AS server. \ No newline at end of file -- GitLab