[Deprecated] Gazelle HL7 Validator - Installation & Configuration

Warning: This documentation is out-dated, newest version of the documentation is available at https://gazelle.ihe.net/gazelle-documentation 

Sources & binaries

To get the name of the latest release, visit the Gazelle HL7 Validator project in JIRA and consult the "Change log" section.

A maven artifact is published in our Nexus repository each time we release the application. You can use it, but be aware that the link to the database is hardly expressed within the artifact so you will have to use the same database name, hosted in the server running Jboss, and with the same owner (and password).

To get the artifact on Nexus browse: http://gazelle.ihe.net/nexus/index.html#nexus-search;gav~~GazelleHL7v2Validator-ear~~~ and download the latest version.

If you rather want to build the project by yourself, you must checkout the latest tag and package it. You may want to create a new profile to customize your build.

1. Checkout the latest tag available on Inria’s forge: svn co https://scm.gforge.inria.fr/svn/gazelle/Maven/GazelleHL7v2Validator/tags/GazelleHL7v2Validator-$versionName

2. [Optional] Edit the pom.xml file and create a new profile

3. Package the application: mvn [-P profile] clean package

4. The EAR is available at GazelleHL7v2Validator/GazelleHL7v2Validator-ear/target/GazelleHL7v2Validator.ear

Database configuration

If you use the artifact available on Nexus or if you have not change this parameter in the pom.xml file, create a database named gazelle-hl7-validator, owned by the user gazelle.

$> createdb -U gazelle -E UTF8 gazelle-hl7-validator

 

Get xsd files

//TODO

Deploy the application

Copy EAR to the deploy folder of JBoss (do not forget to change its name to GazelleHL7v2Validator.ear)

Start Jboss ⇒ sudo service jboss start

Wait until the application has been completly deployed and configure the database running the SQL script for set-up.

Initialize the application

You first need to initialize the database with some data available in a SQL script. If you have checked out the project, the script is available in GazelleHL7v2Validator-ear/src/main/sql/import.sql

Otherwise, download it from Inria’s forge (See Sources section)

Before executing the script, open the file and checked the various preferences to be inserted in the app_configuration table, especially the cas_url, application_url and other preferences relative to the user authentication (see Application configuration section). Context path for deployment is /GazelleHL7Validator.

Finally, execute the script: 

$> >psql -U gazelle gazelle-hl7-validator < import.sql

To take those parameters into account, you need to restart either the whole Jboss ($>sudo service jboss restart), either only the application ($>touch GazelleHL7v2Validator.ear in the deploy folder of Jboss)

Application configuration

Use the Administration menu, you will find a sub-menu entitled "Configure application preferences". The following preferences must be updated according to the configuration of your system. The table below summarizes the variables used by the Gazelle HL7 Validator tool.

Variable

Description

Default value

application_issue_tracker_url

The URL of the bug tracking system where to post issues

http://gazelle.ihe.net/jira/browse/HLVAL

application_url

The URL used by any user to access the tool. The application needs it to build permanent links inside the tool

http://publicUrlOfJboss/GazelleHL7Validator

cas_url

If you intent to use a CAS, put its URL here

https://gazelle.ihe.net/cas

force_stylesheet

HL7MessageProfiles and HL7 resources are XML files displayed with a stylesheet declared in the file and referenced on gazelle.ihe.net. To avoid cross-site references, most browsers do not follow those links and as a consequence do not display the XML file correctly. This property tells the tool to change the link to the stylesheet before sending the file to the client

true

gmm_hl7messageprofile_wsdl

Access Hl7MessageProfile webservice exposed by GMM (or TM configured to work also as GMM)

http://gazelle.ihe.net/gazelle-gmm-gazelle-tm-ejb/Hl7MessageProfile?wsdl

gmm_iheconcepts_wsdl

Access IHEConcepts web service exposed by GMM (or TM configured to work also as GMM)

http://131.254.209.12:8080/gazelle-gmm-gazelle-tm-ejb/IHEConcepts?wsdl

 hl7_profiles_directory

 Directory where XML files are stored (used as a basis for updating the database, might be a folder sync with the forge)

$PathToDataProject$/ProfilesPerOid

hl7_profile_xsd

Location of the schema for verifying the structure of the XML message profiles.

path to HL7MessageProfileSchema.xsd

hl7_resource_xsd

Location of the schema for verifying the structure of the XML resources.

path to HL7TableSchema.xsd

hl7_table_directory

Directory where XML fies are stored (used as a basis for updating the database, might be a folder sync with forge)

$PathToDataProject$/TablesPerOid

length_is_an_error

how to behave when an error on length is encountered

false

NUMBER_OF_ITEMS_PER_PAGE

how many items are displayed in a datatable element byd efault

20

profile_xsl_url

used if force_stylesheet = true

link to the stylesheet (FDQN must be the same as for the application)

report_xsl_location

link to the stylesheet for displaying reports

http://gazelle.ihe.net/xsl/hl7Validation/resultStylesheet.xsl

resource_xsl_url

used if force_stylesheet = true

link to the stylesheet (FDQN must be the same as for the application)

svs_repository_url

URL to the Gazelle value set repository. Used to check codes in HL7v3 validation service

http://gazelle.ihe.net

time_zone

Used to display date/time in the appropriate time zone

Europe/Paris

value_is_an_error

how to behave when an error on data value is encountered

false

xsd_directory_location

where to find the XSD files for HL7v3 validation service

example : /home/gazelle/xsd/HL7V3/NE2008/multicacheschemas

xcpd_plq_xsd_location

where to find the XSD files for XCPD/PLQ validation service

example : /home/gazelle/xsd/IHE/XCPD_PLQ.xsd

Home page

The first time you access the application, you may notice that the home page of the tool is not configured. To set a title and a welcome message, log into the application with admin rights.

Note that you will have to set up this page for all the languages supported by the application.

Upload of the documentation of the model-based validation service (for HL7v3 messages)

see http://gazelle.ihe.net/content/configuration-documentation-mbv