Gazelle Transformation Service is an open-source project under Apache License Version 2.0 (https://gazelle.ihe.net/content/license). Sources are available via Subversion at https://svn.ihe-europe.net/gazelle/Maven/gazelle-transformation/.
It is necessary to have a jboss8 server. Make sure to read carefully the general considerations for JBoss8
Create the directory ‘/usr/local/jboss8/modules/org/postgresql/main’
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>
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
<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"/>
wget -nv -O /tmp/install-mojarra-2.1.19.cli https://gazelle.ihe.net/jboss8/install-mojarra-2.1.19.cli
sudo /etc/init.d/jboss8 start
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
Type the following command to create the ‘transformation’ database:
createdb -U gazelle -E UTF8 transformation
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
Unzip the file
Type this command to import the schema:
psql -U gazelle transformation < schema.sql
psql -U gazelle transformation < init.sql
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/
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.
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
Datasource name : transformationDS
Database name : transformation
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
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.
| variable | description | default value |
|---|---|---|
| application_admin_email | Email of the administrator of the tool | technical.manager@ihe-europe.net |
| application_admin_name | Administrator’s name | Eric Poiseau |
| application_admin_title | Administrator’s function | Application Administrator |
| application_name | Name of the application to display on the home page | Gazelle Transformation |
| application_release_notes_url | URL to the release note of the tool | https://gazelle.ihe.net/jira/projects/TRANSFOSRV?selectedItem=com.atlassian.jira.jira-projects-plugin:release-page&status=released |
| application_url | Complete URL of the tool | http://localhost:8580/transformation |
| application_url_basename | URL first resource to reach the tool | /transformation |
| application_works_without_cas | Enable/disable CAS login | true |
| bin_path | File system path used by Gazelle Transformation | /opt/DaffodilTransformation/dfdl |
| cas_url | URL of the Central Authentication Service | https://gazelle.ihe.net/cas |
| documentation_url | URL of the documentation | https://gazelle.ihe.net/gazelle-documentation/Gazelle-Transformation-Service/user.html |
| ip_login | Enable/disable IP filtering for admin login (works only if CAS login disabled) | false |
| ip_login_admin | Regular expresion for filtering IPs | .* |
| NUMBER_OF_ITEMS_PER_PAGE | Number of rows displayed by table pagination | 20 |
| time_zone | Time Zone for display | Europe/Paris |