This page describes the prerequisite to the installation of Gazelle applications. All the tools developed in the context of the Gazelle testbed project are developed for WildFly and JBoss (5.0.1-GA, 7.2.0.final, 8.0.0.Final, 10.0.0.Final, 18.0.1.Final) and use a postgreSQL database.

We recommand to install the Gazelle tools in a Debian-like environment, it’s the environment running on IHE Europe servers so we know that it is correctly working. Moreover, most of the installation and configuration procedures are described for such an environment.


We are currenlty using PostgreSQL 9.6 on most of our servers.

Install a JVM

Our applications running on Wildfly18 are using java 11. Consider installing openJDK.

sudo apt-get update && sudo apt-get install openjdk-11-jre

Install Wildfly 18 application server

Get package and init script

Wildfly package can be downloaded from: https://gazelle.ihe.net/wildfly18/wildfly-18.0.1.Final.zip

wget -nv -O /tmp/wildfly-18.0.1.Final.zip https://gazelle.ihe.net/wildfly18/wildfly-18.0.1.Final.zip

init.d script can be downloaded from: https://gazelle.ihe.net/wildfly18/init.d-wildfly18

wget -nv -O /tmp/init.d-wildfly18 https://gazelle.ihe.net/wildfly18/init.d-wildfly18

Install jboss in the /usr/local folder

cd /usr/local
sudo mv /tmp/wildfly-18.0.1.Final.zip .
sudo unzip ./wildfly-18.0.1.Final.zip
sudo ln -s wildfly-18.0.1.Final wildfly18
sudo rm -rf wildfly-18.0.1.Final.zip
sudo chown -R jboss:jboss-admin /usr/local/wildfly-18.0.1.Final
sudo chmod -R 755 /usr/local/wildfly-18.0.1.Final
sudo mkdir /var/log/wildfly18/
sudo chown -R jboss:jboss-admin /var/log/wildfly18/
sudo chmod -R g+w /var/log/wildfly18/

Install the init script and make it start at system startup

sudo mv /tmp/init.d-wildfly18 /etc/init.d/wildfly18
sudo chmod +x /etc/init.d/wildfly18
sudo chown root:root /etc/init.d/wildfly18
sudo update-rc.d wildfly18 defaults

Once the init.d script is setup, Wildfly server can be started, restarted, stopped or queried about its status using the commands:

sudo sudo systemctl start|restart|stop|status wildfly18.service

Install or update PostgreSQL JDBC driver

  1. Stop jboss and go to
    sudo mkdir -p /usr/local/wildfly18/modules/org/postgresql/main
    cd /usr/local/wildfly18/modules/org/postgresql/main
  2. Download driver
    sudo wget https://gazelle.ihe.net/wildfly18/postgresql-42.2.9.jar
    sudo chown jboss:jboss-admin postgresql-42.2.9.jar
    sudo chmod 775 postgresql-42.2.9.jar
  3. Edit module.xml and update the version
     <module xmlns="urn:jboss:module:1.1" name="org.postgresql">
              <resource-root path="postgresql-42.2.9.jar"/>
              <module name="javax.api"/>
              <module name="javax.transaction.api"/>
  4. Add the driver to the standalone.xml file
             <driver name="postgresql" module="org.postgresql">
  5. Clean up your jboss
    sudo rm -rf /usr/local/wildfly18/standalone/tmp/
    sudo rm -rf /usr/local/wildfly18/standalone/data/
  6. Restart Wildfly server and deploy your artifact

Setup datasources for Gazelle applications

Most of Gazelle projects have extracted datasources. In order to deploy those projects, you will need to include some special instructions in your wildfly server configuration file :

Stop Wildfly and edit standalone.xml in /usr/local/YOUR_JBOSS_SERVER/standalone/configuration folder and update datasources :

        <datasource pool-name="YOUR_TOOL_DATASOURCES" jndi-name="java:jboss/datasources/YOUR_TOOL_DATASOURCES"
                enabled="true" use-java-context="true">
                <check-valid-connection-sql>select 1</check-valid-connection-sql>

NOTE : YOUR_TOOL_DATASOURCES can be found in TOOL-ds.xml file (/src/main/application/META-INF of your ear folder) or in the application user manual.

Finally, restart your Wildfly to take into account your config.