Introduction

Sources & binaries

Gazelle Transformation Service is an open-source project under Apache License Version 2.0 (https://gazelle.ihe.net/content/license). Sources are available via git at https://gitlab.inria.fr/gazelle/public/processing/transformation.

Gazelle Transformation Service installation and configuration

Jboss 8 installation

It is necessary to have a jboss8 server. Make sure to read carefully the general considerations for JBoss8

Jboss 8 configuration

1. Create the directory ‘/usr/local/jboss8/modules/org/postgresql/main’

2. Add the following ‘module.xml’ file in ‘/usr/local/jboss8/modules/org/postgresql/main’ directory:

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="org.postgresql">
  <resources>
       <resource-root path="postgresql-42.2.1.jar"/>
   </resources>
   <dependencies>
       <module name="javax.api"/>
       <module name="javax.transaction.api"/>
   </dependencies>
</module>

1. Download the postgresql driver from: https://gazelle.ihe.net/jboss8/postgresql-42.2.1.jar

wget -nv -O /tmp/postgresql-9.4.1212.jar http://gazelle.ihe.net/jboss8/postgresql-9.4.1212.jar
sudo mv /tmp/postgresql-9.4.1212.jar /usr/local/jboss8/modules/org/postgresql/main

1. Edit /usr/local/jboss8/standalone/configuration/standalone.xml In , add the following in :

<drivers>
  <driver name="postgresql" module="org.postgresql">
    <driver-class>org.postgresql.Driver</driver-class>
  </driver>
</drivers>

Remove the following line:

<subsystem xmlns="urn:jboss:domain:weld:2.0"/>

Mojarra installation

1. Download the mojarra cli from: https://gazelle.ihe.net/jboss8/install-mojarra-2.1.19.cli

wget -nv -O /tmp/install-mojarra-2.1.19.cli https://gazelle.ihe.net/jboss8/install-mojarra-2.1.19.cli

1. Start the Jboss 8 server:

sudo /etc/init.d/jboss8 start

1. To install Mojarra, it is necessary to know the port of the management interface of the Jboss server. To determine the port, type the following command:

sudo grep "Http management interface listening on http" /usr/local/jboss8/standalone/log/server.log

And get the port (here: 10490):

2017-08-23 12:32:24,351 INFO  [org.jboss.as] (Controller Boot Thread) JBAS015961: Http management interface listening on http://127.0.0.1:10490/management

Now, set the port for controller argument and execute the following command:

sudo /usr/local/jboss8/bin/jboss-cli.sh --connect --controller=127.0.0.1:10490 --command="deploy install-mojarra-2.1.19.cli"

The CLI archive will install mojarra packages in :

/usr/local/jboss8/modules/com
/usr/local/jboss8/modules/javax
/usr/local/jboss8/modules/org

Database configuration

Create ‘transformation’ database

Type the following command to create the ‘transformation’ database:

createdb -U gazelle -E UTF8 transformation

Import the database schema and initiate the date

1. Download the sql scripts from the latest version of Gazelle Transformation Service (transformation-ear-X.X.X-sql.zip) : https://gazelle.ihe.net/nexus/#nexus-search;quick~transformation-ear

2. Unzip the file

3. Type this command to import the schema:

psql -U gazelle transformation < schema.sql

1. Type this command to initiate data:

psql -U gazelle transformation < init.sql

Daffodil environment configuration

The DFDL file which are referenced in the database are stored in the following directory on your environment in ‘/opt/DaffodilTransformation/dfdl/’.

Type the following commands:

mkdir -p /opt/DaffodilTransformation/dfdl/
sudo chown -R jboss:jboss-admin /opt/DaffodilTransformation/
sudo chmod -R 755 /opt/DaffodilTransformation/

CAS properties file

Gazelle Transformation’s CAS client is using a dedicated file in /opt/gazelle/cas which MUST be named “gazelle-transformation.properties”. The properties file content must contain the following parameters :

casServerUrlPrefix=https://{FQDN}/sso
casServerLoginUrl=https://{FQDN}/sso/login
casLogoutUrl=https://{FQDN}/sso/logout
service=https://{FQDN}/transformation

/!\ In the common file.properties, there is a serverName attribute which cannot be used at the same time with service, which explains why it is not used anymore in this gazelle-transformation.properties file.

Deploy the application

1. Download the .ear from the latest version of the tool (transformation-ear-X.X.X.ear): https://gazelle.ihe.net/nexus/#nexus-search;quick~transformation-ear

sudo wget -nv -O transformation-ear-X.X.X.ear https://gazelle.ihe.net/nexus/service/local/repositories/releases/content/net/ihe/gazelle/transformation-ear/X.X.X/transformation-ear-X.X.X.ear

1. WARNING : From version 2.1.0, datasources have been extracted from the ear. The template file can be found in /src/main/application/datasource in the sources or in the file transformation-X.X.X-datasource.zip from the nexus. For more informations about how to manage that externalization, please refer to general considerations for JBoss7.

Datasource name : transformationDS

Database name : transformation

1. Move the .ear to Jboss 8 server deployment folder:

sudo mv /tmp/transformation-ear-X.X.X.ear /usr/local/jboss8/standalone/deployments/transformation.ear

Wait until the application has been completely deployed:

sudo ls /usr/local/jboss8/standalone/deployments/

And make sure to have the .ear of deployed:

transformation.ear.deployed

Logs can be viewed here:

tail -f /var/log/jboss8/server.log

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 Transformation Service tool.

SSO Configuration

There are additional preferences to configure the SSO authentication.

For more documentation about SSO configurations, follow the link here.